mcpField
O
openspec-verify

openspec-verify

github.com/full-stack-skillsテスト・品質189 回インストール4 週間前に更新
リポジトリ

openspec-verify について

`/opsx:verify` を使い、実装が変更アーティファクトに沿っているか確認するスキルです。完全性、正確性、一貫性を評価し、重大度別に問題を報告します。

主な機能

  1. 01タスクと要件の網羅性を確認
  2. 02仕様の意図と実装を照合
  3. 03設計とコードの一貫性を確認
  4. 04重大度別に問題を分類

活用シーン

  1. 01タスク実装後の作業を検証
  2. 02変更をアーカイブする前に確認
  3. 03問題の修正後に再検証

インストール

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

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-verify

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

同梱ファイルagents/openai.yaml

詳細

OpenSpec Verify スキル

/opsx:verify を使用して、実装が変更アーティファクトと一致しているかを検証します。完全性、正確性、一貫性の3つの観点からチェックし、問題をCRITICAL、WARNING、SUGGESTIONに分類して報告します。

使用するタイミング

  • openspec-apply でタスクを実装した後、アーカイブする前。
  • ユーザーが「verify」「自分の作業を確認して」「実装を検証して」と言ったとき。
  • 変更をアーカイブする前の品質ゲートとして。

前提条件

  • タスクが実装済みであること（openspec-apply または手動のコーディングによる）。

ワークフロー

  1. 検証を実行する

    • /opsx:verify — 現在の変更、または推定された変更を検証します。
    • /opsx:verify <change-name> — 特定の変更を検証します。

  2. 3つの検証観点

    観点検証内容
    完全性すべてのタスクが完了しているか、すべての要件が実装されているか、シナリオが網羅されているか
    正確性実装が仕様の意図と一致しているか、エッジケースに対応しているか
    一貫性設計上の決定がコードに反映されているか、パターンに一貫性があるか

  3. レポートを確認する

    • CRITICAL：アーカイブする前に修正する必要があります。
    • WARNING：対処することを推奨します。アーカイブを妨げるものではありません。
    • SUGGESTION：任意の改善提案です。

  4. 必要に応じて問題を修正する

    • 重大な問題に対処し、必要に応じて警告も修正します。
    • /opsx:verify を再度実行して確認します。

出力

  • 問題を分類した検証レポート（CRITICAL / WARNING / SUGGESTION）。
  • アーカイブ可能かどうかの概要。

次のステップ

  • 準備ができている場合：openspec-archive を使用して変更をアーカイブします。
  • 問題が見つかった場合：コードまたはアーティファクトを修正してから、再検証します。

トラブルシューティング

  • 誤検知が多い場合：エージェントが規約を理解できるよう、openspec/config.yaml にプロジェクトのコンテキストを追加します。詳しくは openspec-config を参照してください。

参考資料

コメント

Markdown 対応