將當前任務連同完整上下文移交給另一個 Agent。當使用者說出 "handoff"、"hand off"、"hand this to" 或想要將工作移交給其他 Agent 時使用。
Handoff Skill
將當前任務——包含上下文、決策、失敗嘗試與限制條件——完整轉移給新的 Agent。接收任務的 Agent 初始狀態為完全無上下文,因此交接提示詞(handoff prompt)必須是一份資訊完整且自成一體的簡報說明。
使用者的引數: $ARGUMENTS
前置條件
請先閱讀 paseo skill。在選擇 Provider 之前,除非使用者在此請求中已明確指定 Provider,否則請先讀取 ~/.paseo/orchestration-preferences.json。在完成讀取前,切勿建立接收任務的 Agent。
解析引數
- Provider — 優先採用使用者明確指定的要求;否則依據
impl偏好設定來解析(若任務僅涉及樣式調整,則採用ui)。 - 隔離方式 (Isolation) — "in a worktree" / "worktree" → 使用
isolation: "worktree"建立工作區,並根據任務名稱衍生出簡短的分支名稱。 - 任務描述 — 使用者提及的所有其他內容。
交接提示詞
接收任務的 Agent 完全沒有上下文,內容應包含:
## Task
[祈使句格式的任務描述。]
## Context
[此任務存在的原因及必要的背景資訊。]
## Relevant files
- `path/to/file.ts` — [檔案內容簡介與重要性]
## Current state
[已完成事項、目前可正常運作及無法運作的部分。]
## What was tried
- [嘗試過的方法] — [失敗或放棄的原因]
## Decisions
- [決策 — 原理與考量]
## Acceptance criteria
- [ ] [驗收標準]
## Constraints
- [禁止事項 / 必須保留的規範]
精準保留任務意圖。 若僅為調查任務 → "DO NOT edit files."(請勿修改檔案)。若為修復任務 → "implement the fix."(執行修復)。若為重構任務 → "refactor, not rewrite."(重構而非重寫)。必須完整傳達使用者的確切意圖。
啟動
在專屬的工作區中準備交接作業:
- 選擇當前的工作區,或呼叫
create_workspace並指定要求的隔離方式。 - 呼叫
create_agent,指定標題為[Handoff] <task>,將簡報說明作為初始提示詞;需要明確放置時傳入選定的workspaceId。 - 將建立好的 Agent 與工作區傳回給使用者,並說明在使用者手動取消連結(detach)前,該 Agent 會持續保留在你的 subagent 追蹤列中。
切勿將獨立性(independence)編碼為建立模式,也不要呼叫 CLI 或底層通訊層級的 detach 操作。取消連結(Detach)應是由使用者在 subagents 追蹤列中發起的動作。
除非使用者明確表示不需要回呼(callback),否則請保持 notifyOnFinish 為省略狀態。
預設情況下無需等待——由使用者自行決定要跟進追蹤還是繼續處理其他事項。請告知使用者 Agent ID 以及如何跟進追蹤(paseo skill 中有詳細說明)。






