validate について
validateは、仕様、ファイル、実装との差分、ガバナンス、比較などを検証するスキルです。専門エージェントに並行して確認を委任し、実行可能な指摘を重要度とカテゴリ別に整理します。
主な機能
- 016種類の検証モード
- 02専門エージェントによる並行チェック
- 03指摘へのファイル名と行番号の付与
- 04実行可能な推奨事項
- 05指摘の重複排除と重要度順の整理
活用シーン
- 01仕様書やファイルのレビュー
- 02仕様と実装の差分確認
- 03憲章やガバナンス規則への適合評価
- 042つの情報源の比較
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ rsmdt/ the-startup --skill validateインストール後、Claude Code で/validateを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
examples/output-example.mdreference/3cs-framework.mdambiguity-detection.mdconstitution-validation.mddrift-detection.mdoutput-format.mdperspectives.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. 指摘事項の統合
指摘事項を処理します。
- 場所が近いもの(5 行以内)を重複としてまとめ、最も高い重要度を維持しながら、補足し合う詳細を統合します。
- 重要度の高い順に並べます。
- カテゴリ別に分類します。
モード別の統合:
- ドリフト: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 フェーズでアーキテクチャとの整合性を確認します