用途:sdd-define 是 SDD/AgentSpec 流程中的 Define 阶段技能,将 SDD Brainstorm 产出的 BRAINSTORM_{FEATURE_NAME}.md 转化为 DEFINE_{FEATURE_NAME}.md,梳理出正式、可验证的需求,为后续 Design 阶段做准备。
主要能力:只提取 Brainstorm 中已有事实、决策、初步需求、边界与依赖;按 assets/DEFINE_TEMPLATE.md 填写草稿;把歧义标注出来而不臆测;计算 Clarity Score(问题、用户、目标、成功标准、范围各 0-3 分,满分 15,达到 12 才算就绪);用 references/EARS.md 以英文锚词 When、While、If、then、Where、shall 编写验收测试;按 references/CLARIFY.md 扫描九类歧义;依据 references/VERIFY_GATE.md 生成 Verify Gate;判断 LLM Prompts 为 true 或 false 并记录理由。
使用方式:先读完整 Brainstorm,再生成草稿、结构需求、编写可度量的成功标准与 EARS 验收测试、计算评分、向用户澄清必要缺口(每轮优先一个主问题,最多不超过 5 个,可用 2-4 个多选项且推荐项在前),最终输出文件名 DEFINE_{FEATURE_NAME}.md,保存到项目根目录 sdd/ 或既有的 .claude/sdd/。若文件系统与 Python 可用,可运行 python scripts/validate_define.py <路径> 做结构检查;结尾固定为 Next Step:Execute o SDD Design by RDD。
适用场景:已有 Brainstorm 文件、需要把想法转为可验证正式需求、设计前仍需少量澄清、需要明确成功标准、验收测试、范围与 Verify Gate 时使用。涉及资金、税务或个人数据时,可在事后运行 sdd-governanca 补充治理要求。
限制:用户仍在探索问题或方向时应先用 SDD Brainstorm;不用于架构设计、编码、构建或发布。缺少 Brainstorm 或信息不足时不得凭空重建需求。不要求联网,不假定可访问仓库、文件系统、CI、数据库、API 或项目命令;Verify Gate 命令不可臆造,无法推断时应询问用户;指标缺少数字时应提问而非编造。Clarity Score 低于 12/15、存在阻塞性歧义、验收测试不符合 EARS、成功标准不可度量或 Verify Gate 缺失时,不得标记为 Ready for Design。Brainstorm 缺失、不完整或矛盾,以及用户想带阻塞项结束等情况,均有对应的处理规则,必要时仅输出 Needs Clarification 草稿且不给最终 handoff。