validate-counts について
validate-countsは、OrchestKitの正規ソース間でhook、スキル、エージェントの数が一致するかを確認するスキルです。ファイルシステムの集計をドキュメントやマニフェストと比較し、差異のファイルと項目を示します。
主な機能
- 01hook・スキル・エージェントの集計
- 02正規ソース間の数の比較
- 03差異があるファイルと項目の表示
- 04全件検証または集計のみの実行
活用シーン
- 01リリース前の件数整合性チェック
- 02マニフェストとドキュメントの差異特定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ yonatangross/ orchestkit --skill validate-countsインストール後、Claude Code で/validate-countsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
test-cases.jsonreferences/count-locations.mdrules/_sections.md_template.mddrift-reporting.mdsources-authoritative.mdscripts/count-all.shvalidate-counts.sh詳細
件数の検証
OrchestKit 内のすべての信頼できる情報源で、フック、スキル、エージェントの件数が一致しているかを確認します。比較表を出力し、差異があれば正確なファイル参照とともに示します。
クイックスタート
# Full validation: counts src/ vs CLAUDE.md and manifests (run from repo root)
bash src/skills/validate-counts/scripts/validate-counts.sh
# Just get raw counts from src/
bash src/skills/validate-counts/scripts/count-all.sh
ルール
| カテゴリー | ルール | 影響 | 主要なパターン |
|---|---|---|---|
| 件数の情報源 | rules/sources-authoritative.md(${CLAUDE_SKILL_DIR}/rules/sources-authoritative.md を読み込む) | HIGH | ファイルシステムを信頼できる情報源とし、派生元の情報を一致させる必要があります |
| 差異の検出 | rules/drift-reporting.md(${CLAUDE_SKILL_DIR}/rules/drift-reporting.md を読み込む) | HIGH | 比較表に加え、ファイル名とフィールドを参照して差異を示します |
合計:2 カテゴリーにわたる 2 つのルール
ワークフロー
- 完全な検証(件数と差異の比較)を行うには
scripts/validate-counts.shを実行し、件数のみを集計するにはscripts/count-all.shを実行します CLAUDE.mdを読み込み、Project Overview と Version セクションから件数を抽出しますmanifests/ork.jsonを読み込み、スキル、エージェント、フックの配列の長さを確認します- 比較表を作成します(形式については
rules/drift-reporting.mdを参照してください) - 不一致があればファイル名とフィールドを示します。一致している場合は「All counts consistent.」と出力します
参照資料
Read("${CLAUDE_SKILL_DIR}/references/<file>") で必要に応じて読み込みます。
| ファイル | 内容 |
|---|---|
count-locations.md | 各件数の記載場所と差異が生じる理由 |
関連スキル
release-checklist— リリースゲートのステップ 5 として validate-counts を使用しますdoctor— 件数の検証を含む、より広範なヘルスチェックを行いますaudit-skills— スキルの構造と完全性を対象とした品質監査を行います
よくある間違い
src/ではなくplugins/を基準に数える — ビルドが中断されると、plugins/ が空になっている場合があります- 削除済みのエイリアスマニフェストと比較する — v7 に存在するのは
manifests/ork.jsonのみです - フックの内訳を忘れる — グローバル、エージェントスコープ、スキルスコープの合計が総数と一致する必要があります
コメント
Markdown 対応