研究项目立项 SOP(华哥「新增加调研项目」标准路径)
v1.2.4(2026-11-07)视频监控项目立项实证:错峰选档改为「按当前 enabled 档位找 ≥30min 空隙,paused 高峰档视为半占用」(10:20 档实测可用)+ jobs.json 主键实为
id非job_id(错 key 静默空输出 exit 0)。v1.1.0(2026-10-07)实证重写:单日连续立项 7 个项目(行业知识文章/行业论文/行业专利/目标市场开拓/水产技术学习/环保和谐共存/RAS设备出海)+ GLM 额度超限日亲自执行首轮 + 「滚动 3 轮」21 轮全部完成。
v1.2.3(2026-10-21)三明治架构项目第三次实证:详见
references/***SECRET***.md——种子池编号必须 ls 实取 max+1(84→85)、cron 错峰同避 10:40/11:10 姊妹档取 11:40、cron prompt 引用自身 job_id 以 create 返回值为准且创建后 list 复核(实测 bbeb/beb 笔误)、skill_view 对共享根技能裸名报 not found 时不重建副本(改 write_file 加 references/ + 可解析技能携带交叉引用)。
1. 触发条件
- 华哥消息含「新增加调研项目 / 新增调研项目」→ 立项全流程(§2)
- 华哥立项后在后续消息追加需求/功能维度(「可以再加…」「或者增加一个…」「后期可以延伸到…」)→ 并入总纲不重新立项(Pitfall 7):更新 README 产品核心假设 + 方向骨架 + 原始指令存档追加第二轮原话;方向数量变化时同步 update cron prompt 里的方向编号
- 华哥消息含「以上项目持续滚动调研 N 轮」→ 批量执行模式(§6)
- 学习助手额度超限 → 降级执行模式(§5)
- 华哥消息含「停止调研 / 已进入开发状态 / 停调研」→ 结项流程(§7)
2. 标准流程(单项目约 10 分钟,6 步)
v1.2.1(2026-10-15):补 Step 5 汇报规范实证(双产出定位范式、轮数默认值申报、「不做」清单)。「研-如何配置合适的电脑」立项实证。
Step 0 · 查重与边界扫描(必做)
cronjob list:已有覆盖的不新建(华哥 8-22 省 token 铁律)ls 01-开发中/:扫兄弟项目 → 总纲显式写「与兄弟项目的边界」+「联动纪律」。措辞范式:「79 号=产品本地化数据地基;本项目=市场作战档案」「那边按市场逐国建档(需求侧),这边按设备品类横切(供给侧)」;同数字引用注明出处,不重复造数- 先判断新项目归哪条线(2026-11-05 华哥定案的组织架构,详见
references/***SECRET***.md):养殖项目+仿真引擎 → 渔芯科技大项(迁另一台机,本机不再开发);社区官方应用 →渔芯社区/官方应用/<应用名>/;调研/立项 →渔芯独角兽/01-开发中/研-*。归错线=白立项
Step 1 · 项目目录 + 总纲 README
路径 6-产品研发/渔芯独角兽/01-开发中/研-{项目名}/:
README.md # 总纲(cron 自驱动的唯一依据,最重要)
02-华哥原始指令.md # 华哥原话逐字存档 + 落地说明
01-研究报告/ # 轮换报告 NN-{方向名}.md
02-xxx/ # 按形态:文章成稿/论文孵化/交底书草稿(保密)/政策雷达/学习大纲+笔记
00-市场队列.md # 仅队列驱动型
总纲 README 必含 5 件(缺一 cron 断驱):
- 一句话定位
- 与兄弟项目的边界 + 联动纪律
- 方向骨架:编号方向表(10±2 个),可分 A/B/C 层
- 目录说明
- 进度登记表:表头固定
| 日期 | 方向 | 产物 | 关键结论一句 |——cron 每轮读它定方向、写完追加一行。登记表 = 单一事实来源
豆包/AI 初稿存档(华哥工作流:外部 AI 出初稿→玉芬综合整理):华哥转来的豆包/外部 AI 初稿存入项目目录(如 03-外部初稿/),显式标注「外部 AI 初稿,未经交叉核查」;采用其内容前必须绑定公司实际数据交叉核查,不盲信。
Step 2 · 轮换 cron
- profile=zhenglishi,model=GLM-5.3-flash/glm,deliver=local,enabled_toolsets=["web","terminal","file","search"]
- cron 的 model 必须显式传 provider:
model={"model": "GLM-5.3-flash", "provider": "glm"},别只传{"model": "..."}(省略 provider 会钉成 default 会话当前主 provider,额度切换日会错配成 DeepSeek,见 Pitfall 6) - 错峰调度:多 cron 分钟数错开(实证 :00/:10/:20/:30/:40/:50 × 9/15/21 时)。v1.2.4 细化(视频监控项目实证):选档时只扫 cronjob list 里 enabled=true 的 zhenglishi 档位,取与相邻 enabled 档间隔 ≥30min 的空隙(如 10:20,避开 09:30/11:00 两个 enabled 档);paused 高峰档(如 10:40 有两个 paused 任务、11:10 轨道机器人)视为「半占用」——额度恢复潮可能 resume 撞档,能避开优先避开。判断依据以 enabled 实况为准,不凭 prompt_preview 措辞。
- cron prompt 六要素:①身份+项目一句话 ②第一步读总纲 README 进度登记表(自驱动,不写死方向)③本轮任务+报告路径与命名 ④报告必含结构(现状盘点≥3 源交叉/渔芯可执行结论/遗留项移交下轮)⑤数据铁律(官方一手优先/≥2 源交叉/标数据年份/查不到写「暂未查到」不凑数)⑥收尾更新登记表 + 「不动兄弟项目、不动 cron 配置」
- 特殊纪律双写:项目总纲写一次、cron prompt 再写一次(专利交底书保密、论文「涉专利点暂缓成文」等)
Step 3 · 原始指令存档(原话逐字 + 落地说明)
Step 4 · Mnemosyne 登记(remember 项目全貌 + task_progress 状态)
实证调用形状(2026-11-07):mnemosyne_remember(content=项目全貌一段, importance=0.85, source="task", veracity="stated", metadata={"type":"立项","cron_id":...}) + mnemosyne_task_progress(action="set", task=项目短代号(如 yan-video-monitor-bootstrap), state=当前状态一句, metadata={cron_id/schedule})。两件都做,缺一后续 session 定位项目困难。
Step 5 · 汇报华哥:表格化(项目/产出/频率)+ 落地清单 + 联动设计 + 首轮起跑时间;授权模式下直接定案不追问
汇报三件实证(2026-10-15「配置合适电脑」项目过审零追问):
- 双产出定位范式:立项汇报给产出定「对内+对外」双身份(例:对内=渔芯自用采购指南回应真实痛点,对外=方法论内容资产),并标注重点候选方向及锚定场景——华哥据此快速判断项目价值。
- 未指定轮数=默认申报不追问:华哥没说轮数时,总纲写成「N 方向各一轮后回卷深化」,汇报尾注「默认设定可随时改」一句即可,不作为问题抛回(授权模式:小默认自己拿主意)。
- 敏感产出预设闸门:产出含采购/预算/签约类建议时,总纲和汇报都写明「产出对比表等华哥拍板,不擅自定采购」(对应华哥硬约束:大额采购需拍板)。
3. 三种 cron 形态
| 形态 | 适用 | 机制 |
|---|---|---|
| 方向轮换型(默认) | 有 N 个方向 | 每轮读登记表 → 顺序推进下一方向,N 轮后回卷挑薄弱深化 |
| 市场队列驱动型 | 「指定市场类」持续扩展 | 00-市场队列.md:华哥指定→入队→每市场 M 维建档(状态/进度 N/M)→档案完成转持续追踪(增量扫描写入追踪日志);华哥一句话入队即生效 |
| 单文件综合报告型 | 「持续更新的综合报告」 | 主报告单文件多模块(M1-M7),cron 每轮扫增量→直接编辑对应模块→更新日志追加行;模块内嵌「下轮更新计划」滚动改写 |
| 需求/问题侧(问题库型) | 「检索内容/真实问题/需求」类 | 产出=真实问题库(结构化问题条目),不是答案/内容。质量红线从「数据铁律」切换为「真实来源铁律」:每条问题必须有可追溯出处,禁止编造。详见 references/***SECRET***.md |
4. 不需要做的事
🔄 2026-10-20 修正:本节「不用改 39bd34537174」仅对登记表进度成立(动态读 README 自动纳报);但该 cron prompt 的数据源列表是静态枚举,新项目目录必须一次性人工加进列表+重点项目高亮行,否则日报漏项目(10-20「研-工作台知识库系统」实测后已补注册)。v1.1 三条规则(轮换选档最小⬜编号 / cron 先查 10:00-10:30 族密区取 10:40 / 假设状态句)+ 实战四条入库规则已落地,详见
references/v1.1-to-v1.2-bootstrap-patch-2026-10-20.md。🔄 2026-10-21 三明治项目实证补刀:10-21 立项会话汇报华哥时误称「日报自动纳入无需登记」(凭 prompt_preview 的「数据源(全部只读)+目录扫描」措辞误判)——按本节 v1.2 修正铁律,新项目仍须 cronjob update 39bd34537174 把目录加进数据源列表,该注册动作在 10-21 会话中未完成,需下一会话补做。判断口径以本节为准,不以 prompt_preview 措辞为准。同日新增两条:① cron prompt 引用自身 job_id 以 create 返回值为准,创建后 list 复核防笔误(实测 bbeb/beb 前缀笔误已 update 修正);② cron 错峰时同时避开 10:40 与 11:10 姊妹档,11:40 档实测可用(详见
references/***SECRET***.md)。
- 不用改「📊 研项目每日进度汇总(华哥)」cron(39bd34537174,21:30):动态读各 研- 项目 README 登记表,新项目自动纳入
- 不用为每个项目建 heartbeat;不抄兄弟项目结论进总纲(引用路径+出处即可)
5. GLM 额度超限降级执行
信号:cron 大量 last_status=error / 华哥告知套餐超了 → 华哥说「今天的调研工作你亲自执行」时直接自己跑:web_search 采数据(每主题 2-3 query)→ 写报告 → 更新登记表,注明「玉芬亲自执行(GLM 额度受限日)」+「cron 自下轮按方向 N 续推」→ 恢复后无缝续推不重不漏。付费墙数字(GVR 精确规模等)宁缺毋滥维持定性口径。
6. 「滚动 N 轮」批量执行模式
「以上项目持续滚动调研 N 轮」→ 全部项目 × N 轮:
- 每项目按登记表顺序推进 N 个方向/单元,每轮产出真实文件(报告 1.5-3KB 简明体量)
- ⚠️ delegate_task 600s 上限实证(2026-10-07):多项目打包给子代理(每轮 5-10 次 web_search+write)2/2 超时且未写盘产物丢失 → 批量轮次直接自己顺序执行;确需子代理时收窄到单项目、限产物数量
- 完成后统一 patch 各 README 登记表 + find 统计产物数核验 + 表格化汇报
7. 停调研转开发(结项)SOP
触发:华哥说「已经进入开发状态的项目的停止调研任务」/「停止调研」/「只停调研、开发/积累继续」。
Step 1 · 判断「已进入开发状态」的项目(依据优先级,2026-10-12 实证)
01-开发中/项目开发就绪度评估-20261005.md:T1「立即启动开发」/ T2「待华哥拍板」/ T3「继续采集」三级(这是华哥拍板的权威分级)- 各项目
项目开发启动书_*.md/开发评估.md(T1 项目才产出) - 开发产物目录:
03-开发/、04-平台开发/、06-大脑架构/(说明已动工) → 定位其轮换调研 cron:cronjob list找「{项目简称}-轮换调研」类 name(profile=zhenglishi)
Step 2 · 分两类操作(关键区分)
- 纯调研 cron(prompt 只做轮换调研)→
cronjob action=pause。可逆,不 remove——华哥说「停止」= pause 即可,彻底删要等他明说。 - 开发/积累型 cron(prompt 已含「开发优先」或「资料积累」步骤)→ 不能简单 pause,要
cronjob action=update改 prompt 去掉调研步骤、保留开发/积累,再action=resume。华哥说「只停调研、开发/积累继续」就是这个意思——例:AI智能大脑 cron 从「开发优先+穿插调研」删掉穿插调研;网安平台 cron 从「资料积累+轮换调研报告」删掉轮换报告。
Step 3 · 汇报边界:表格化(项目 / cron id / 原频率 / 判断依据);把「T2 待拍板」项目和「属性特殊」的 cron(已转开发优先/已降月度单扫)单独列出请华哥确认,不擅自扩大范围到 T2。
Pitfall · jobs.json 中文字段是 unicode 转义:~/.hermes/cron/jobs.json 的 name/prompt 是 \uXXXX ASCII 转义存储,search_files/grep 搜中文(如「调研」)搜不到。查 cron 中文名用 cronjob list(工具会解码),或搜转义码(「研」=u7814);终端批量统计 state/last_status/profile/429 分布直接 python3 -c "import json,collections; ..." 解析 jobs.json 最省事。取某 job 的完整 prompt 做 update 前,注意 jobs.json 里主键是 id 不是 job_id(cronjob list 显示的 job_id 字段落盘后叫 id):j.get('job_id') 会静默返回 None、循环空输出且 exit 0,不报错——取 prompt 用 j.get('id')=='<job_id>' 匹配(2026-11-07 实证)。
8. Pitfalls
- profile 会话 skill_view 404 共享根 skill:available_skills 列出但 skill_view not found(文件在
/Users/hua/.hermes/skills/共享根,profile 只解析自己目录)→ 不要干等,用 skill_manage create/edit 直达共享根文件操作;按共享正本铁律不另存 profile 副本 - cron prompt 写死方向:与登记表漂移;永远「先读登记表再定方向」
- 登记表结论列太长:一句(≤40 字)+关键数字,细节在报告文件
- 跨项目时序纪律:可专利技术方案先专利后论文/文章公开——内容类项目总纲互相引用;发现可专利化空白时报告只写「已转交专利项目评估」不展开细节
- 登记表行数即进度:滚动轮完成后务必 patch 登记表,否则 cron 下轮会重复已做方向
- cron model 参数省 provider 会 pin 错 provider(2026-10-11 实证):
cronjob create的model若只传{"model": "GLM-5.3-flash"}不传 provider,工具会把 provider 钉成当前 default 会话的主 provider,而非目标 profile(zhenglishi)的默认 provider——当 default 因额度切换到 DeepSeek 时生成「GLM-5.3-flash + deepseek-cn」错配组合,首跑即报错。修正:显式传{"model": "GLM-5.3-flash", "provider": "glm"}(与存量研究 cron 一致);建完用cronjob list核 job 的 provider 字段应为glm。 - 华哥立项后追加需求 → 方向骨架扩张 → cron prompt 硬编码的「方向 N 输出产品方案」编号失效(2026-11-05 钓鱼 App 实证:10 方向扩到 14):cron prompt 若写了「方向 10 是产品方案输出」这类具体编号,扩方向后该编号失效,须
cronjob update改 prompt。更稳写法:cron prompt 用「最后一个方向(产品方案输出)」泛化引用,不写死数字,避免每次扩方向都改 cron。同步纪律:原始指令存档「立项要点」里的「方向骨架 N 方向(A·竞品 x + B·产品 y + C·商业 z)」数字也要一起改,否则存档与 README 漂移。功能菜单过宽时(华哥一句话点 5+ 类功能),在总纲标一句「MVP 分期待答」,方案方向要求明确回答「MVP 先做哪几个、直播/测评等哪些放二期」。
9. References
references/***SECRET***.md— 渔芯产品研发顶层组织架构与项目归属(科技大项=养殖+仿真引擎迁另一台机/社区官方应用=本机/独角兽研发;场景设计助手↔专利↔论文同主线)+ 盘点/归属问答方法论references/2026-10-07-batch7-立项与滚动实证.md— 7 项目立项参数总表(cron ID/节奏/形态)、21 轮滚动成果、遗留项(国知局正式检索/印度关税官方核实/AE 版面费)