docs(27-P3C): 与并行的 agent 目录重构对账 —— 纠正一条写反的约束

另一条工作线正在做 agent 目录结构重构（system/templates 并入 system/agents），约 900 个变更尚未提交。逐条核实交集：好消息 —— 本文档引用的全部函数/常量（settleRun / markRunReady / stopRun / defaultPlanWorkGraph / PLAN_MAX_ROUNDS / writeTaskGoalArtifact / reportRunOutcome / ACTIVE_ROOT_RUN_STATUS / saveTaskMeta / getAggregatedTasks）在 650 行改动后全部存活，五条行为性结论逐条复验仍成立，work-graph-db.js 完全没被碰（第二轮复核最关键的那批发现不受影响）。27-P3/P4 那条「只写函数名不写行号」的体例在这里直接兑现了价值。坏消息 —— §四.9 有一条写反了，已纠正并留档： - system/templates/ 彻底取消，本体落 system/agents/task-planning/ - _registry.json 不再是数据源头（seedAgents 直接 readdirSync 扫目录当真相，registry 只按 id 补 benchmark_score），所以「不登记会把 CI 跑红」不成立 —— 建目录才是关键动作，登记是可选的 - 真正的闸门是新增的「毕业」判据：agent.md + soul.md 非空且不带 _base 骨架哨兵，否则 status 停在 draft、hire() 返回 body_not_ready。「先建骨架后填」的中间态雇不进公司 - 本体正文路径三条硬规矩（cwd 深度 3）：自身文件 ../../、仓库根 ../../../../../、交付物必须用 $W 绝对路径。写错全都不报错、只静默降级 —— 静默故障家族的最新成员排期影响：批 1 照常（work-graph-db.js 无人触碰）；批 2 的 task-planning 本体等重构落地后再建，否则要按旧形态做一遍再改；批 5 开工前重新核 agent-chat.js（+455 行）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

docs(27-P3C): 与并行的 agent 目录重构对账 —— 纠正一条写反的约束
另一条工作线正在做 agent 目录结构重构（system/templates 并入 system/agents），约 900 个变更尚未提交。逐条核实交集：好消息 —— 本文档引用的全部函数/常量（settleRun / markRunReady / stopRun / defaultPlanWorkGraph / PLAN_MAX_ROUNDS / writeTaskGoalArtifact / reportRunOutcome / ACTIVE_ROOT_RUN_STATUS / saveTaskMeta / getAggregatedTasks）在 650 行改动后全部存活，五条行为性结论逐条复验仍成立，work-graph-db.js 完全没被碰（第二轮复核最关键的那批发现不受影响）。27-P3/P4 那条「只写函数名不写行号」的体例在这里直接兑现了价值。坏消息 —— §四.9 有一条写反了，已纠正并留档： - system/templates/ 彻底取消，本体落 system/agents/task-planning/ - _registry.json 不再是数据源头（seedAgents 直接 readdirSync 扫目录当真相，registry 只按 id 补 benchmark_score），所以「不登记会把 CI 跑红」不成立 —— 建目录才是关键动作，登记是可选的 - 真正的闸门是新增的「毕业」判据：agent.md + soul.md 非空且不带 _base 骨架哨兵，否则 status 停在 draft、hire() 返回 body_not_ready。「先建骨架后填」的中间态雇不进公司 - 本体正文路径三条硬规矩（cwd 深度 3）：自身文件 ../../、仓库根 ../../../../../、交付物必须用 $W 绝对路径。写错全都不报错、只静默降级 —— 静默故障家族的最新成员排期影响：批 1 照常（work-graph-db.js 无人触碰）；批 2 的 task-planning 本体等重构落地后再建，否则要按旧形态做一遍再改；批 5 开工前重新核 agent-chat.js（+455 行）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
yibo
1 parent b2a0c1d8
Showing 1 changed file with 27 additions and 2 deletions
docs/todo/system-design/27-p3c-goal-task-model.md
@@ -311,7 +311,18 @@ AgentManager 靚 task-planning嚗嚗oal.description +  org graph 
  
 1. **token 霈啗揭**嚗 `defaultPlanWorkGraph` 銝 `onAcpEvent` 蝝臬 `usage`  `goals.planning_tokens`嚗批.1嚗 goal 撅銝銝蝚韐對扇撠望耦
 2. **憭梯揖敹◆漣嚗 goal  `planning`**嚗3 頧桅瘝∩漣 DAG  ** 1 膩 task**嚗created_by='human'`seq=1`depends_on=[]`嚗oal 頧 `active`嚗僎釣仃韐伐歇遙銝噢銝芣偶餈蓮 `planning` goal  甇餈活閬蝐駁
-3. **`_registry.json` 敹◆霈**嚗撱箸雿敶霈堆server/tests/unit/template-refs.test.js` 隡 CI 頝滯  27-P3/P4 禮.21 霈啁餈葵銝芣雿遣鈭敶瓷霈堆718 passed / 1 failed嚗雿辣 `workgraph-planning` 耦agent.md` / `config.json` / `identity.md` / `soul.md` / `tools.md`
+3. **雿 `system/agents/task-planning/`**嚗system/templates/` 撌脣 2026-08-18  agent 敶**敶餃**嚗50 銝芣雿 `git mv` 餈 `system/agents/`嚗base`  `_base`嚗耦 `workgraph-planning`嚗agent.md` / `config.json` / `identity.md` / `soul.md` / `tools.md`**銝 `_` 撘憭游**  `_` 靽嚗隡◤頝唾
+
+4. **`agent.md` + `soul.md` 敹◆銝甈∪遣撉冽‵**雿**瘥**嚗agent.md` 銝 `soul.md` 征蒂 `_base` 爸嚗 `system_agents.status='draft'` 瘥 `hire()` 僎餈 `body_not_ready` `_base` 憭撉冽  隞亙‵葉****.claude/skills/main_skill/SKILL.md` 57 銝芣雿 54 銝芣瓷
+
+5. **`_registry.json` 霈唳遣敶雿**  餈銝阮﹝蝥迤嚗graph-seed-service.seedAgents()`  `readdirSync(system/agents/)` **敶**嚗_registry.json`嚗歇 `system/agents/_registry.json`嚗蝏撘鈭 id 銵 `benchmark_score`嚗egistry 蝻箸 seed阮霈唬 CI 頝滯 27-P3/P4 禮.21  `template-refs.test.js` 蝖祉 `system/templates` 頝臬隞**霂交迤韏瑟**遣霈桅◇霈堆benchmark_score` 閬嚗
+
+6. **雿迤楝敺蝖祈嚗漣**嚗gent 餈 cwd  `system/agents/{aid}/{cid}/{taskId}/`嚗楛摨 3嚗
+   - 撘雿撌梁辣  `../../`嚗 `../../tools.md`嚗
+   - 撘隞  `../../../../../`嚗
+   - **鈭支頝臬ㄧ撖**嚗workspace/x.md` 隡餈遙敶◤皜◆內霂憭氬漱隞敹◆銝銵**蝏笆頝臬**嚗雿迤霈唬 `$W`
+
+    `system/agents/orggraph-planning/agent.md`嚗嚗**銝**嚗鈭抒瘝∩犖  銝﹝蝐駁
  
 #### 頝唾
  
@@ -632,7 +643,7 @@ for (const t of queuedTasks) {
  
 1. **憭甈∩仃韐亦 LLM 靚噢隞餃**予銝噢銝甈∪郊 DB 銝剝甈∪憭梯揖 agent 靚漣頝臬批.9 蝥行 2嚗銝嚗找.2嚗**銝★**  撠遙雿銝迎甈 agent 甇餃停蝑銝芯噢銝
 2. **捶摰** 5  task 撠望 5 隞 `DEFAULT_TASK_BUDGET`嚗 100 甈∟ / 500 銝 token嚗漣銝敺 `draft`◆鈭箇＆霈扎  銝甇交銝銝銝撘內 銝芯遙  N  遙
-3. **雿霈 `_registry.json` 隡 CI 頝滯**27-P3/P4 禮.21 銝芣雿遣鈭敶瓷霈堆template-refs.test.js` 敶蝥ｇ遣敶霈啣◆銝 commit 
+3. **雿迤 registry 霈**嚗批.9 蝥行 4/5 撌脩迤阮捏嚗agent.md` + `soul.md` 瘝∪說撠勗 `draft`嚗hire()` 餈 `body_not_ready`嚗 `_registry.json` 蝻箸撠葵 `benchmark_score`憭雿迤撖寡楝敺**銝漣**嚗批.9 蝥行 6嚗 餈﹝振銝芣
  
 ### 5. 銝文 `T-` id   禮 瘨圾嚗銋
  
@@ -656,6 +667,20 @@ for (const t of queuedTasks) {
  
 >  3 隞 6 瘨典 12 嚗甈∪蝏  13/14/15 銝撖孵銝芥阮隡
  
+### 銝僎銵葉gent 敶蝟鳴2026-08-18 摰
+
+﹝嚗銝撌乩瑪甇 **agent 敶**嚗system/templates/` 撟嗅 `system/agents/`嚗舅隞 `_registry.json` 嚗極雿蝥 900 銝芸**撠漱**﹝捶鈭日摰
+
+| 鈭日 | 蝏捏 |
+|---|---|
+| ﹝ / 撣賊settleRun` / `markRunReady` / `stopRun` / `defaultPlanWorkGraph` / `PLAN_MAX_ROUNDS` / `writeTaskGoalArtifact` / `reportRunOutcome` / `ACTIVE_ROOT_RUN_STATUS` / `saveTaskMeta` / `getAggregatedTasks`嚗 **摮暑**鈭漲 650 銵5 銝芣辣嚗瓷餈  27-P3/P4 餈鈭遠 |
+| ﹝**銵蛹**蝏捏嚗markRunReady` 香 `planning`settleRun`  `advanceOne` ◤靚stopRun` 銝粥 `settleRun`reportRunOutcome` 霂 `run.okr_node_id` 銝 `ctx.reportTo`嚗 **憭** |
+| `work-graph-db.js`嚗createRun` 撱箄銵updateRunStatus` 隞嗆RUN_TRANSITIONS`銝蝝Ｗ **摰鋡急**  蝚砌蔭憭銝蔣 |
+| 撱箸雿批.9嚗 **阮歇蝥迤**嚗system/templates/` 敶餃雿 `system/agents/`嚗_registry.json` 撌脖皞仍嚗seedAgents` 敶嚗霈唳迤**瘥**嚗agent.md` + `soul.md` 征銝 `_base` 嚗 `hire()` 餈 `body_not_ready`嚗雿迤撖寡楝敺蝖祈嚗漣祕閫 禮.9 蝥行 3-6 |
+| `agent-chat.js`嚗+455 銵company.js`agent-manager.js` | ﹝ 1 /  5 閬辣**蝡舐憓誨蝒**嚗 禮 /task/dispatch`  URL 銝窈瘙銝芸銝閬 5 撘撌亙**鈭銝**嚗tools-base.md` 鋡急嚗銝芸末餈寡情嚗 |
+
+**撖寞蔣**嚗 1 撣詨撌伐work-graph-db.js` 犖閫衣１嚗遣銵 + ‵蝥舀憓** 2  `task-planning` 雿 agent 遣**  雿敶霈唳撘敶Ｘ敶Ｘ銝 5 銋 `agent-chat.js`
+
  1+2 銝瑪撠勗歇蝏圾敹嚗隞餃瘙圾嚗 3 銝芥
  
 ---