paseo-handoff

paseo-handoff

熱門

將當前任務連同完整上下文移交給另一個 Agent。當使用者說出 "handoff"、"hand off"、"hand this to" 或想要將工作移交給其他 Agent 時使用。

1.2萬星標
1194分支
更新於 2026/8/1
SKILL.md
唯讀
名稱
paseo-handoff
描述

將當前任務連同完整上下文移交給另一個 Agent。當使用者說出 "handoff"、"hand off"、"hand this to" 或想要將工作移交給其他 Agent 時使用。

Handoff Skill

將當前任務——包含上下文、決策、失敗嘗試與限制條件——完整轉移給新的 Agent。接收任務的 Agent 初始狀態為完全無上下文,因此交接提示詞(handoff prompt)必須是一份資訊完整且自成一體的簡報說明。

使用者的引數: $ARGUMENTS

前置條件

請先閱讀 paseo skill。在選擇 Provider 之前,除非使用者在此請求中已明確指定 Provider,否則請先讀取 ~/.paseo/orchestration-preferences.json。在完成讀取前,切勿建立接收任務的 Agent。

解析引數

  1. Provider — 優先採用使用者明確指定的要求;否則依據 impl 偏好設定來解析(若任務僅涉及樣式調整,則採用 ui)。
  2. 隔離方式 (Isolation) — "in a worktree" / "worktree" → 使用 isolation: "worktree" 建立工作區,並根據任務名稱衍生出簡短的分支名稱。
  3. 任務描述 — 使用者提及的所有其他內容。

交接提示詞

接收任務的 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."(重構而非重寫)。必須完整傳達使用者的確切意圖。

啟動

在專屬的工作區中準備交接作業:

  1. 選擇當前的工作區,或呼叫 create_workspace 並指定要求的隔離方式。
  2. 呼叫 create_agent,指定標題為 [Handoff] <task>,將簡報說明作為初始提示詞;需要明確放置時傳入選定的 workspaceId
  3. 將建立好的 Agent 與工作區傳回給使用者,並說明在使用者手動取消連結(detach)前,該 Agent 會持續保留在你的 subagent 追蹤列中。

切勿將獨立性(independence)編碼為建立模式,也不要呼叫 CLI 或底層通訊層級的 detach 操作。取消連結(Detach)應是由使用者在 subagents 追蹤列中發起的動作。

除非使用者明確表示不需要回呼(callback),否則請保持 notifyOnFinish 為省略狀態。

預設情況下無需等待——由使用者自行決定要跟進追蹤還是繼續處理其他事項。請告知使用者 Agent ID 以及如何跟進追蹤(paseo skill 中有詳細說明)。