implementation-verify について
implementation-verifyは、`/speckit.implement`の完了後または手動実行で、実装が仕様を満たすか確認するスキルです。spec-kitのファイルを基に、要件やタスク、API契約のカバレッジと不足を報告します。
主な機能
- 01FR要件のカバレッジ
- 02タスク完了率
- 03API契約のカバレッジ
- 04未実装要件の一覧
- 05カバレッジ改善の提案
活用シーン
- 01`/speckit.implement`後の作業確認
- 02完了タスクに紐づかない要件の特定
- 03エンドポイント実装と契約の照合
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、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 対応