📝 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` 写入
|
这两个 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` 定义,这里不重复展开。
|
||||||
|
|
|
||||||
|
|
@ -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 约定验证
|
||||||
|
|
|
||||||
|
|
@ -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` 自动执行提交或变更归档",
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue