mcpField
I
implementation-verify

implementation-verify

github.com/drillan测试与质量361 次安装40 周前更新
代码仓库

关于 implementation-verify

implementation-verify 是一项在 `/speckit.implement` 后或手动运行的技能,用于核对实现是否符合规格。它根据 spec-kit 文件报告需求、任务和 API 契约覆盖情况及缺口。

主要功能

  1. 01FR 需求覆盖率
  2. 02任务完成百分比
  3. 03API 契约覆盖率
  4. 04未实现需求清单
  5. 05覆盖率改进建议

适用场景

  1. 01检查 `/speckit.implement` 后的工作
  2. 02查找没有对应已完成任务的需求
  3. 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错误缺少必需文件

执行的检查

任务完成情况分析
  1. 解析 tasks.md 中的所有任务条目
  2. 统计已完成任务(标记为 [X] 或 [x])
  3. 计算各阶段的完成百分比
  4. 识别受阻或未完成的任务
FR 满足情况分析
  1. 从 spec.md 中提取所有 FR-XXX 引用
  2. 与已完成的任务进行交叉核对
  3. 找出没有对应已完成任务的 FR
  4. 计算满足率
契约实现情况(如果存在 contracts/)
  1. 解析契约文件中的端点定义
  2. 检查是否存在相应的实现
  3. 计算契约覆盖率

指标说明

指标公式说明
FR 覆盖率已实现 FR / FR 总数已满足的要求
任务完成率已完成任务 / 任务总数工作进度
契约覆盖率已实现端点 / 端点总数API 完整度

建议

覆盖率较低时:

  1. 查看未实现要求列表
  2. 检查受阻任务并解决阻碍
  3. 确保在 tasks.md 中正确标记任务完成状态
  4. 对剩余工作重新运行 /speckit.implement
  5. 再次运行 implementation-verify,验证进度

评论

支持 Markdown