Requirements Clarity 说明文档

# 需求澄清 (Requirements Clarity) 这是一项系统化技能，旨在通过聚焦对话和迭代澄清，将模糊的需求转化为可执行的产品需求文档 (PRD)。 ## 目的 本技能通过确保需求在实施前达到高度清晰，帮助你避免代价高昂的误解和返工。它使用 100 分评分系统来系统地识别差距，并引导你完成针对性的提问，直到需求达到开发就绪状态。 ## 何时使用此技能 ### 适用场景 - 需求模糊或模棱两可（例如：“添加登录功能”、“实现支付”） - 功能复杂且预计耗时超过 2 天 - 需要跨团队协作 - 缺乏技术背景（未提及技术栈、集成点或约束条件） - 规范不完整（无验收标准、成功指标、边界情况） - 范围边界不清（“‘用户管理’具体包含什么？”） ### 不适用场景 - 提到了具体文件路径（例如：“修复 auth.go:45”） - 请求中已包含代码片段 - 处理现有函数/类（请改用代码审查） - 具有明确复现步骤的 Bug 修复 ## 工作原理 ### 澄清流程 1. **初步分析** (第 1 步) - 解析你的需求描述 - 使用详细的评分标准生成清晰度得分 (0-100) - 识别哪些部分清晰，哪些需要澄清 - 创建功能名称并为 PRD 生成做准备 2. **差距分析** (第 2 步) - 系统地识别四个维度中缺失的信息： - **功能范围**：核心功能、边界、边界情况 - **用户交互**：输入、输出、成功/失败场景 - **技术约束**：性能、兼容性、安全性、可扩展性 - **业务价值**：问题陈述、目标用户、成功指标 3. **交互式澄清** (第 3 步) - 每轮提出 2-3 个聚焦问题（避免信息过载） - 逐步构建上下文 - 每次回答后更新清晰度得分 - 直到得分达到 ≥ 90/100 4. **PRD 生成** (第 4 步) - 一旦清晰度得分 ≥ 90，生成综合 PRD - 保存至 `./docs/prds/{feature-name}-v{version}-prd.md` - 以结构化格式包含所有已澄清的信息 ### 清晰度评分标准 100 分评分系统评估以下内容： - **功能清晰度** (30 分)：清晰的输入/输出