delegate-worker

Stars8

Forks0

UpdatedJune 12, 2026 at 07:48

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.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

sasamuku

sasamuku/dotfiles

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

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 のマージなど下流のイベントを待たず、ワーカーの成果物が出た時点でシャットダウンする。

More from this repository

same repository

derive-optimal-solution

sasamuku/dotfiles

Generic thinking protocol for deriving optimal solutions through iterative self-checking. Invoke BEFORE searching within the given problem space whenever the user asks for advice, judgment, evaluation, or choice. Reframes the problem, generates options, evaluates trade-offs, runs a self-answer check (does this answer the user's actual question at the right granularity, reach upstream, match expectations, offer non-obvious value?), and loops back to upstream tracing or same-level reframing if the check fails — until convergence. Applies across any domain — technical, process, organizational, decision-making, career. Triggers when the user uses evaluation or reconsideration language ("which is best", "root cause", "is this really needed", "sustainable long-term", "ほんとうに", "そもそも", "最善は", "根本は", "筋が良い"), when validating the soundness of someone's proposal from multiple perspectives, when the problem spans multiple layers (tech / process / org / regulation / UX / cost), or when clear trade-offs exist.

2026-07-238

create-pr-with-review

sasamuku/dotfiles

Review the local diff with flat-perspective sub-agents, fix findings in a loop, then create a PR via the create-pr skill once the review is clean

2026-07-088

grilling

sasamuku/dotfiles

計画や設計について、ユーザーを徹底的に問い詰めて一緒に詰める。実装・着手の前に計画をストレステストしたいとき、または「詰めて」「グリルして」「問い詰めて」「ツッコんで」「設計レビューして」「ほんとうにこれでいい?」などのトリガー表現が出たときに必ず使う。

2026-06-228

create-rule

sasamuku/dotfiles

.claude/rules/ 配下のルールファイル (*.md) を新規作成・編集するときに、適切なメカニズム選択と paths スコープを保証する。ルールを書く前・書いた後に必ず適用する。

2026-06-228

orchestrate-epic

sasamuku/dotfiles

Orchestrate Epic issue as team leader. Delegate sub-issues to member agents in isolated worktrees. Members run in background and communicate via SendMessage.

2026-06-188

read-issue

sasamuku/dotfiles

Fetch a GitHub issue with its sub-issues, walk up to the parent Epic, list sibling issues under that Epic, fetch the body of each sibling issue, attach the implementing PR for each closed sibling with body and diff summary, gather related code, and present as a Japanese summary so the reader can grasp the whole task context including the actual contents of siblings and their PRs

2026-06-188

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"
})

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

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 のマージなど下流のイベントを待たず、ワーカーの成果物が出た時点でシャットダウンする。