📝 docs(templates): refine superpowers prompt boundaries

templates/prompts/README.md

@@ -1,6 +1,8 @@
 # 提示词入口
 
-本目录包含 AI 代理的工作流入口模板，用于把任务路由到合适的执行路径。
+本目录包含 AI 代理的任务入口模板，用于把任务路由到合适的执行路径。
+它是薄入口层，不是流程权威；完整流程与执行约束只在
+`AGENT_RULES.md` 定义。
 
 ## 目录结构
 
@@ -8,13 +10,13 @@
 prompts/
 ├── README.md              # 本文件
 ├── system/
-│   └── agent-behavior.md  # 工作流入口
+│   └── agent-behavior.md  # 入口路由
 ├── coding/
 │   ├── clarify.md         # 需求澄清模板
 │   ├── verify-change.md   # 变更验证模板
 │   ├── close-task.md      # 本轮收尾模板
 │   ├── update-memory.md   # 回写记忆模板
-│   └── code-review.md     # MR/PR 代码评审流程
+│   └── code-review.md     # MR/PR 代码评审入口
 └── custom/                # 可选：项目私有提示词
 ```
 
@@ -22,53 +24,31 @@ prompts/
 
 | 模板                  | 触发场景             |
 | --------------------- | -------------------- |
-| **agent-behavior.md** | 选择工作流入口       |
+| **agent-behavior.md** | 选择任务入口         |
 | **clarify.md**        | 需求不明确时澄清     |
 | **verify-change.md**  | 声称完成前做验证     |
 | **close-task.md**     | 本轮工作收尾         |
 | **update-memory.md**  | 上下文变化后回写记忆 |
 | **code-review.md**    | 执行 MR/PR 代码评审  |
-| **custom/*.md**       | 项目私有补充流程     |
+| **custom/\*.md**      | 项目私有补充入口     |
 
-## 工作流程
+## 入口边界
 
-```text
-需求不清 → clarify.md
-    ↓
-入口约束 → using-superpowers
-    ↓
-头脑风暴 → $brainstorming skill → docs/superpowers/specs/*-design.md
-    ↓
-spec 完成后 → `playbook.py -record-spec <path> -progress memory-bank/progress.md`
-    ↓
-生成计划 → $writing-plans skill → docs/superpowers/plans/*.md
-    ↓
-plan 完成后 → `playbook.py -record-plan <path> -progress memory-bank/progress.md`
-    ↓
-领取计划 → `main_loop.py claim`
-    ↓
-执行计划 → `$executing-plans`
-    ↓
-代码类任务 → `karpathy-guidelines` + `.agents/` + `AGENT_RULES.md`
-    ↓
-写回状态 → `main_loop.py finish`
-    ↓
-更新摘要 → update-memory.md
-    ↓
-验证改动 → verify-change.md
-    ↓
-本轮收尾 → close-task.md
-    ↓
-代码评审（有 MR/PR 时）→ code-review.md
-```
+- 需求不明确：看 `clarify.md`
+- 需要判断设计、计划或执行路径：先回到 `AGENT_RULES.md`
+- 需要验证交付结果：看 `verify-change.md`
+- 需要结束本轮并整理交付摘要：看 `close-task.md`
+- 需要回写上下文：看 `update-memory.md`
+- 需要评审 MR/PR：看 `code-review.md`
+- 需要保留设计与计划产物：只写入 `docs/superpowers/`
 
-> `coding/` 下是可被框架覆盖更新的标准模板；
-> 项目私有流程应沉淀到 `custom/`。
+> `coding/` 下是可被框架覆盖更新的标准入口模板；
+> 项目私有补充入口应沉淀到 `custom/`。
 >
-> `prompts/` 是入口层；核心规则在 `AGENT_RULES.md`，
-> 长期记忆在 `memory-bank/`，状态留痕必须走
-> `playbook.py -record-spec/-record-plan` 与
-> `main_loop.py claim/finish`。
+> `prompts/` 只负责把代理导向正确入口；`AGENT_RULES.md`
+> 是唯一流程权威；`AGENT_RULES.local.md` 保存项目私有规则；
+> `memory-bank/` 保存项目上下文与状态；`docs/superpowers/`
+> 保存设计与计划产物。
 
 ---