🗑️ 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:
@@ -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` 是短期上下文快照,不是长期日志;
|
||||
|
||||
Reference in New Issue
Block a user