AgentSkillsCN

implementation-verify

通过检查需求达成率、任务完成情况以及合同履行情况,验证实施是否符合规范。生成一份包含覆盖率指标的履约报告。始终在 /speckit.implement 完成后运行。

SKILL.md
--- frontmatter
name: implementation-verify
description: >
  Verifies implementation against specifications by checking requirement fulfillment,
  task completion, and contract implementation. Generates a fulfillment report with
  coverage metrics. Always run after /speckit.implement completes.
version: 0.0.1
license: MIT
compatibility: Requires spec kit with check-prerequisites.sh, tasks.md must exist
metadata:
  author: drillan
  category: quality-gate
  repository: https://github.com/drillan/speckit-gates
  internal: true

implementation-verify

Verifies implementation against specifications after /speckit.implement completes.

Purpose

This skill automatically verifies that your implementation fulfills the specified requirements. It checks:

  • FR requirement fulfillment: How many FR-XXX requirements are addressed by completed tasks
  • Task completion rate: Percentage of tasks marked complete in tasks.md
  • Contract implementation: API endpoints implemented as specified (if contracts/ exists)
  • Test coverage alignment: Implementation aligns with test requirements

Output

The skill outputs a Fulfillment Report with:

  • Coverage metrics (FR, task, contract percentages)
  • List of unimplemented requirements
  • Recommended actions to improve coverage

Usage

This skill runs automatically after /speckit.implement. You can also run it manually:

bash
npx skills run implementation-verify

Exit Codes

CodeStatusMeaning
0Complete100% fulfillment
1Partial>80% fulfillment
2Low<80% fulfillment
3ErrorRequired files missing

Checks Performed

Task Completion Analysis

  1. Parse tasks.md for all task items
  2. Count completed tasks (marked with [X] or [x])
  3. Calculate completion percentage per phase
  4. Identify blocked or incomplete tasks

FR Fulfillment Analysis

  1. Extract all FR-XXX references from spec.md
  2. Cross-reference with completed tasks
  3. Identify FRs without corresponding completed tasks
  4. Calculate fulfillment percentage

Contract Implementation (if contracts/ exists)

  1. Parse contract files for endpoint definitions
  2. Check if corresponding implementation exists
  3. Calculate contract coverage percentage

Metrics Explained

MetricFormulaInterpretation
FR CoverageImplemented FRs / Total FRsRequirements addressed
Task CompletionCompleted Tasks / Total TasksWork progress
Contract CoverageImplemented Endpoints / Total EndpointsAPI completeness

Recommendations

After receiving low coverage:

  1. Review unimplemented requirements list
  2. Check for blocked tasks and resolve blockers
  3. Ensure task completion is properly marked in tasks.md
  4. Re-run /speckit.implement for remaining work
  5. Run implementation-verify again to verify progress