关于 implementation-verify
implementation-verify 是一项在 `/speckit.implement` 后或手动运行的技能,用于核对实现是否符合规格。它根据 spec-kit 文件报告需求、任务和 API 契约覆盖情况及缺口。
主要功能
- 01FR 需求覆盖率
- 02任务完成百分比
- 03API 契约覆盖率
- 04未实现需求清单
- 05覆盖率改进建议
适用场景
- 01检查 `/speckit.implement` 后的工作
- 02查找没有对应已完成任务的需求
- 03核对端点实现与契约
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ drillan/ speckit-gates --skill implementation-verify安装后在 Claude Code 中输入/implementation-verify确认已加载。
附带文件scripts/verify.sh
详细介绍
implementation-verify
在 /speckit.implement 完成后,根据规范验证实现。
目的
此技能会自动验证你的实现是否满足指定要求。它会检查:
- FR 要求满足情况:已完成的任务涵盖了多少项 FR-XXX 要求
- 任务完成率:tasks.md 中标记为已完成的任务所占百分比
- 契约实现情况:API 端点是否按规范实现(如果存在 contracts/)
- 测试覆盖对齐情况:实现是否符合测试要求
输出
此技能会输出一份满足情况报告,其中包括:
- 覆盖率指标(FR、任务、契约百分比)
- 未实现要求列表
- 提升覆盖率的建议操作
用法
此技能会在 /speckit.implement 后自动运行。你也可以手动运行:
npx skills run implementation-verify
退出代码
| 代码 | 状态 | 含义 |
|---|---|---|
| 0 | 完成 | 100% 满足 |
| 1 | 部分完成 | 满足率 >80% |
| 2 | 较低 | 满足率 <80% |
| 3 | 错误 | 缺少必需文件 |
执行的检查
任务完成情况分析
- 解析 tasks.md 中的所有任务条目
- 统计已完成任务(标记为 [X] 或 [x])
- 计算各阶段的完成百分比
- 识别受阻或未完成的任务
FR 满足情况分析
- 从 spec.md 中提取所有 FR-XXX 引用
- 与已完成的任务进行交叉核对
- 找出没有对应已完成任务的 FR
- 计算满足率
契约实现情况(如果存在 contracts/)
- 解析契约文件中的端点定义
- 检查是否存在相应的实现
- 计算契约覆盖率
指标说明
| 指标 | 公式 | 说明 |
|---|---|---|
| FR 覆盖率 | 已实现 FR / FR 总数 | 已满足的要求 |
| 任务完成率 | 已完成任务 / 任务总数 | 工作进度 |
| 契约覆盖率 | 已实现端点 / 端点总数 | API 完整度 |
建议
覆盖率较低时:
- 查看未实现要求列表
- 检查受阻任务并解决阻碍
- 确保在 tasks.md 中正确标记任务完成状态
- 对剩余工作重新运行
/speckit.implement - 再次运行
implementation-verify,验证进度
评论
支持 Markdown