name: requirement-clarification description: 从研究结果生成澄清问题。必须在规划阶段前使用。在技术工作开始前验证需求是否完整且明确。
需求澄清技能
目的
将模糊的用户请求转化为清晰、可实施的需求。
何时使用
- 研究阶段完成后
- 规划阶段开始前
- 当用户需求不明确时
- 对于非技术性用户请求
问题模板
用于范围澄清
参见 question-templates/scope-questions.md
常见模式：
- “[功能] 是否也应该处理 [边缘情况]？”
- “当 [条件] 时，应该发生什么？”
- “[假设] 是否正确，或者你需要 [替代方案]？”
用于技术决策
参见 question-templates/technical-questions.md
常见模式：
- “对于 [目的]，你更倾向于 [A] 还是 [B]？”
- “这应该与 [现有系统] 集成吗？”
- “需要什么级别的 [性能/安全性]？”
用于约束
参见 question-templates/constraint-questions.md
常见模式：
- “这有截止日期吗？”
- “有任何 [技术/方法] 限制吗？”
- “谁将使用这个功能？”
问题质量检查清单
每个问题必须是：
- [ ] 具体（不模糊）
- [ ] 可回答（用户拥有信息）
- [ ] 有影响（答案影响实施）
- [ ] 非技术性（语言易懂）
- [ ] 可默认（有回退假设）
问题优先级级别
必须回答（阻碍）
- 如果未回答会阻碍规划的问题
- 最多10个阻碍性问题
- 始终提供默认值
应该回答（重要）
- 提高实施质量的问题
- 如果未回答，可以使用默认值进行
可以回答（锦上添花）
- 用于优化的问题
- 对核心实施影响较小
验证脚本
运行 scripts/validate-requirements.py 以检查：
- 所有阻碍性问题已回答
- 没有矛盾的需求
- 技术可行性已确认
- 分配了置信度级别
python scripts/validate-requirements.py <session-id>
输出位置
- 问题：
docs/specs/questions-{session}.md - 需求：
docs/specs/requirements-{session}.md
与工作流集成
- 研究阶段在
docs/research/中产生发现 - 此技能从那些发现生成问题
- 用户回答问题
- 生成已验证的需求文档
- 规划阶段可以开始