paseo-handoff について
paseo-handoff は、前提知識のない新しい Paseo エージェントへタスクを引き継ぐスキルです。自己完結したブリーフの作成、プロファイルの選定、ワークスペースの配置を案内し、ユーザーの意図と制約を保ちます。
主な機能
- 01自己完結したタスクブリーフの作成
- 02説明に基づくエージェントプロファイルの選定
- 03必要に応じた専用ワークスペースの作成
- 04タスクの制約と意図の維持
活用シーン
- 01調査タスクを新しいエージェントに引き継ぐ
- 02要件を保ったまま修正を委任する
- 03タスクを独立した worktree に移す
MCP 対応
このスキルは、プロファイルの検出やエージェント作成など、Paseo のエージェントおよびワークスペース操作を利用します。これらは Paseo の MCP ツールから呼び出せます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ getpaseo/ paseo --skill paseo-handoffインストール後、Claude Code で/paseo-handoffを入力して読み込まれたか確認します。
詳細
ハンドオフスキル
現在のタスク(コンテキスト、判断、失敗した試み、制約)を新しいエージェントに引き継ぎます。引き継ぎ先のエージェントにはコンテキストがまったくありません。そのため、引き継ぎプロンプトは自己完結した概要にしてください。
ユーザーの引数: $ARGUMENTS
前提条件
paseo スキルを読みます。引き継ぎ先のエージェントを選ぶ前に list_profiles を呼び出してください。設定済みのプロファイルとその notes を読んでから、エージェントを作成してください。
引数の解析
- エージェントプロファイル — 明示的なプロファイル名があればそれを優先します。それ以外の場合は、作業内容に最も合った
notesを持つプロファイルを選びます。paseo スキルの説明に従って、プロファイルをcreate_agentに反映してください。合致するプロファイルがない場合は、Paseo のプロバイダー検出の代替手順を使います。 - 分離方法 — 「in a worktree」/「worktree」の指定があれば、タスクから短いブランチ名を作成し、
isolation: "worktree"を指定してワークスペースを作成します。 - タスクの説明 — ユーザーがほかに述べた内容すべて。
引き継ぎプロンプト
引き継ぎ先のエージェントにはコンテキストがまったくありません。以下を含めてください。
## Task
[Imperative description.]
## Context
[Why this task exists, required context.]
## Relevant files
- `path/to/file.ts` — [what it is and why it matters]
## Current state
[What's done, what works, what doesn't.]
## What was tried
- [Approach] — [why it failed or was abandoned]
## Decisions
- [Decision — rationale]
## Acceptance criteria
- [ ] [Criterion]
## Constraints
- [Must-not / must-preserve]
タスクの意図を維持してください。 調査のみの場合は「ファイルを編集しないでください」。修正の場合は「修正を実装してください」。リファクタリングの場合は「書き直すのではなく、リファクタリングしてください」。ユーザーの意図を正確に引き継いでください。
エージェントの起動
専用のワークスペースで引き継ぎの準備をします。
- 現在のワークスペースを選択するか、指定された分離方法で
create_workspaceを呼び出します。 [Handoff] <task>というタイトル、概要を記載した初期プロンプト、および配置を明示する必要がある場合は選択したworkspaceIdを指定して、create_agentを呼び出します。- エージェントとワークスペースをユーザーに知らせ、手動で切り離されるまでサブエージェントトラックに残ることを説明します。
作成モードで独立性を指定したり、CLI やワイヤーレベルの切り離し操作を呼び出したりしないでください。切り離しは、サブエージェントトラックでユーザーが行う操作です。
エージェントの完了を待ったり、ポーリングしたりしないでください。