🛡️ 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 — 推測より証拠