📝 docs(templates): refine superpowers prompt boundaries
This commit is contained in:
@@ -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/`
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user