Delegate Worker

---
name: delegate-worker
description: Delegate a task to a worktree-worker agent running in an isolated git worktree. Use this skill when you want a sub-agent to implement code changes, fix bugs, or investigate errors in a separate worktree — keeping the main session clean. Trigger on phrases like "delegate this to a worker", "fix this in a worktree", "have a worker handle this", or when the user wants code changes done in isolation.
argument-hint: <task-description>
---

# ワーカーへのタスク委譲

隔離された git worktree 内で `worktree-worker` エージェントを起動し、バックグラウンドでタスクを処理させる。

## 引数

$ARGUMENTS

## ワークフロー

### 1. プロンプトを準備する

引数からワーカー用のプロンプトを組み立てる。以下を含める:

- **タスクの説明**: ワーカーが行うべき内容
- **タスクの種別**: 調査・分析のみ (コード変更なし) の場合、ワーカーが実装に踏み込まないよう、「report only, do not implement or commit」とプロンプトに明記する
- **Issue のコンテキスト** (Issue URL が提供された場合): `gh issue view` でタイトル・本文・URL を取得し、ワーカーが Issue をクローズする PR を作成できるよう含める
- **関連コンテキスト**: ユーザーが言及したファイルパス、エラーメッセージ、再現手順

### 2. ワーカーを起動する

```
Agent({
  name: "worker",
  subagent_type: "worktree-worker",
  isolation: "worktree",
  run_in_background: true,
  prompt: "<prepared prompt>\n\nIn your first report, include the absolute path of your worktree so the parent session can cd into it.\n\nSend your report to: main"
})
```

`Send your report to: main` — ここでの `main` は git ブランチではなく、**親セッション名** (トップレベルの Claude Code セッションのデフォルト名) を指す。ワーカーは SendMessage を呼ぶ際にこれを `to` フィールドとして使用する。

ワーカーはバックグラウンドで実行され、レポートや完了は自動的に通知される。**ポーリングや手動待機は不要** — 通知が届くまで他の作業を続けるか、待機する。

### 3. ワーカーの worktree に追随する

ワーカーが worktree のパスを報告したら、ユーザーがリアルタイムで変更を確認できるよう、親セッションをそこへ移動する (調査 only タスクでユーザーがコードを見る必要がなければ、このステップは省略してよい):

```
EnterWorktree({ path: "<worker's worktree absolute path>" })
```

注意事項:
- `name` ではなく `path` を渡すこと。これにより既存の worktree に入る (新規作成ではない)。
- この環境では worktree は `.claude/worktrees/` 配下ではなく、リポジトリ隣接ディレクトリ (例: `<project>-<branch>`) に作られる。`EnterWorktree` の `path` モードは `git worktree list` に登録されていれば入れるため、隣接パスでも問題なく追随できる。
- ワーカーのブランチがそこにチェックアウトされているため、ユーザーはすぐに変更後のコードを確認できる。ブランチ名は worktree-worker が自動採番する (`agent-<id>` 形式) ため、親セッションから事前に指定する必要はない。
- 後で元のディレクトリに戻るには: `ExitWorktree({ action: "keep" })`。worktree はワーカーが所有しているため `"keep"` を使うこと (`"remove"` は不可)。
- ユーザーが後から手動で出入りしたい場合は `/enter-worktree <branch>` / `/exit-worktree` スキルが使える。

### 4. コミュニケーション

- ワーカーは SendMessage で進捗を報告する。各レポートが届いたら確認する。
- 修正が必要であれば `SendMessage(to: "worker")` でフィードバックを伝える。
- 承認したら、ワーカーに成果物の提出 (コミット & プッシュ、ユーザーが PR を求めている場合や Issue が割り当てられている場合は PR) に進むよう指示する。
- ワーカーが完了を報告したら (最終レポート — 例: 「PR opened at ...」「commit pushed」、または調査タスクであれば「report ready」)、`SendMessage(to: "worker", message: {type: "shutdown_request"})` を送り、`ExitWorktree({ action: "keep" })` でセッションを元のディレクトリに戻す。PR のマージなど下流のイベントを待たず、ワーカーの成果物が出た時点でシャットダウンする。