10日で覚えるKiro CLIDay 10: 設定・ACP・実践ワークフロー
books.chapter 1010日で覚えるKiro CLI

設定管理

Kiro CLI は豊富な設定オプションを提供しています。設定を理解して使いこなすことで、開発体験を大きく向上させられます。

設定の操作

# 設定ファイルをエディタで開く
kiro-cli settings open

# 設定一覧を表示
kiro-cli settings list

# すべての設定（デフォルト含む）を表示
kiro-cli settings list --all

# 特定の設定を取得
kiro-cli settings chat.defaultModel

# 設定を変更
kiro-cli settings chat.defaultModel claude-sonnet-4.5

# 設定を削除（デフォルトに戻す）
kiro-cli settings --delete chat.defaultModel

設定ファイルの場所：

  • macOS: ~/.kiro/settings.json
  • Linux: ~/.config/kiro/settings.json

主要な設定カテゴリ

チャットインターフェース

設定 説明 デフォルト
chat.defaultModel デフォルトAIモデル auto
chat.defaultAgent デフォルトエージェント —
chat.diffTool 外部差分ツール —
chat.greeting.enabled 起動時のグリーティング表示 true
chat.editMode 編集モード false
chat.enableNotifications デスクトップ通知 false
chat.disableMarkdownRendering マークダウンレンダリング無効化 false
chat.disableAutoCompaction 自動圧縮の無効化 false

ナレッジベース

設定 説明
chat.enableKnowledge ナレッジベース機能の有効/無効
knowledge.defaultIncludePatterns デフォルトの含むパターン
knowledge.defaultExcludePatterns デフォルトの除外パターン
knowledge.maxFiles インデックスの最大ファイル数
knowledge.chunkSize テキストチャンクサイズ
knowledge.indexType デフォルトインデックスタイプ

キーバインド

設定 説明
chat.skimCommandKey ファジー検索キー
chat.autocompletionKey 補完受け入れキー
chat.tangentModeKey タンジェントモードキー
chat.delegateModeKey デリゲートキー

機能トグル

設定 説明
chat.enableThinking Thinking ツールの有効化
chat.enableTangentMode タンジェントモード
chat.enableTodoList TODO リスト
chat.enableCheckpoint チェックポイント
chat.enableDelegate デリゲート

テレメトリ

設定 説明
telemetry.enabled テレメトリ収集の有効/無効

環境変数

変数 説明
KIRO_LOG_LEVEL ログレベル（error, warn, info, debug, trace）
KIRO_LOG_NO_COLOR ログの色を無効化（1 で無効）

実験的機能

Kiro CLI には開発中の実験的機能が含まれています。/experiment コマンドでトグルできます。

Tangent Mode（タンジェントモード）

メインの会話を中断せずに、脇道のトピックを探索できます。

> /tangent

または Ctrl+T で切り替え。元の会話に戻るには、再度 /tangent を実行します。

TODO Lists

タスクを管理するリスト機能です。

> /todos add ユニットテストを書く
> /todos add APIドキュメントを更新
> /todos complete 1

Thinking Tool

AIの推論プロセスをステップバイステップで可視化します。複雑な問題のデバッグや学習に有用です。

kiro-cli settings chat.enableThinking true

Checkpointing

セッション中のファイル変更をスナップショットとして保存し、復元できます。

> /checkpoint init        # チェックポイント初期化
> /checkpoint list        # 一覧表示
> /checkpoint diff 1      # 変更内容の確認
> /checkpoint restore 1   # 特定の時点に復元

Git リポジトリ内では自動的に有効化されます。

Context Usage Indicator

コンテキストウィンドウの使用率をパーセンテージと色で表示します。

kiro-cli settings chat.enableContextUsageIndicator true

Agent Client Protocol (ACP)

ACP は、AIエージェントとエディタの通信を標準化するオープンプロトコルです。Language Server Protocol (LSP) がエディタと言語サーバーの通信を標準化したように、ACP はエディタとAIエージェントの通信を標準化します。

ACP の概要

flowchart LR
    subgraph Editors["エディタ"]
        JB["JetBrains IDE"]
        Zed["Zed"]
        Other["その他のエディタ"]
    end
    subgraph ACP["ACP プロトコル"]
        JSONRPC["JSON-RPC 2.0<br/>stdin/stdout"]
    end
    subgraph Agent["Kiro CLI"]
        AI["AI エージェント"]
    end
    JB <--> JSONRPC
    Zed <--> JSONRPC
    Other <--> JSONRPC
    JSONRPC <--> AI
    style Editors fill:#3b82f6,color:#fff
    style ACP fill:#8b5cf6,color:#fff
    style Agent fill:#22c55e,color:#fff

ACP の起動

# デフォルトエージェントで起動
kiro-cli acp

# 特定のエージェントを指定
kiro-cli acp --agent my-agent

JetBrains IDE の設定

~/.jetbrains/acp.json を作成します。

{
  "command": "/path/to/kiro-cli",
  "args": ["acp"]
}

Zed の設定

~/.config/zed/settings.json に追加します。

{
  "assistant": {
    "version": "2",
    "default_model": {
      "provider": "custom",
      "model": "kiro"
    }
  },
  "language_models": {
    "custom": [
      {
        "name": "kiro",
        "type": "custom",
        "command": "/path/to/kiro-cli",
        "args": ["acp"]
      }
    ]
  }
}

ACP メソッド

メソッド 説明
initialize ケイパビリティの交換
session/new 新規セッションの作成
session/load 既存セッションのロード
session/prompt プロンプトの送信
session/cancel 操作のキャンセル
session/set_mode エージェントモードの切替
session/set_model モデルの変更

セッションストレージ

ACP セッションは ~/.kiro/sessions/cli/ に永続化されます。メタデータとイベントログが保存されます。

実践ワークフロー

コードレビュー自動化

# PR の差分をレビュー
git diff main...HEAD | kiro-cli chat --no-interactive \
  --agent code-reviewer \
  "このPRの変更をレビューしてください。セキュリティ、パフォーマンス、コード品質の観点から分析してください。"

ビルドエラーの自動修正

# ビルドエラーを渡して修正
npm run build 2>&1 | kiro-cli chat --trust-tools "read,write" \
  "このビルドエラーを修正してください"

ドキュメント生成

# APIドキュメントの自動生成
kiro-cli --agent docs-writer \
  "src/api/ のすべてのエンドポイントのAPIドキュメントを生成してください"

チーム共有の開発環境

プロジェクトに以下のファイルを配置してリポジトリに含めます。

.kiro/
├── agents/
│   ├── project-dev.json     # プロジェクト固有エージェント
│   └── code-reviewer.json   # コードレビューエージェント
├── steering/
│   ├── product.md           # プロダクト情報
│   ├── tech.md              # 技術スタック
│   ├── structure.md         # プロジェクト構造
│   └── api-standards.md     # API 規約
├── settings/
│   └── mcp.json             # MCP サーバー設定
└── hooks/                    # フック定義（参考用）

チームメンバーがリポジトリをクローンするだけで、同じ開発環境が整います。

CI/CD パイプラインへの統合

# GitHub Actions の例
- name: Code Review
  run: |
    git diff ${{ github.event.pull_request.base.sha }}..HEAD \
    | kiro-cli chat --no-interactive --trust-all-tools \
      --agent code-reviewer \
      "このPRをレビューしてください"

10日間の総まとめ

flowchart TB
    subgraph Foundation["基礎（Day 1-3）"]
        D1["Day 1: インストール<br/>認証・基本操作"]
        D2["Day 2: チャット<br/>モデル選択"]
        D3["Day 3: セッション<br/>Translate・Autocomplete"]
    end
    subgraph Agents["エージェント（Day 4-5）"]
        D4["Day 4: エージェント入門<br/>設定ファイル構造"]
        D5["Day 5: エージェント実践<br/>toolsSettings・実例"]
    end
    subgraph Intelligence["インテリジェンス（Day 6）"]
        D6["Day 6: コードインテリジェンス<br/>Tree-sitter・LSP"]
    end
    subgraph Context["コンテキスト（Day 7-8）"]
        D7["Day 7: ステアリング<br/>コンテキスト管理"]
        D8["Day 8: MCP連携<br/>ナレッジ管理"]
    end
    subgraph Advanced["応用（Day 9-10）"]
        D9["Day 9: Hooks<br/>サブエージェント"]
        D10["Day 10: 設定・ACP<br/>実践ワークフロー"]
    end
    Foundation --> Agents
    Agents --> Intelligence
    Intelligence --> Context
    Context --> Advanced
    style Foundation fill:#3b82f6,color:#fff
    style Agents fill:#8b5cf6,color:#fff
    style Intelligence fill:#22c55e,color:#fff
    style Context fill:#f59e0b,color:#fff
    style Advanced fill:#ef4444,color:#fff

知識の体系

分野 学んだこと
基礎 インストール、認証、チャット、セッション管理、Translate、Autocomplete
エージェント 設定ファイル、tools/allowedTools、toolsSettings、resources、MCP連携
コード理解 Tree-sitter、LSP統合、パターン検索/リライト
コンテキスト ステアリングファイル、4つのコンテキスト手法、ナレッジベース
自動化 5つのHookタイプ、サブエージェント、Delegate
連携 ACP、エディタ統合、CI/CD統合、チーム共有

推奨する開発フロー

  1. プロジェクト設定: ステアリングファイルを作成 → エージェントを設定 → MCP サーバーを追加
  2. 日常開発: kiro-cli --agent project-dev で起動 → 自然言語で指示 → Hook が自動検証
  3. レビュー: git diff | kiro-cli --agent code-reviewer で PR をレビュー
  4. チーム共有: .kiro/ ディレクトリをリポジトリにコミット

トラブルシューティング

共通の問題

問題 対処法
インストール失敗 kiro-cli doctor --all で診断
認証エラー kiro-cli login で再ログイン
MCP 接続エラー kiro-cli mcp status --name <name> で状態確認
Hook が動かない matcher パターンとトリガーを確認
レスポンスが遅い ステアリングファイルを最適化、未使用 MCP を無効化
コンテキスト超過 /compact で圧縮、ナレッジベースに移行

診断コマンド

# 環境診断
kiro-cli doctor --all

# 詳細な診断レポート
kiro-cli diagnostic --format json

# バグ報告
kiro-cli issue

# 診断ログ（MCP含む）
# チャット内で:
> /logdump --mcp

次のステップ

  • 公式ドキュメント: https://kiro.dev/docs/cli/
  • 変更履歴: kiro-cli version --changelog
  • コミュニティ: Kiro Discord サーバー
  • 実践: 実際のプロジェクトでエージェントを作成し、ステアリングを設定して活用する

ターミナルからAIエージェントを操る力を手に入れました。Kiro CLI を使って、効率的で楽しい開発体験をお過ごしください。