用途
该技能用于 SDLC 的规格创建阶段,承接已批准的 sdlc//intent.md,生成同一工作项下的 sdlc//spec.md。它只回答“系统必须做什么”,规划与生产代码改动属于后续阶段。
主要能力
- 读取已批准的 intent.md,并在需要时检查相关仓库说明、现有行为、接口、依赖与架构,以确保规格与现有系统兼容。
- 将意图转换为可观察的功能需求、相关非功能需求、接口与契约、输入输出、失败行为以及可测试的验收标准。
- 在需要时保留现有公开行为;仅在有助于可追溯性时使用 FR-1 等标识。
- 在适用时说明安全、兼容性与运行要求。
- 在能提升精确度时使用 MUST、SHOULD、MAY,并在相关处包含正向、负向与失败场景。
- 主动揭示可能影响正确性的冲突、缺失需求与假设。
使用方式
以已批准的 intent.md 为必需输入,生成自包含、保持范围的 spec.md。推荐章节结构为:Specification 标题、Context、Goals、Non-Goals、Functional Requirements、Interfaces and Contracts、Error and Failure Behavior、Nonfunctional Requirements、Acceptance Criteria、Assumptions and Open Questions,仅使用有用章节。仓库检查用于确定所需行为,不得变成逐文件的实现方案。若意图不足以支撑可靠规格,应先提出所需问题或将意图退回修订;应通过智能体的交互式提问工具(如 Claude Code 的 AskUserQuestion)分组提出相关问题,每次 2-4 个选项、推荐项在前并标注“(Recommended)”;无此类工具时使用纯文本。不得生成任务、规定实现顺序、修改生产代码、扩大范围或创建 plan.md。
适用场景
适用于已有明确意图、需要在进入规划前固化可测试系统规格的软件变更工作项,尤其适合需要保持既有公开行为、明确失败行为与验收标准的场景。
限制
该技能不规划实现、不拆分任务、不修改生产代码、不扩大范围、不创建 plan.md。规格评审批准后,将工作项路径移交 sdlc-create-plan;若需求或验收标准发生变化,应先修订本阶段产物再重新规划。