技能介绍

解决的具体问题

在代理驱动的 Sprint 开发工作流中，specs.md 文件的质量直接决定最终输出的质量。当规格写得过于宽泛或含糊时，会出现几个典型问题：

代理实现偏离预期：缺少明确的 Out of Scope 部分时，代理可能实现本不该包含的功能。
测试未按预期触发：Testing 部分被省略或设置为 skip，导致 QA 和 UI 测试代理根本不运行。
迭代无法收敛：规格对单个 Sprint 而言过于宽泛，工作不断拖延到下一轮。
规格文件相互冲突：specs.md 中的需求存在歧义或矛盾，架构师生成的实现文件互相打架。
手动测试未触发：UI Testing Mode 设为 automated，但有些场景需要人工验证视觉效果或进行探索性测试。

核心能力与关键步骤

该技能提供编写高效 specs.md 的具体指导，核心流程如下：

定义目标：在 .claude/sprint/[N]/specs.md 顶部用一句话概括本 Sprint 交付的内容，例如"Add user authentication with email/password login"。
划定范围边界：使用 In Scope 和 Out of Scope 两个小节列出具体功能、端点或组件。代理只实现范围内的内容；歧义会导致实现偏离。
配置测试：在 Testing 小节中设置三项参数：

- QA：required / optional / skip——控制 API 和单元测试执行
- UI Testing：required / optional / skip——控制基于浏览器的 E2E 测试
- UI Testing Mode：automated / manual——自动运行还是用户驱动

保持规格精简：架构师会将高层规格展开为详细的实现文件（如 backend-specs.md、frontend-specs.md）。在 specs.md 中过度指定实现细节会不必要地束缚架构师。
迭代改进：对于迭代式 Sprint，审查上一轮的 status.md，将已完成项从规格中移除，补充测试中新发现的需求或 bug 修复。

适用边界

使用该技能前需要满足以下前置条件：已安装 Sprint 插件、已完成 /sprint:setup 项目入门、已通过 /sprint:new 创建 Sprint 目录、理解 sprint phase 生命周期。QA 应设为 required 用于新 API 端点、业务逻辑变更和数据校验规则；对于纯前端变更、文档更新或配置变更则设为 skip。该技能仅用于业务需求说明与验收标准写作场景，围绕用户当前提供或明确授权处理的材料完成任务。