mcpField
S
sdd-verify

sdd-verify

github.com/fearovex-labsテスト・品質52 回インストール
リポジトリ

sdd-verify について

sdd-verify は、実装が仕様、設計、タスク計画に沿っているかを確認する Claude Code スキルです。修正は行わず結果を報告し、アーカイブ前の品質ゲートとして機能します。

主な機能

  1. 01仕様や計画に照らした実装確認
  2. 02解決されたテスト・ビルドコマンドの実行
  3. 03検証レポートの作成
  4. 04レポートをディスクに保存し、任意でEngramにも保存

活用シーン

  1. 01変更をアーカイブする前の検証
  2. 02レポートへのテスト・ビルド証拠の記録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/fearovex-labs/agent-config --skill sdd-verify

インストール後、Claude Code で/sdd-verifyを入力して読み込まれたか確認します。

同梱ファイルREPORT_TEMPLATE.md

詳細

sdd-verify

実装が仕様、設計、タスク計画に準拠しているかを検証します。アーカイブ前の品質ゲートです。

トリガー: /sdd-verify <change-name>、実装を検証、品質ゲート、変更を検証、sdd verify

目的

検証では、実装された内容が指定された要件を満たしているかを客観的に確認します。修正は行わず、報告のみを行います。

関連リファレンスファイル

  • REPORT_TEMPLATE.md — 保存用の簡潔な形式と、会話形式の詳細ブロックです。

スキルの解決

次の順に、プロジェクトローカルからグローバルへ解決します。

1. .claude/skills/sdd-verify/SKILL.md     (project-local — highest priority)
2. ~/.claude/skills/sdd-verify/SKILL.md   (global catalog — fallback)

アルゴリズム全体については、docs/SKILL-RESOLUTION.md を参照してください。

Claude の実行設定

以下のメモは、上記のツールに依存しないロジックを Claude Code ハーネスに紐付けます。これらは、ほかのツールには移植されない実行レイヤーです。

  • Step 0 の事前読み込み — skills/_shared/sdd-phase-common.md の Section F （プロジェクトコンテキストの読み込み）と Section G（仕様コンテキストの事前読み込み）に従います。どちらもブロッキングではありません。

  • 成果物の読み込み（Step 1） — ハーネスの Read("docs/sdd/{change-name}/<artifact>.md") ツールを使います。ディスク上にファイルがない場合（レガシーな変更）は、 mem_search(query: "sdd/{change-name}/<artifact>") → mem_get_observation(id) にフォールバックします。 どちらも存在せず Engram に到達できない場合は、オーケストレーターがインラインで渡します。

  • テスト／ビルドの実行（Steps 6–7） — 解決された各コマンドをハーネスの Bash ツールで実行し、終了コードと stdout/stderr を取得します。

  • 再利用／境界とエラーの提示（Steps 9.5–9.6） — ツールに依存しない「コンテンツ検索」はハーネスの Grep ツールに、「読み込み」は Read に解決されます。証拠ルールの相互参照先は、レガシーな行番号付きソースの SKILL.md:202-208 です。

  • 保存（Step 10） — まずディスクに保存します。Write("docs/sdd/{change-name}/verify-report.md", …) を使います。 次に、topic_key: sdd/{change-name}/verify-report、 type: architecture、project: {project} を指定し、content を "path: docs/sdd/{change-name}/verify-report.md\n\n{1-3 sentence summary}" として、ポインターと要約を mem_save で保存します。 Engram に到達できない場合も、ディスク上の成果物（信頼できる情報源）は書き込みます。Engram のポインター保存のみを省略します。

  • レシートの発行（Step 10.5） — ツールに依存しない「レビューのレシートを記録する」ステップは、レポートの書き込み後、Verdict が FAIL ではない場合に限り、リポジトリのルートから Bash を1回呼び出す処理に解決されます。

    node core/hooks/_shared/receipt-mint.js --minter sdd-verify --verdict <PASS|PASS_WITH_WARNINGS>

    --files を指定しない場合、現在ステージングされているパスが証明対象になります。ベストエフォートで実行します。終了コードがゼロ以外の場合、または「何も発行されなかった」というメッセージが表示された場合は、フェーズの要約に記載しますが、Verdict は変更しません。

  • オーケストレーターへの出力 — オーケストレーターが期待する JSON ブロックとして、ツールに依存しない Output Contract を返します。artifacts エントリーは、Engram のポインターが作成された場合、engram:sdd/{change-name}/verify-report に対応します。手動での次のステップは /sdd-archive <slug> です。

コメント

Markdown 対応