📝 docs(templates): refine superpowers prompt boundaries

2026-05-25 15:02:16 +08:00
parent 25d895d8b3
commit 61afff9d48
18 changed files with 342 additions and 296 deletions
@@ -1,51 +1,53 @@
 # 需求澄清模板

 <!--
-按需使用：当需求不明确或存在歧义时参考本模板。
-Vibe-coding 场景下可跳过，直接开始实现。
+用途：当需求存在歧义时，只补齐会改变实现或验证路径的最小信息。
+触发：需求不明确、存在两种以上合理实现路径、缺少关键约束时。
 -->

 ## 何时使用

 - 需求描述不明确
- 存在多种理解方式
- 缺少关键信息
+- 存在多种合理理解方式
+- 缺少会改变实现路径的关键信息

---
+## 先读
+
+- `AGENT_RULES.md`
+- `memory-bank/project-brief.md`
+- `memory-bank/active-context.md`
+
+## 规则
+
+- 每轮最多问 1 个问题
+- 只问会改变实现或验证路径的问题
+- 能低风险继续时，优先给出默认项后推进
+- 不重复询问已能从上下文推断的信息

 ## 澄清步骤

-### 1. 复述需求
+1. 用自己的话复述当前理解
+2. 识别真正影响实现路径的歧义点
+3. 只提出 1 个最高价值问题
+4. 给出推荐默认项和理由

-```text
-我理解你的需求是：[用自己的话复述]
+## 输出协议
+
+```markdown
+## Current Understanding
+- ...
+
+## Open Question
+- ...
+
+## Recommended Default
+- ...
 ```

-### 2. 识别歧义
+## 停止条件

- 歧义 1：[描述不明确的地方]
- 歧义 2：[可能有多种理解的地方]
-
-### 3. 提出问题
-
-> 只问阻塞问题，最多 1–2 个；优先给出选项让用户选择。
-
- 这个功能是否包括 [场景 A]？
- 当 [条件 X] 时，应该 [行为 Y] 还是 [行为 Z]？
-
-### 4. 提供选项
-
-**选项 A**：[方案描述]
-
- 优点：...
- 缺点：...
-
-**选项 B**：[方案描述]
-
- 优点：...
- 缺点：...
-
-**推荐**：[推荐哪个，为什么]
+- 已有足够信息可低风险推进时停止提问
+- 问题不影响实现路径时停止提问

 ---