📝 docs(playbook): defer spec plan archival

This commit is contained in:
csh 2026-06-05 09:46:55 +08:00
parent 5d9673cf6e
commit 9c194170a1
3 changed files with 12 additions and 0 deletions

View File

@ -95,6 +95,7 @@ python <playbook_root>/scripts/playbook.py \
这两个 helper 只负责把 `workflow-state` 写入 这两个 helper 只负责把 `workflow-state` 写入
`memory-bank/progress.md` `memory-bank/progress.md`
spec/plan 产出阶段不单独提交;最终随对应 Plan 的交付变更统一归档。
真正执行 Plan 仍然走 `main_loop.py claim/finish` 真正执行 Plan 仍然走 `main_loop.py claim/finish`
完整主链只在 `templates/AGENT_RULES.template.md` 定义,这里不重复展开。 完整主链只在 `templates/AGENT_RULES.template.md` 定义,这里不重复展开。

View File

@ -95,6 +95,9 @@
- `writing-plans` 写出 plan 后,立即用 `playbook.py -record-plan` - `writing-plans` 写出 plan 后,立即用 `playbook.py -record-plan`
记录 `plan=<path>`、`executor=executing-plans`、 记录 `plan=<path>`、`executor=executing-plans`、
`constraints=karpathy-guidelines,.agents,AGENT_RULES` `constraints=karpathy-guidelines,.agents,AGENT_RULES`
- spec/plan 产出阶段不单独提交或归档,只做文件落地与状态留痕;
如外部 skill 要求写完 spec 或 plan 后立即提交,以本文件为准推迟到
Plan 完成后统一处理
- 未领取 Plan 前,不得直接进入 `$executing-plans` - 未领取 Plan 前,不得直接进入 `$executing-plans`
- 已领取 Plan 后,默认执行使用 `$executing-plans` - 已领取 Plan 后,默认执行使用 `$executing-plans`
- `$subagent-driven-development` 仅在 Plan 或平台明确要求时使用, - `$subagent-driven-development` 仅在 Plan 或平台明确要求时使用,
@ -283,6 +286,8 @@ python {{PLAYBOOK_SCRIPTS}}/main_loop.py status \
已完成交付memory 更新或回复摘要也不等同于归档 已完成交付memory 更新或回复摘要也不等同于归档
- Plan `done` 后必须完成当前 Plan 变更的归档/提交,然后才能继续领取下一个 - Plan `done` 后必须完成当前 Plan 变更的归档/提交,然后才能继续领取下一个
Plan归档方式由项目约定决定 Plan归档方式由项目约定决定
- spec/plan 本身属于后续 Plan 交付边界的一部分,不在规划阶段拆成独立
归档/提交单元
- 收尾顺序: - 收尾顺序:
1. 完成 Plan 约定验证 1. 完成 Plan 约定验证

View File

@ -200,6 +200,12 @@ class SyncTemplatesPlaceholdersTests(unittest.TestCase):
self.assertIn( self.assertIn(
"Plan `done` 后必须完成当前 Plan 变更的归档/提交", rules_template "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("Plan 范围是归档/提交边界", rules_template)
self.assertIn( self.assertIn(
"不得由 `main_loop.py finish` 自动执行提交或变更归档", "不得由 `main_loop.py finish` 自动执行提交或变更归档",