# はじめに

KstackはClaude Code向けのスキルパックで、K8sクラスターの監視、トラブルシューティング、監査タスクをスマートかつ効率的に実行できます。kstackがない場合、クラスターと通信するエージェントは通常 `kubectl` を直接呼び出します。これにはいくつかの欠点があります。

- 広範なクエリ（`kubectl get pods -A -o yaml`）は大量のYAMLをエージェントのコンテキストに引き込みます。これはトークンを消費し、攻撃者が制御可能な文字列（アノテーション、イベントメッセージ、ログ行）を指示と同じコンテキストに配置します。
- エージェントは決定論的ではないため、_「クラスターは正常か？」_ という質問への回答の形式が実行ごとに異なります。
- ホストエージェントのパーミッションプロンプトはシェルレベルです。コマンド実行前に確認を求めることができますが、`kubectl get pods` と `kubectl delete namespace` を区別しません。

kstackは、これらのタスクに対する直接的な `kubectl` の使用を固定されたスキルセットに置き換えます。スキルはスクリプトを呼び出して各タスクのデータを収集し、バルク結果をディスクにキャッシュして、エージェントにサマリーを返します。これにより、エージェントはレスポンスをより細かく制御でき、より安全でトークン効率的になり、フォローアップの質問にも素早く答えられるようになります。

---

## スキル

**監視**
* [`/cluster-status`](/ja/reference/skills/cluster-status) — ヘルススナップショット（Pod再起動、Nodeコンディション、リソース圧迫）
* [`/events`](/ja/reference/skills/events) — 重大度でランク付けされた最近のイベント

**トラブルシューティング**
* [`/investigate <resource>`](/ja/reference/skills/investigate) — イベント、ログ、関連リソースを横断した根本原因分析
* [`/logs`](/ja/reference/skills/logs) — 自然言語をログ取得・分析に変換する共有tmuxセッション（[Kubetail](https://github.com/kubetail-org/kubetail)経由）
* [`/metrics`](/ja/reference/skills/metrics) — Pod、Node、ワークロードのCPU・メモリ・その他リソースメトリクスの取得
* [`/exec <pod>`](/ja/reference/skills/exec) — Pod、Node、またはエフェメラルデバッグコンテナへの共有tmuxシェル

**監査**
* [`/audit-security`](/ja/reference/skills/audit-security) — RBAC、Podセキュリティポスチャー、権限の最小化
* [`/audit-network`](/ja/reference/skills/audit-network) — NetworkPolicy、Service、Ingress、GatewayAPI、DNS、暗号化チェック
* [`/audit-cost`](/ja/reference/skills/audit-cost) — リクエスト対使用量、過剰プロビジョニング、アイドルキャパシティ
* [`/audit-outdated`](/ja/reference/skills/audit-outdated) — 古いサービス、既知のCVE、利用可能なバージョンアップ

**その他**
* [`/cleanup`](/ja/reference/skills/cleanup) — クラスターからkstack所有リソースをすべて削除（デバッグコンテナ、Podクローン、ウォッチャー Job）
* [`/forget`](/ja/reference/skills/forget) — kstackのローカルキャッシュをクリアし、クラスターについて学習した内容を破棄

---

## 対応エージェント

スキルは普通のMarkdownファイルと付属のシェルスクリプトで構成されています。ブートストラップスクリプト（[https://kstack.sh/install](https://kstack.sh/install)）は `PATH` 上でサポート対象エージェントを検出し、それぞれにインストールします。対応エージェント：Claude Code、OpenAI Codex CLI、OpenCode、Cursor、Factory Droid、Slate、Kiro、Hermes。動作はエージェント間で同一であり、インストールパスのみ異なります。