用途
该技能用于在实现完成后审查任务,验证任务是否按规格实现、是否满足验收标准与完成定义(DoD)、是否通过代码质量审查。它位于工作流“实现→审查→代码清理”的审查环节。
主要能力
- 读取任务文件,提取任务ID、描述、验收标准、DoR/DoD、依赖及规格引用。
- 验证实现与任务描述及功能规格的一致性,识别偏差与缺失。
- 读取 decision-log.md 中的决策条目,理解偏差原因。
- 统计测试文件中 @Test(或语言等价)注解的实际数量,不估算。
- 逐项检查验收标准与DoD,标记为已满足、未满足或部分满足(部分满足需有明确阻塞问题)。
- 更新 traceability-matrix.md 中的测试文件、代码文件与状态列,仅对已阅读引用的行标记为 Implemented。
- 检查有界上下文遵循情况,识别未声明的跨边界修改。
- 执行规格保真检查,识别过度规格、无溯源元数据的遗留任务、未在规格中定义的实体及规格冲突。
- 执行约定溯源检查,区分预先存在的约定与代理自创约定,并按影响给出阻塞、警告或建议。
- 在重试模式下,针对上一轮阻塞发现逐项确认关闭状态,并优先阅读 diff 块。
使用方式
直接调用示例: /skill:specs-kit-task-review docs/specs/001-user-auth/tasks/TASK-001.md 或使用规范检测: /skill:specs-kit-task-review --task=TASK-001
参数:
- --task:否,任务文件路径
- --spec:否,规格文件夹路径
- --no-confirm:否,跳过确认提示
输入解析顺序:先确定 task 路径(必需),再确定 spec 路径(可选,缺省时从任务路径推导),最后处理 --no-confirm。必需输入缺失或歧义时通过 ask_user_question 询问。
适用场景
适用于已完成实现的任务在进入代码清理前的审查,尤其适合需要严格核对验收标准、DoD、规格一致性、架构约定来源及跨边界影响的开发流程。
限制
资料明确要求不提供或请求时间估算。部分满足仅在有明确说明缺失内容的阻塞问题时才允许。规格冲突不得通过改写需求、契约或验收标准来解决,必须由代码变更或本会话之外的决策关闭。约定溯源阶段每次审查均运行。若任务文件缺少 imp-requirements 或 ac-mapping 部分,则停止审查并要求更新任务文档。具体测试框架、构建命令等资料未提供。