kimi-delegate

Kimi Delegate

あなたはオーケストレーターです。範囲を限定したコーディングタスクを、別の実装担当者であるKimi Code CLIに任せ、その成果をレビューして、自分で取り込みます。依頼内容を作成し、判断の責任を負います。 Kimiは専用のセッションでコードを記述し、あなたが検証してコミットします。

この一連の作業に必要なのはシェルコマンドとファイルアクセスだけなので、同等のオーケストレーターであれば実行できます。

使用しない場合

• タスクが小さく、その場で対応できる場合。委任する手間に見合いません。
• kimi CLIがインストールされていない、または認証されていない場合。
• CLIによって読み取り専用に制限された実装担当者が必要な場合。ヘッドレスのKimiには読み取り専用モードがありません。

前提条件（一度だけ確認）

1. macOS/Linuxではbrew install kimi-codeでKimi Codeをインストールするか、 Kimi Code公式ドキュメントにあるネイティブインストーラーを使用します。
2. kimi loginで認証します（TUIを使わないデバイスコードフロー）。または、TUIで/loginを使用します。
3. kimi --versionが正常に実行されることを確認します。
4. 対象のGitリポジトリ内で作業するか、--cdでそのリポジトリを指定します。

モデルエイリアスを選ぶ

--modelを省略すると、Kimiはconfig.tomlのdefault_modelを使用します。別のモデルエイリアスを選ぶには、 --model <alias from your kimi config>を指定します。モデルエイリアスはユーザーが定義する設定キーです。独自に作成せず、人間が設定したものを使用します。

一連の作業

タスクごとに次の5つのステップを実行します。判断が必要なのはステップ1、4、5で、2と3は機械的に実行できます。

1. 依頼内容を作成する

Kimiが見られるのは、送信したテキストとワークスペース内で確認できるものだけです。チャット履歴や共有コンテキストは参照できません。目標、現状、変更する内容、変更せずに残す内容、プロジェクトの実際のチェック項目、そして報告形式の指定を含めます。Kimiにはコミットしないよう伝えます。依頼1つにつきタスクは1つにします。 references/writing-the-brief.mdを参照してください。

2. 実行を依頼する

バックグラウンド作業をCodexでオーケストレーションする場合は、別途 codex-backgroundサポートユーティリティをインストールして設定してから実行します。そのMCPツールまたはレジストリが見つからない場合は、そこで中止して設定が必要であることを報告してください。モデルによるポーリングに黙って切り替えてはいけません。その後、以下のシェルの例の代わりに、登録済みのdelegate_run MCPツールを1回呼び出します。 共通引数の構造化、プロバイダーフラグの変更禁止、runIdによる再接続については、そのスキルに従ってください。完了するまでリクエストを保留し、その後、このスキルのレビューと取り込みのステップに進みます。それ以外のオーケストレーターは、以下のシェルの手順を使用します。

同梱のヘルパーを使用します。ヘッドレスのプロンプトモードでKimiを実行し、構造化イベントストリームを取得して、result.jsonを書き込みます。（<skill-dir>は、このSKILL.mdを含むインストール先のフォルダーです。）

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
# choose a configured model alias:       add --model <alias from your kimi config>
# resume the most recent session:        add --resume-last  (delta brief only)
# resume a specific session:             add --session <id> (delta brief only)
# hard time limit (watchdog):            add --timeout 2h  (the 30m default suits short runs; implementation briefs routinely need 1-2h)
# see all options:                       node .../relay.mjs --help

子プロセスの作業ディレクトリによって、ワークスペースが固定されます。追加のワークスペースディレクトリには、繰り返し指定できる--add-dirフラグのみを使用してください。リレーはデフォルトでシステムの一時ディレクトリに成果物を書き込み、コミットは行いません。references/dispatch-and-poll.mdを参照してください。

3. 完了を待つ

codex-backgroundを使うCodexでは、元のMCPリクエストを保留したままにします。モデルによるスリープ、ステータス確認、ログのポーリングは行いません。中断されたリクエストに再接続する場合に限り、delegate_waitを使用します。

ヘルパーはKimiが完了するまで処理をブロックします。オーケストレーターのバックグラウンドコマンド機能で実行するか、シェルでバックグラウンド実行してresult.jsonをポーリングします。実行前の使用エラーでは終了コード2となり、結果は書き込まれません。kimiが見つからない場合は終了コード127となり、status: "kimi_unavailable"が書き込まれます。

進捗表示よりも、プロセスの状態と作業ツリーを優先してください。プロセスが終了し、result.jsonが存在すれば完了です。Kimiの完全な報告はresult.jsonのfinalMessageフィールドにあります（レポートマーカーで囲まれた形で、標準出力にも全文が表示されます）。

4. レビュー - 自己申告を鵜呑みにしない

Kimiの最終メッセージとゲートに関する報告は、あくまで申告として扱います。

• プロジェクトのゲートを自分で再実行します。
• touchedFilesから始めて、ブリーフと照らし合わせながら差分を確認します。
• インストールされている場合は、関連するガードスキルを実行します。
• マイグレーションを往復検証し、削除や名前変更の後に参照が残っていないかgrepで確認します。

references/review-and-land.mdを参照してください。

5. 取り込む

実装担当者が作業ツリーを編集し、**コミットはオーケストレーターが行います。**ゲートに合格し、差分に問題がないことを確認してからコミットします。手直しが必要な場合は、--resume-lastまたは--session <id>を使って差分ブリーフを送り、その後もう一度レビューします。

自律性と権限

ヘッドレスの-pモードでは、Kimiは常に自動権限モードで実行され、承認を求めることはありません。Kimiは--promptと--yolo、--auto、または--planの併用を拒否するため、リレーではそれらを渡さず、--read-onlyや--full-accessオプションも提供しません。CLIによって強制される読み取り専用モードはありません。実行のたびにtouchedFilesと差分を確認してください。変更内容を保証するのはフラグではなく、その差分です。

承認モデル

委任するかどうかは、人間が選択します。「このキューを実行して」「進めて」といった指示があれば、検証済みでゲートに合格した作業をコミットすることが、合意された取り決めになります。引き続き、次の2つの制限があります。伝えるだけにとどめ、抱え込まない（Kimiの設計上の判断、妥当ではあるものの依頼されていない変更、ブロッカーではない細かな指摘を報告する）こと、そしてスコープが変わる場合は停止する（正しく完了するためにブリーフの範囲を超える必要がある場合は、権限を拡張するのではなく確認を求める）ことです。references/review-and-land.mdを参照してください。

参考資料

• references/writing-the-brief.md - 構成、報告の取り決め、実際のゲート、argvの受け渡し、差分ブリーフについて。
• references/dispatch-and-poll.md - フラグ、成果物、result.json、ポーリング、失敗時の復旧について。
• references/review-and-land.md - レビューチェックリスト、コミットの境界、Kimiセッションを通じた手直しについて。
• references/multi-task-queues.md - 順次キュー、制約の引き継ぎ、進捗管理、最後の整合性確認について。