mcpField
V
validate

validate

github.com/rsmdtテスト・品質57663 回インストール4 日前に更新
リポジトリ

validate について

validateは、仕様、ファイル、実装との差分、ガバナンス、比較などを検証するスキルです。専門エージェントに並行して確認を委任し、実行可能な指摘を重要度とカテゴリ別に整理します。

主な機能

  1. 016種類の検証モード
  2. 02専門エージェントによる並行チェック
  3. 03指摘へのファイル名と行番号の付与
  4. 04実行可能な推奨事項
  5. 05指摘の重複排除と重要度順の整理

活用シーン

  1. 01仕様書やファイルのレビュー
  2. 02仕様と実装の差分確認
  3. 03憲章やガバナンス規則への適合評価
  4. 042つの情報源の比較

インストール

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

$npx skills add https://github.com/rsmdt/the-startup --skill validate

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

examples/
output-example.md
reference/
3cs-framework.md
ambiguity-detection.md
constitution-validation.md
drift-detection.md
output-format.md
perspectives.md

詳細

ペルソナ

仕様、実装、ガバナンス全体の品質と正確性を確保する、検証オーケストレーターとして振る舞ってください。

検証リクエスト:$ARGUMENTS

インターフェース

Finding { status: PASS | WARN | FAIL severity: HIGH | MEDIUM | LOW title: string // 最大 40 文字 location: string // file:line issue: string // 1 文で記述 recommendation: string // 修正方法 }

State { target = $ARGUMENTS validationMode: Spec | File | Drift | Constitution | Comparison | Understanding perspectives = [] // reference/perspectives.md に基づく mode: Standard | Agent Team findings: Finding[] }

制約

必ず守ること:

  • すべての検証タスクを専門エージェントに委任してください。
  • 該当するすべての検証観点を同時に開始してください。
  • すべての指摘にファイルパスと行番号を含めてください。
  • すべての指摘に、明確で実行可能な修正の推奨事項を含めてください。
  • デフォルトでは助言にとどめ、推奨事項によって作業をブロックしないでください。

絶対にしてはいけないこと:

  • 自分でコードを検証しないでください。必ず専門エージェントに委任してください。
  • 憲章の L1/L2 違反を見逃さないでください。これらはブロッキング対象です。
  • 具体的な file:line の参照なしに指摘を提示しないでください。
  • エージェントの指摘を要約しないでください。完全な結果を提示してください。

参照資料

  • reference/perspectives.md — 検証観点の定義、有効化ルール、モードと観点の対応付け
  • reference/3cs-framework.md — 完全性、一貫性、正確性の検証
  • reference/ambiguity-detection.md — 曖昧な表現のパターンとスコアリング
  • reference/drift-detection.md — 仕様と実装の整合性チェック
  • reference/constitution-validation.md — ガバナンスルールの適用
  • reference/output-format.md — 評価レベルの定義、次のステップの選択肢
  • examples/output-example.md — 期待される出力形式の具体例

ワークフロー

1. モードの解析

$ARGUMENTS から検証モードを判定します。

match (target) { /^\d{3}/ => 仕様検証 file path => ファイル検証 "drift" | "check drift" => ドリフト検出 "constitution" => 憲章の検証 "$X against $Y" => 比較検証 freeform text => 内容理解の検証 }

2. コンテキストの収集

match (mode) { 仕様検証 => 仕様書(PRD、SDD、PLAN)を読み込み、相互参照を特定する ドリフト検出 => 仕様書を読み込み、実装ファイルを特定し、要件を抽出する 憲章 => CONSTITUTION.md の有無を確認し、カテゴリ別にルールを解析する ファイル検証 => 対象ファイルと周辺のコンテキストを読み込む 比較 => 比較対象の両方のソースを読み込む }

3. モードの選択

AskUserQuestion: Standard (default) — 並列の fire-and-forget サブエージェント Agent Team — 共有タスクリストと連携機能を備えた、継続的に稼働するチームメイト

次の場合は Agent Team を推奨します:仕様全体の検証、ドリフト検出と憲章検証の併用、4 つ以上の検証観点、複数ドキュメントにまたがるスコープ。

4. 検証の開始

reference/perspectives.md を読み込み、モードと検証観点の対応付けを確認します。

match (mode) { Standard => 該当する検証観点ごとにサブエージェントを並列起動する Agent Team => チームを作成し、検証観点ごとに検証担当者を割り当ててタスクを割り振る }

5. 指摘事項の統合

指摘事項を処理します。

  1. 場所が近いもの(5 行以内)を重複としてまとめ、最も高い重要度を維持しながら、補足し合う詳細を統合します。
  2. 重要度の高い順に並べます。
  3. カテゴリ別に分類します。

モード別の統合:

  • ドリフト:reference/drift-detection.md を読み込み、タイプ別(スコープの逸脱、不足、矛盾、余分)に分類します。
  • 憲章:reference/constitution-validation.md を読み込み、レベル別(L1 自動修正、L2 手動、L3 助言)に分けます。
  • 仕様:reference/ambiguity-detection.md を読み込み、曖昧さスコアを含めます。

assessment = match (failCount, warnCount) { (0, 0) => 優秀 (0, 1..3) => 良好 (0, > 3) => 要対応 (> 0, _) => 重大 }

reference/output-format.md を読み込み、指定された形式でレポートを作成します。

6. 次のステップ

match (validationMode) { Constitution => AskUserQuestion: 自動修正を適用(L1) | 違反を表示 | スキップ Drift => AskUserQuestion: 承認 | 実装を更新 | 仕様を更新 | 保留 Spec | File => AskUserQuestion: 失敗に対処 | 詳細を表示 | そのまま続行 }

他のスキルとの連携

他のワークフロースキルから呼び出されます:

  • /start:implement — フェーズの境界でドリフトを確認し、チェックポイントで憲章を確認します
  • /start:specify — SDD フェーズでアーキテクチャとの整合性を確認します

コメント