From 9c194170a10ac488b590e7d179135b797111439c Mon Sep 17 00:00:00 2001 From: csh Date: Fri, 5 Jun 2026 09:46:55 +0800 Subject: [PATCH] :memo: docs(playbook): defer spec plan archival --- README.md | 1 + templates/AGENT_RULES.template.md | 5 +++++ tests/test_sync_templates_placeholders.py | 6 ++++++ 3 files changed, 12 insertions(+) diff --git a/README.md b/README.md index ce03de8a..73532951 100644 --- a/README.md +++ b/README.md @@ -95,6 +95,7 @@ python /scripts/playbook.py \ 这两个 helper 只负责把 `workflow-state` 写入 `memory-bank/progress.md`。 +spec/plan 产出阶段不单独提交；最终随对应 Plan 的交付变更统一归档。 真正执行 Plan 仍然走 `main_loop.py claim/finish`。 完整主链只在 `templates/AGENT_RULES.template.md` 定义，这里不重复展开。 diff --git a/templates/AGENT_RULES.template.md b/templates/AGENT_RULES.template.md index bf23b091..4a7a18f9 100644 --- a/templates/AGENT_RULES.template.md +++ b/templates/AGENT_RULES.template.md @@ -95,6 +95,9 @@ - `writing-plans` 写出 plan 后，立即用 `playbook.py -record-plan` 记录 `plan=`、`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 约定验证 diff --git a/tests/test_sync_templates_placeholders.py b/tests/test_sync_templates_placeholders.py index f296ace1..582d85ff 100644 --- a/tests/test_sync_templates_placeholders.py +++ b/tests/test_sync_templates_placeholders.py @@ -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` 自动执行提交或变更归档",