📝 docs(templates): refine superpowers prompt boundaries

This commit is contained in:
csh
2026-05-25 15:02:16 +08:00
parent 25d895d8b3
commit 61afff9d48
18 changed files with 342 additions and 296 deletions
@@ -1,49 +1,27 @@
# 工作流入口
# 任务入口路由
<!--
本文件不重复定义核心规则;它只负责把任务路由到合适的工作流入口。
本文件不重复定义核心规则;它只负责把任务路由到合适的任务入口。
安全红线、验证要求、主循环规则见 AGENT_RULES.md。
-->
## 路由原则
- 需求不明确:先看 `docs/prompts/coding/clarify.md`
- 需要设计或拆解方案:走
`using-superpowers``$brainstorming``$writing-plans`
- `brainstorming` 结束后:立即
`playbook.py -record-spec <path> -progress memory-bank/progress.md`
- `writing-plans` 结束后:立即
`playbook.py -record-plan <path> -progress memory-bank/progress.md`
- 需要执行已有 Plan:先 `main_loop.py claim`,再走
`$executing-plans`
- 如为代码类执行:在 `$executing-plans` 前强制叠加
`karpathy-guidelines`,并同时遵循 `.agents/``AGENT_RULES.md`
- 需要判断设计、计划或执行路径:先回到 `AGENT_RULES.md`
- 需要确认改动是否站得住:看 `docs/prompts/coding/verify-change.md`
- 一轮工作收尾:看 `docs/prompts/coding/close-task.md`
- 需要更新上下文:看 `docs/prompts/coding/update-memory.md`
- 需要评审 MR/PR:看 `docs/prompts/coding/code-review.md`
## 最小工作流
```text
需求不清 -> clarify
需求明确 -> using-superpowers / brainstorming / writing-plans
brainstorming 完成 -> record planning/spec
writing-plans 完成 -> record plan/executor/constraints
进入执行 -> claim -> executing-plans
代码执行 -> + karpathy-guidelines + .agents + AGENT_RULES
执行结束 -> finish -> update-memory
准备交付 -> verify-change
本轮结束 -> close-task
上下文变化 -> update-memory
```
## 说明
## 边界说明
- `prompts/` 是入口,不是规则权威
- 稳定约束写入 `memory-bank/` `AGENT_RULES.local.md`
- 执行留痕以 `memory-bank/progress.md`
`workflow-state``plan-status` 为准
- 完整流程与执行约束只在 `AGENT_RULES.md`
- 项目私有规则写入 `AGENT_RULES.local.md`
- 设计产物只放 `docs/superpowers/specs/`
- 计划产物只放 `docs/superpowers/plans/`
- 项目上下文与执行状态写入 `memory-bank/`
---