用途:在 SDD 流程开始前,把用户提供的零散原始素材(工单、需求、设计文档、笔记、URL、引用的文件或路径)转化为 SDD 所需的结构化简报,避免在资料未明确处自行猜测。
适用时机:用户粘贴工单、需求、设计文档或笔记并说“做这个”;用户指明文件、路径或 URL 作为事实来源;在调用 sdd-clarify 之前、启动 sdd-feature-flow 之前,目标被埋在材料中而非直接陈述时。
主要流程:逐字收集用户给出的所有来源,读取被引用的文件,用 WebFetch 获取 URL,如可用则通过其 MCP/CLI 拉取工单,不能止步于粘贴内容而忽略其指向的其他材料;当材料庞大或多来源时,委派只读代理(Explore 或通用代理)摄入并返回精简摘要,以保持主上下文轻量,单个短粘贴则可直接内联读取;仅依据来源合成简报,固定包含:Goal(一两行说明构建什么与为什么)、In scope/Out of scope(来自来源的列表)、Constraints(来源中陈述的数据模型、契约、集成、命名、限制)、Load-bearing unknowns(来源未确定、会改变代码/契约/模板结构的决策,用于 sdd-clarify 的提问)、Sources(实际读取的文件/URL/工单);随后将未知项交给 sdd-clarify 向用户提问,再把解决后的简报作为目标连同确认参数传递给 sdd-feature-flow 工作流。
规则与限制:一切以来源为准,来源未说明即为未知而非假设,应暴露而非编造;本技能绝不开始编写规格或代码,唯一输出是简报;摘要应保持紧凑,目的是把原始材料压缩为决策与未知项。其它细节暂未提供。