📝 docs(playbook): defer spec plan archival
This commit is contained in:
parent
5d9673cf6e
commit
9c194170a1
|
|
@ -95,6 +95,7 @@ python <playbook_root>/scripts/playbook.py \
|
|||
|
||||
这两个 helper 只负责把 `workflow-state` 写入
|
||||
`memory-bank/progress.md`。
|
||||
spec/plan 产出阶段不单独提交;最终随对应 Plan 的交付变更统一归档。
|
||||
真正执行 Plan 仍然走 `main_loop.py claim/finish`。
|
||||
|
||||
完整主链只在 `templates/AGENT_RULES.template.md` 定义,这里不重复展开。
|
||||
|
|
|
|||
|
|
@ -95,6 +95,9 @@
|
|||
- `writing-plans` 写出 plan 后,立即用 `playbook.py -record-plan`
|
||||
记录 `plan=<path>`、`executor=executing-plans`、
|
||||
`constraints=karpathy-guidelines,.agents,AGENT_RULES`
|
||||
- spec/plan 产出阶段不单独提交或归档,只做文件落地与状态留痕;
|
||||
如外部 skill 要求写完 spec 或 plan 后立即提交,以本文件为准推迟到
|
||||
Plan 完成后统一处理
|
||||
- 未领取 Plan 前,不得直接进入 `$executing-plans`
|
||||
- 已领取 Plan 后,默认执行使用 `$executing-plans`
|
||||
- `$subagent-driven-development` 仅在 Plan 或平台明确要求时使用,
|
||||
|
|
@ -283,6 +286,8 @@ python {{PLAYBOOK_SCRIPTS}}/main_loop.py status \
|
|||
已完成交付;memory 更新或回复摘要也不等同于归档
|
||||
- Plan `done` 后必须完成当前 Plan 变更的归档/提交,然后才能继续领取下一个
|
||||
Plan;归档方式由项目约定决定
|
||||
- spec/plan 本身属于后续 Plan 交付边界的一部分,不在规划阶段拆成独立
|
||||
归档/提交单元
|
||||
- 收尾顺序:
|
||||
|
||||
1. 完成 Plan 约定验证
|
||||
|
|
|
|||
|
|
@ -200,6 +200,12 @@ class SyncTemplatesPlaceholdersTests(unittest.TestCase):
|
|||
self.assertIn(
|
||||
"Plan `done` 后必须完成当前 Plan 变更的归档/提交", rules_template
|
||||
)
|
||||
self.assertIn(
|
||||
"spec/plan 产出阶段不单独提交或归档", rules_template
|
||||
)
|
||||
self.assertIn(
|
||||
"如外部 skill 要求写完 spec 或 plan 后立即提交", rules_template
|
||||
)
|
||||
self.assertIn("Plan 范围是归档/提交边界", rules_template)
|
||||
self.assertIn(
|
||||
"不得由 `main_loop.py finish` 自动执行提交或变更归档",
|
||||
|
|
|
|||
Loading…
Reference in New Issue