🗑️ remove(progress): drop workflow state tracking

Use plan-status as the only machine state source for plan queueing, claiming, and finishing.

Route record-plan through queue insertion and update templates/prompts to match the single-state model.

BREAKING CHANGE: playbook.py -record-spec and main_loop.py record are removed.
This commit is contained in:
csh
2026-06-26 17:10:09 +08:00
parent c35aba5139
commit 1911d2dda3
11 changed files with 243 additions and 462 deletions
+10 -16
View File
@@ -62,12 +62,11 @@
> `using-superpowers` 是会话启动时判断并加载适用 skill 的入口 skill。
- 规划阶段必须走 `using-superpowers -> brainstorming -> writing-plans`
- `$brainstorming` 产出 `docs/superpowers/specs/*-design.md`写出 spec
立即用 `playbook.py -record-spec` 记录 `phase=planning``spec=<path>`
- `$brainstorming` 产出 `docs/superpowers/specs/*-design.md`spec 文件本身即为设计留痕
- `$writing-plans` 产出 `docs/superpowers/plans/*.md`;写出 plan 后立即用
`playbook.py -record-plan` 记录 `plan=<path>``executor=executing-plans`
`constraints=karpathy-guidelines,.agents,AGENT_RULES`
- spec/plan 产出阶段不单独提交或归档,只做文件落地与状态留痕;如外部 skill
`playbook.py -record-plan` 追加到 `memory-bank/progress.md`
`plan-status` 队列,初始状态为 `pending`
- spec/plan 产出阶段不单独提交或归档,只做文件落地与 Plan 入队;如外部 skill
要求写完后立即提交,以本文件为准,推迟到 Plan 完成后统一处理
- Plan 生命周期由 `main_loop.py` 协调,通过 `memory-bank/progress.md` 留痕
- Plan 执行入口只能是主循环:领取前不得进入 `$executing-plans`,领取后默认用
@@ -118,8 +117,7 @@
- `in-progress`:执行中,用于恢复中断任务
- `done`:已完成
- `blocked`:阻塞,需人工介入或切换环境
- `skipped`:永久跳过,不再执行`workflow-state.phase` 也写为
`skipped`
- `skipped`:永久跳过,不再执行
`skipped` 如需恢复,必须手动改回 `pending`
@@ -140,7 +138,7 @@ python {{PLAYBOOK_SCRIPTS}}/main_loop.py claim \
-owner "<当前session或agent标识>"
```
该命令在锁保护下完成:自动识别当前环境(windows/linux/darwin)、校验 Plan Meta、优先恢复 `in-progress`、选择第一个可执行 Plan写入 `claimed_by`/`claimed_at` 并清理上一轮 `verification`
该命令在锁保护下完成:自动识别当前环境(windows/linux/darwin)、校验 Plan Meta、优先恢复 `in-progress``plan-status` 行顺序选择第一个可执行 Plan,并在对应 Plan 行写入 `claimed_by`/`claimed_at`
stdout 必须包含 `PLAN=<path>`;如为环境恢复,还会附带 `NOTE=env:<环境>:<Task列表>`
@@ -177,11 +175,6 @@ python {{PLAYBOOK_SCRIPTS}}/main_loop.py status \
**规划留痕**
```bash
# brainstorming 完成后
python {{PLAYBOOK_SCRIPTS}}/playbook.py \
-record-spec docs/superpowers/specs/<topic>-design.md \
-progress memory-bank/progress.md
# writing-plans 完成后
python {{PLAYBOOK_SCRIPTS}}/playbook.py \
-record-plan docs/superpowers/plans/<topic>.md \
@@ -235,7 +228,7 @@ python {{PLAYBOOK_SCRIPTS}}/playbook.py \
- 本轮代码、配置、测试、模板改动
- 当前 Plan 文件(创建、补充、勾选 Task、记录结果等)
- `memory-bank/progress.md` 中本轮 `workflow-state``plan-status` 与摘要更新
- `memory-bank/progress.md` 中本轮 `plan-status` 与摘要更新
- 必要 memory 更新(如 `active-context.md``decisions.md`
**归档约束**
@@ -251,8 +244,9 @@ python {{PLAYBOOK_SCRIPTS}}/playbook.py \
- 重要决策记录到 `memory-bank/decisions.md`
- 待确认事项在回复中显式列出
- `workflow-state``plan-status` 只能通过
`{{PLAYBOOK_SCRIPTS}}/main_loop.py` 维护
- `plan-status` 是唯一机器状态源,只能通过
`{{PLAYBOOK_SCRIPTS}}/main_loop.py`
`{{PLAYBOOK_SCRIPTS}}/playbook.py -record-plan` 维护
- `progress.md` 上半部分是短期状态快照,不是 changelog;
阶段变化或执行结束后整理/替换摘要,不做无限追加
- `active-context.md` 是短期上下文快照,不是长期日志;