其他
需求模糊、功能复杂或跨团队协作时…
在需求不清晰、功能复杂(超过 2 天)或涉及跨团队协作时,通过系统化提问把模糊需求澄清到 ≥90 分并产出可执行 PRD。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 46/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 41/100 ×0.15
适用场景
需求模糊、功能复杂或跨团队协作时,用聚焦通用
解决思路
- 自动将模糊需求转化为可执行 PRD:使用系统化澄清和 100 分评分系统。
- 在编码前问两个核心问题:Why?(做 YAGNI 检查)和 Simpler?(做 KISS 检查)。
- 检测模糊功能请求:当用户只说「add login feature」「implement payment」「create dashboard」等,且缺少怎么做、用什么技术、有哪些约束时,进入澄清。
- 检测缺失技术上下文:未提及技术栈、未识别集成点、未说明性能/安全约束时,进入澄清。
- 检测不完整规格:没有验收标准、没有成功指标、没有考虑边缘情况、未提及错误处理时,进入澄清。
- 检测模糊范围:边界不清(如「用户管理」具体指什么)、未区分 MVP 与未来增强、缺少「不包含什么」时,进入澄清。
- 遵循系统化提问:提出聚焦、具体的问题。
- 每轮只问一个类别(2-3 个问题)。
- 基于之前的回答继续提问。
- 避免让用户不堪重负。
- 做质量驱动迭代:持续评估清晰度分数(0-100)。
- 系统性识别缺口。
- 迭代直到清晰度分数 ≥ 90。
- 记录所有澄清轮次。
- 产出可执行结果:生成具体规格。
- 包含可衡量的验收标准。
- 提供可执行阶段。
- 支持直接实现。
- 步骤 1 初始需求分析:输入是用户的需求描述。
- 步骤 1 任务:解析并理解核心需求。
- 步骤 1 任务:生成特性名称(kebab-case 格式)。
- 步骤 1 任务:确定文档版本(默认 `1.0`,除非用户另有指定)。
- 步骤 1 任务:确保 `./docs/prds/` 存在,用于 PRD 输出。
- 步骤 1 任务:执行初始清晰度评估(0-100)。
- 使用评分表 Functional Clarity:满分 30 分——明确输入/输出 10 分,定义用户交互 10 分,说明成功标准 10 分。
- 使用评分表 Technical Specificity:满分 25 分——提及技术栈 8 分,识别集成点 8 分,指定约束 9 分。
- 使用评分表 Implementation Completeness:满分 25 分——考虑边缘情况 8 分,提及错误处理 9 分,指定数据验证 8 分。
- 使用评分表 Business Context:满分 20 分——问题陈述清晰 7 分,识别目标用户 7 分,定义成功指标 6 分。
- 初始回复格式:说明已理解用户需求,并帮助细化规格。
- 初始回复格式:给出「Current Clarity Score: X/100」。
- 初始回复格式:列出「Clear Aspects」即已清晰方面。
- 初始回复格式:列出「Needs Clarification」即需要澄清的缺口。
- 初始回复格式:告诉用户将系统性澄清这些点。
- 步骤 2 缺口分析:分析功能范围——核心功能是什么、边界是什么、范围外是什么、边缘情况是什么。
- 步骤 2 缺口分析:分析用户交互——用户如何交互、输入是什么、输出是什么、成功/失败场景是什么。
- 步骤 2 缺口分析:分析技术约束——性能需求、兼容性需求、安全考虑、可扩展性需求。
- 步骤 2 缺口分析:分析业务价值——解决什么问题、目标用户是谁、成功指标是什么、优先级是什么。
- 步骤 3 交互澄清的问题策略:从最高影响缺口开始。
- 步骤 3 问题策略:每轮问 2-3 个问题。
- 步骤 3 问题策略:逐步建立上下文。
- 步骤 3 问题策略:使用用户的语言。
- 步骤 3 问题策略:有帮助时提供示例。
- 步骤 3 问题格式:说明需要澄清以下点以完成需求文档。
- 步骤 3 问题格式:按「[Category]: [Specific question]?」列出具体问题。
- 步骤 3 问题格式:如对用户有帮助,提供「For example: [Example if helpful]」。
- 步骤 3 问题格式:请用户提供答案,然后继续细化 PRD。
- 步骤 3 每次用户回复后:更新清晰度分数。
- 步骤 3 每次用户回复后:把新信息记录到工作 PRD 大纲中。
- 步骤 3 每次用户回复后:识别剩余缺口。
- 步骤 3 每次用户回复后:如果分数 < 90,继续下一轮问题。
- 步骤 3 每次用户回复后:如果分数 ≥ 90,进入 PRD 生成。
- 步骤 3 分数更新格式:感谢用户补充信息。
- 步骤 3 分数更新格式:给出「Clarity Score Update: X/100 → Y/100」。
- 步骤 3 分数更新格式:总结新增澄清内容。
- 步骤 3 分数更新格式:列出剩余待澄清点(如果分数 < 90)。
- 步骤 3 分数更新格式:如果分数 < 90,继续下一轮问题;如果分数 ≥ 90,说明「完美!我现在将生成完整的 PRD 文档……」。
- 步骤 4 PRD 生成:一旦清晰度分数 ≥ 90,生成完整 PRD。
- 步骤 4 输出文件:最终 PRD 写入 `./docs/prds/{feature_name}-v{version}-prd.md`。
- 步骤 4 输出文件:使用 `Write` 工具创建或更新此文件。
- 步骤 4 输出文件:从 PRD 中记录的文档版本推导 `{version}`(默认 `1.0`)。
- PRD 结构 Requirements Description:Background 包括 Business Problem、Target Users、Value Proposition。
- PRD 结构 Feature Overview:Core Features、Feature Boundaries、User Scenarios。
- PRD 结构 Detailed Requirements:Input/Output、User Interaction、Data Requirements、Edge Cases。
- PRD 结构 Design Decisions:Technical Approach 包括 Architecture Choice、Key Components、Data Storage、Interface Design。
- PRD 结构 Constraints:Performance Requirements、Compatibility、Security、Scalability。
- PRD 结构 Risk Assessment:Technical Risks、Dependency Risks、Schedule Risks。
- PRD 结构 Acceptance Criteria:Functional Acceptance 使用 `- [ ]` 列出 Feature 1/2/3 的具体验收条件。
- PRD 结构 Quality Standards:Code Quality、Test Coverage、Performance Metrics、Security Review。
- PRD 结构 User Acceptance:User Experience、Documentation、Training Materials(如需要)。
- PRD 结构 Execution Phases Phase 1 Preparation:目标为环境准备和技术验证;列出具体任务、deliverables、time。
- PRD 结构 Execution Phases Phase 2 Core Development:目标为实现核心功能;列出具体任务、deliverables、time。
- PRD 结构 Execution Phases Phase 3 Integration & Testing:目标为集成和质量保证;列出具体任务、deliverables、time。
- PRD 结构 Execution Phases Phase 4 Deployment:目标为发布和监控;列出具体任务、deliverables、time。
- PRD 文末包含 Document Version、Created、Clarification Rounds、Quality Score。
- DO:提具体、有针对性问题。
- DO:基于之前回答继续。
- DO:提供示例引导用户。
- DO:保持对话式语气。
- DO:在 PRD 中总结澄清轮次。
- DO:使用清晰、专业的英语。
- DO:生成具体规格。
- DO:保持澄清模式直到分数 ≥ 90。
- DON'T:不要一次问所有问题。
- DON'T:不要未经确认做假设。
- DON'T:不要在 90+ 分前生成 PRD。
- DON'T:不要跳过任何必需章节。
- DON'T:不要使用模糊或抽象语言。
- DON'T:不要在用户未回复时继续推进。
- DON'T:不要过早退出技能模式。
- 成功标准:清晰度分数 ≥ 90/100。
- 成功标准:所有 PRD 章节完整且有实质内容。
- 成功标准:验收标准可用 `- [ ]` 格式勾选。
- 成功标准:执行阶段可执行且任务具体。
- 成功标准:用户批准最终 PRD。
- 成功标准:准备好开发交接。
适用边界 · 注意事项
- 已有具体文件路径(如 `auth.go:45`)、代码片段、现有函数/类引用,或缺陷修复已有清晰复现步骤时,不要激活。
- 需求已足够清晰或清晰度分数已达到 90 分后,不要继续澄清或拖延生成 PRD。
- 不要一次问完所有问题、未经确认做假设、在用户未回复时推进、跳过必需章节或提前退出澄清模式。