Community研究&データ分析github.com

VoDaiLocz/kilo-kit-mcp

安全なコーディングエージェントのためのMCPサーバー:スキルルーティング、C4ワークフローゲート、メモリチェック、完了前の検証を提供します。

kilo-kit-mcp とは?

Kilo-Kit Core Skillは、AIコーディングエージェント(Claude Code、Cursorなど)向けに設計された、証拠に基づく安全なワークフローを強制するMCPサーバースキルです。主な機能として、(1) すべてのタスク開始前にシステムとコードベースのスキャンを必須とする「ハードゲート」、(2) 「証拠なしに行動しない」「スキャンしてから話す」「検証してから完了を主張する」など7つの不変ルールからなる「鉄則」を提供します。このスキルは、システムリソースの確認、コードベース構造の読み取り、コンテキストの検証を経てからでなければエージェントが実行に進むことを許可しません。また、適応型ディスパッチによりタスクの意図に基づいて適切なサブスキル(デバッグ、コードレビュー、テスト、セキュリティなど)にルーティングします。すべての決定は意思決定監査証跡に記録され、違反が発生した場合は即座に実行を停止してユーザーに報告します。

対応~Claude Code~Codex CLI~Cursor
npx skills add VoDaiLocz/kilo-kit-mcp

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

🛡️ Kilo-Kit コアスキル — ハードゲート&鉄則

哲学: 「推測より証拠」 — 検証された証拠なしにエージェントは行動しません。

使用タイミング

このスキルは以下の場合に使用します:

  • 新しいタスクやユーザーリクエストを開始するとき
  • アーキテクチャやコードの変更を提案するとき
  • バグやパフォーマンス問題を診断するとき
  • 本番システムに影響を与える決定を行うとき

このスキルを使用しない場合:

  • 記憶から簡単な事実の質問に答えるとき
  • ロジックに影響のないフォーマットやスタイルのみの変更

前提条件

このスキルを使用する前に、以下を確認してください:

  • プロジェクトコードベースへのアクセスが利用可能であること
  • システムリソースチェック(ディスク、メモリ、プロセス)が実行可能であること
  • 関連するログやエラー出力がアクセス可能であること

⛔ ハードゲート — 必須システムスキャン

ルール: AIエージェントは、解決策を提案する前にシステムとコードベースをスキャンしなければなりません。 ハードゲートを通過できない場合、エージェントは実行に進むことはできません。

ハードゲートチェックリスト

hard_gate:
  system_scan:
    - [ ] 利用可能なディスク容量を確認
    - [ ] 実行中のプロセスとリソース使用状況を確認
    - [ ] ランタイムバージョンを確認(Node、Python、.NETなど)
    - [ ] 必要に応じてネットワーク/サービスの可用性を確認

  codebase_scan:
    - [ ] プロジェクト構造を読む(トップレベルディレクトリ)
    - [ ] 現在のタックに関連するファイルを特定
    - [ ] 変更領域に関連する既存のテストを確認
    - [ ] 影響を受けるファイルのコンテキストを確認するために最近のgit履歴を確認

  context_validation:
    - [ ] ユーザーの意図の理解を確認
    - [ ] タスクの範囲がリクエストと一致することを確認
    - [ ] 影響を受ける可能性のある依存関係を特定

ハードゲート判定

IF all_checks_passed:
    → 実行に進む
ELSE:
    → 停止し、失敗したチェックを報告
    → 不足情報やアクセスを要求
    → 解決後にハードゲートを再実行

🔒 鉄則 — 不変ルール

これらのルールは絶対的であり、いかなる状況でもオーバーライドできません。

七つの鉄則

#法則説明
1証拠なしに行動しないすべての提案変更は、特定のファイル、行、または出力を証拠として引用しなければなりません。
2話す前にスキャンする推奨を行う前にシステムとコードベースのスキャンを実行します。
3主張する前に検証する検証(テスト、ビルド、手動チェック)を実行せずにタスク完了を主張してはいけません。
4最小限の影響範囲問題を解決する最小の変更を行います。不要な修正を避けます。
5動作しているものを維持するタスクで直接必要とされない限り、動作中のコードを削除または変更してはいけません。
6すべての決定を追跡する各決定の背後にある推論を決定監査証跡に記録します。
7大きな失敗、迅速な回復何かが失敗した場合、完全なコンテキストとともに即座に報告します。エラーを隠してはいけません。

鉄則の執行

enforcement:
  violation_response:
    - 違反を決定監査証跡に記録
    - 現在の実行を停止
    - ハードゲートフェーズに戻る
    - 違反をユーザーに報告

  no_exceptions:
    - タスクの緊急性は鉄則をオーバーライドしません
    - ユーザーリクエストは鉄則をオーバーライドしません
    - パフォーマンスのプレッシャーは鉄則オーバーライドしません

🔀 プロセスフロー

メイン処理フロー

digraph kilo_kit_flow {
    rankdir=TB;
    node [shape=box, style="rounded,filled", fontname="Helvetica"];

    start [label="ユーザーリクエスト", shape=oval, fillcolor="#E8F5E9"];
    hard_gate [label="⛔ ハードゲート\nシステム&コードベーススキャン", fillcolor="#FFCDD2"];
    gate_check [label="すべてのチェック\nに合格?", shape=diamond, fillcolor="#FFF9C4"];
    halt [label="停止\n不足情報を報告", fillcolor="#FFCDD2"];
    iron_law [label="🔒 鉄則\nルールに対する検証", fillcolor="#E3F2FD"];
    route [label="スキルにルーティング\n(適応型ディスパッチ)", fillcolor="#F3E5F5"];
    execute [label="実行\n行動チェーン", fillcolor="#E8F5E9"];
    verify [label="結果を検証\n(品質ゲート)", fillcolor="#FFF9C4"];
    verified [label="検証済み?", shape=diamond, fillcolor="#FFF9C4"];
    learn [label="学習してログ\n(決定監査証跡)", fillcolor="#E3F2FD"];
    done [label="完了", shape=oval, fillcolor="#E8F5E9"];

    start -> hard_gate;
    hard_gate -> gate_check;
    gate_check -> iron_law [label="はい"];
    gate_check -> halt [label="いいえ"];
    halt -> hard_gate [label="再試行"];
    iron_law -> route;
    route -> execute;
    execute -> verify;
    verify -> verified;
    verified -> learn [label="合格"];
    verified -> execute [label="不合格\n(修正して再試行)"];
    learn -> done;
}

スキルディスパッチフロー

digraph skill_dispatch {
    rankdir=LR;
    node [shape=box, style="rounded,filled", fontname="Helvetica"];

    intent [label="意図とキーワード\nを解析", fillcolor="#E3F2FD"];
    score [label="スキルをスコア\n(0.0–1.0)", fillcolor="#F3E5F5"];
    select [label="プライマリスキル\nを選択", fillcolor="#E8F5E9"];

    debug [label="デバッグ/\n系統的", fillcolor="#FFF9C4"];
    root [label="デバッグ/\n根本原因", fillcolor="#FFF9C4"];
    verify [label="デバッグ/\n検証", fillcolor="#FFF9C4"];
    review [label="品質/\nコードレビュー", fillcolor="#FFF9C4"];
    test [label="品質/\nテスト", fillcolor="#FFF9C4"];
    sec [label="開発/\nセキュリティ", fillcolor="#FFF9C4"];
    back [label="開発/\nバックエンド", fillcolor="#FFF9C4"];

    intent -> score -> select;
    select -> debug [label="バグ、エラー"];
    select -> root [label="根本原因、なぜ"];
    select -> verify [label="検証、確認"];
    select -> review [label="レビュー、PR"];
    select -> test [label="テスト、TDD"];
    select -> sec [label="セキュリティ、認証"];
    select -> back [label="API、バックエンド"];
}

ハードゲートスキャンフロー

digraph hard_gate_scan {
    rankdir=TB;
    node [shape=box, style="rounded,filled", fontname="Helvetica"];

    start [label="ハードゲート開始", shape=oval, fillcolor="#E8F5E9"];
    sys [label="システムスキャン\n(ディスク、メモリ、ランタイム)", fillcolor="#FFCDD2"];
    code [label="コードベーススキャン\n(構造、ファイル、テスト)", fillcolor="#FFCDD2"];
    ctx [label="コンテキスト検証\n(意図、範囲、依存関係)", fillcolor="#FFCDD2"];
    check [label="すべて合格?", shape=diamond, fillcolor="#FFF9C4"];
    pass [label="✅ ゲートオープン\n続行", fillcolor="#E8F5E9"];
    fail [label="❌ ゲートブロック\n報告して再試行", fillcolor="#FFCDD2"];

    start -> sys -> code -> ctx -> check;
    check -> pass [label="はい"];
    check -> fail [label="いいえ"];
    fail -> start [label="解決後"];
}

ガイドライン

DO ✅

  • タスクを開始する前に必ずハードゲートチェックを実行する
  • すべての推奨に具体的な証拠(ファイルパス、行番号、コマンド出力)を引用する
  • 問題を解決する最小の変更を使用する
  • すべての決定を決定監査証跡に記録する
  • 完了を主張する前に結果を検証する

DON'T ❌

  • タスクの緊急性に関わらず、システムまたはコードベースのスキャンをスキップする
  • 実際のコードを確認せずに解決策を推測する
  • タスクに関係のないファイルに変更を加える
  • 検証を実行せずに完了を主張する
  • いかなる理由でも鉄則をオーバーライドする

一般的なパターン

パターン1: 事前証拠収集

いつ: 新しいタスクを開始するとき。

アクション: ハードゲートスキャンシーケンスを実行します。

# システムスキャン
df -h                          # ディスク容量
free -m                        # メモリ
node --version && python3 --version  # ランタイム

# コードベーススキャン
find . -maxdepth 2 -type f | head -50  # プロジェクト構造
git log --oneline -10                   # 最近の変更

パターン2: 証拠に基づく推奨

いつ: コード変更を提案するとき。

アクション: 常に具体的な証拠を含めます。

## 推奨
`src/auth/login.ts:42` を、直接の文字列連結からパラメータ化クエリに変更します。

**証拠:**
- ファイル: `src/auth/login.ts`、42行目
- 現在のコード: `db.query("SELECT * FROM users WHERE email = '" + email + "'")`
- リスク: SQLインジェクション(OWASP A03:2021)
- テスト: `tests/auth/login.test.ts` — インジェクションテストが存在しません

アンチパターン(避けるべき)

アンチパターン1: 盲目的な推奨

問題: 実際のコードを読まずに変更を提案すること。

代わりに: 常に関連ファイルを読み、推奨する前に特定の行を引用してください。

アンチパターン2: ゲートをスキップする

問題: タスクが単純に見えるために実行を急ぐこと。

代わりに: タスクの複雑さに関わらず、ハードゲートスキャンを実行してください。

アンチパターン3: 目に見えない推論

問題: 推論を文書化せずに決定を行うこと。

代わりに: すべての決定を証拠と検討した代替案とともに記録してください。


エラーハンドリング

エラータイプ原因解決策
ハードゲート失敗システムアクセスまたは情報の欠如失敗したチェックを報告; アクセスを要求
鉄則違反証拠なしに行動を試みる停止、ハードゲートに戻る、違反を記録
スキルミスマッチタスクに間違ったスキルが選択された適応型ディスパッチで再ルーティング
検証失敗変更が品質ゲートを通過しない問題を修正し、検証を再実行

成功基準

完了を主張する前に、以下を確認:

  • ハードゲートスキャンが実行され、合格した
  • タスク全体で全ての鉄則が守られた
  • すべての推奨が具体的な証拠を引用している
  • 変更は最小限でタスクに集中している
  • 検証(テスト、ビルド、手動チェック)に合格した
  • 決定監査証跡が完全である
  • ユーザーリクエストが完全に処理された

参考資料

  • references/patterns.md - 証拠に基づくワークフローの再利用可能なパターン
  • references/performance-benchmarks.md - システムおよびコードベーススキャンのベンチマーク
  • references/output-formats.md - 標準出力フォーマットの定義

関連スキル

  • skills/kilo-kit/debugging/systematic/ - 系統的なバグ診断用
  • skills/kilo-kit/debugging/root-cause/ - 深い根本原因分析用
  • skills/kilo-kit/debugging/verification/ - 修正の検証用
  • skills/kilo-kit/quality/code-review/ - コードレビューワークフロー用
  • skills/kilo-kit/quality/testing/ - テスト駆動開発用
  • skills/kilo-kit/development/security/ - セキュリティベストプラクティス用
  • skills/kilo-kit/development/backend/ - バックエンド開発用

フィードバック統合

このスキルが:

成功した場合:

  • 最も価値のあったハードゲートチェックを記録
  • 鉄則がどのような間違いを防いだかをメモ
  • 最もうまく機能した証拠パターンをログ

成功しなかった場合:

  • 不十分だったチェックを文書化
  • ハードゲートチェックリストのギャップを特定
  • スキル改善のフラグを立てる

Kilo-Kit コアスキル v1.0.0 — 推測より証拠

関連スキル