sdd-specify 是一个用于撰写或完善规格文件 spec.md 的技能,属于规格驱动开发(Spec-Driven Development)技能集。其路径引用均相对于技能文件本身,运行前需先解析这些路径。
用途:该技能面向规格驱动开发流程的第一阶段——编写初稿规格。它要求读取规格驱动开发主说明中的“阶段一”章节,以及工作流阶段参考中“阶段一”和针对已有行为变更的“增量规格”章节,并采用提示模式参考中的“假设呈现提示”与“初始规格提示”。当 spec.md 存在未决问题时,还需使用“澄清阶段提示”和“澄清后规格更新提示”,并遵循产物模板中的 spec.md 模板。
主要能力:产出位于 specs/<feature>/spec.md 的规格文件,包含按 MoSCoW 优先级排序的验收准则(AC),其中每条 [MUST] 都需带一行证明。若请求涉及认证、权限或计费,需为每个角色的允许与拒绝操作以及每种错误情况编写显式验收准则。技能要求在当前轮次直接写出草稿规格,而不是先等待答复:每个无法从仓库确认的假设都写入规格中作为 [NEEDS CLARIFICATION] 标记,并在回复中统计数量。
使用方式:草稿中每个未澄清项会阻塞 Gate 1,需逐项命名并说明其答案如何改变设计,并主动提出澄清;若用户坚持继续,则将每个标记替换为显式的 Assumption: 行并在报告中说明,不静默选择也不无限拒绝。冷读分 M 和 L 两个级别:在仅有 spec.md、constitution.md 及增量规格 Baseline 文件的全新智能体或会话中运行“冷读提示”,将其复述与用户意图比对,列出所有存在多种解读的验收准则短语(例如“records belonging to M”可能指由 M 创建或分配给 M),每条都视为 Gate 1 未通过并在规格中修正;若没有可用的新上下文,则冷读结论为不确定。规格不得由技能标记为已批准,须由人类完成。最后按质量门禁中的 Gate 1 检查,并运行 node ../spec-driven-development/scripts/sdd-check.mjs specs/<feature> 进行验证;人类批准后进入 /sdd-plan。回复格式为:Gate 1 结果(pass|fail|inconclusive)、每条未通过检查一行、ACs 中 MUST/SHOULD/COULD 数量、未决问题数量、规格路径及一个下一步行动,不超过约 25 行,且不粘贴规格内容。
适用场景:适用于需要在编码前明确需求、验收准则与假设的软件开发任务,尤其适合涉及多角色权限与计费逻辑的规格撰写,以及已有行为变更时的增量规格编写。
限制:具体功能细节、收费、平台支持等信息暂未提供;技能依赖同技能集内的多个参考文件与脚本,需按相对路径正确解析;冷读检查在无新上下文时仅能给出不确定结论。