Back to Details

paseo-handoff

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Handoff Skill

Handoff Skill

You are handing off the current task to another agent. Your job is to write a comprehensive handoff prompt and launch the agent via Paseo CLI.
User's arguments: $ARGUMENTS
你需要将当前任务交接给其他Agent。你的工作是撰写一份全面的任务交接提示词，并通过Paseo CLI启动目标Agent。
用户参数： $ARGUMENTS

Prerequisites

前置条件

Load the Paseo skill first — it contains the CLI reference for all agent commands.
请先加载Paseo skill——它包含所有Agent命令的CLI参考文档。

What Is a Handoff

什么是任务交接

A handoff transfers your current task — including all context, decisions, failed attempts, and constraints — to a fresh agent that will carry it to completion. The handoff prompt is the most important part: the receiving agent starts with zero context, so everything it needs must be in the prompt.
任务交接会将你当前的任务（包括所有上下文、已做决策、失败尝试和约束条件）转移给一个新的Agent，由它继续完成任务。任务交接提示词是最重要的部分：接收任务的Agent初始无任何上下文，因此它需要的所有信息都必须包含在提示词中。

Parsing Arguments

解析参数

Parse 
$ARGUMENTS
to determine:
  1. Provider and model — who to hand off to
  2. Worktree — whether to run in an isolated git worktree
  3. Task description — any additional context the user provided
解析
$ARGUMENTS
以确定：
  1. 服务商与模型 —— 交接给哪个Agent
  2. 工作区 —— 是否在独立的git worktree中运行
  3. 任务描述 —— 用户提供的任何额外上下文

Provider Resolution

服务商解析

User saysProviderModelMode
(nothing)
codex
gpt-5.4
full-access
codex
codex
gpt-5.4
full-access
claude
claude
opus
bypass
opus
claude
opus
bypass
sonnet
claude
sonnet
bypass
Default is Codex with 
gpt-5.4
.
用户表述ProviderModelMode
(无内容)
codex
gpt-5.4
full-access
codex
codex
gpt-5.4
full-access
claude
claude
opus
bypass
opus
claude
opus
bypass
sonnet
claude
sonnet
bypass
默认设置为Codex搭配
gpt-5.4
。

Worktree Resolution

工作区解析

If the user says "in a worktree" or "worktree", add 
--worktree
with a short descriptive branch name derived from the task. Worktrees require a 
--base
branch — use the current branch in the working directory (run 
git branch --show-current
to get it).
如果用户提到“in a worktree”或“worktree”，则添加
--worktree
参数，并根据任务生成一个简短的描述性分支名称。工作区需要指定
--base
分支——使用当前工作目录中的分支（运行
git branch --show-current
获取）。

Writing the Handoff Prompt

撰写任务交接提示词

This is the critical step. The receiving agent has zero context about your conversation. The handoff prompt must be a self-contained briefing document.
这是关键步骤。接收任务的Agent对你的对话完全没有上下文。任务交接提示词必须是一份自包含的简要文档。

Must Include

必须包含的内容

  1. Task description — What needs to be done, in clear imperative language
  2. Task qualifiers — Preserve the semantics of what the user asked for:
    • If the user asked to investigate without editing, say "DO NOT edit any files"
    • If the user asked to fix, say "implement the fix"
    • If the user asked to refactor, say "refactor" not "rewrite"
    • Carry forward the exact intent
  3. Relevant files — List every file path that matters, with brief descriptions of what each contains
  4. Current state — What has been done so far, what's working, what's not
  5. What was tried — Any approaches attempted and why they failed or were abandoned
  6. Decisions made — Anything you and the user agreed on (design choices, constraints, trade-offs)
  7. Acceptance criteria — How the agent knows it's done
  8. Constraints — Anything the agent must NOT do
  1. 任务描述 —— 清晰、命令式地说明需要完成的工作
  2. 任务限定条件 —— 保留用户请求的语义：
    • 如果用户要求仅调研不编辑，请注明“DO NOT edit any files”
    • 如果用户要求修复问题，请注明“implement the fix”
    • 如果用户要求重构，请使用“refactor”而非“rewrite”
    • 完全传递用户的原始意图
  3. 相关文件 —— 列出所有重要的文件路径，并简要说明每个文件的内容和重要性
  4. 当前状态 —— 已完成的工作、正常运行的部分和存在问题的部分
  5. 已尝试的方法 —— 所有尝试过的方案及其失败或被放弃的原因
  6. 已做出的决策 —— 你与用户达成的所有共识（设计选择、约束条件、权衡方案）
  7. 验收标准 —— Agent如何判断任务已完成
  8. 约束条件 —— Agent绝对不能做的事情

Template

模板

undefined
undefined

Task

Task

[Clear, imperative description of what to do]
[Clear, imperative description of what to do]

Context

Context

[Why this task exists, background the agent needs]
[Why this task exists, background the agent needs]

Relevant Files

Relevant Files

  • path/to/file.ts
    — [what it does and why it matters]
  • path/to/other.ts
    — [what it does and why it matters]
  • path/to/file.ts
    — [what it does and why it matters]
  • path/to/other.ts
    — [what it does and why it matters]

Current State

Current State

[What's been done, what works, what doesn't]
[What's been done, what works, what doesn't]

What Was Tried

What Was Tried

  • [Approach 1] — [why it failed/was abandoned]
  • [Approach 2] — [partial success, but...]
  • [Approach 1] — [why it failed/was abandoned]
  • [Approach 2] — [partial success, but...]

Decisions

Decisions

  • [Decision 1 — rationale]
  • [Decision 2 — rationale]
  • [Decision 1 — rationale]
  • [Decision 2 — rationale]

Acceptance Criteria

Acceptance Criteria

  • [Criterion 1]
  • [Criterion 2]
  • [Criterion 1]
  • [Criterion 2]

Constraints

Constraints

  • [Do not do X]
  • [Must preserve Y]
undefined
  • [Do not do X]
  • [Must preserve Y]
undefined

Launching the Agent

启动Agent

Default (Codex, no worktree)

默认配置（Codex，无工作区）

bash
paseo run -d --mode full-access --provider codex --name "[Handoff] Task description" "$prompt"
bash
paseo run -d --mode full-access --provider codex --name "[Handoff] Task description" "$prompt"

Claude (Opus, no worktree)

Claude配置（Opus，无工作区）

bash
paseo run -d --mode bypass --model opus --name "[Handoff] Task description" "$prompt"
bash
paseo run -d --mode bypass --model opus --name "[Handoff] Task description" "$prompt"

Codex in a worktree

Codex搭配工作区

bash
base=$(git branch --show-current)
paseo run -d --mode full-access --provider codex --worktree task-branch-name --base "$base" --name "[Handoff] Task description" "$prompt"
bash
base=$(git branch --show-current)
paseo run -d --mode full-access --provider codex --worktree task-branch-name --base "$base" --name "[Handoff] Task description" "$prompt"

Claude in a worktree

Claude搭配工作区

bash
base=$(git branch --show-current)
paseo run -d --mode bypass --model opus --worktree task-branch-name --base "$base" --name "[Handoff] Task description" "$prompt"
bash
base=$(git branch --show-current)
paseo run -d --mode bypass --model opus --worktree task-branch-name --base "$base" --name "[Handoff] Task description" "$prompt"

After Launch

启动后操作

  1. Print the agent ID and the command to follow along: 
    Handed off to [provider] ([model]). Agent ID: <id>
Follow along: paseo logs <id> -f
Wait for completion: paseo wait <id>
  2. Do not wait for the agent by default — the user can choose to wait or move on.
  3. If the user wants to wait, run 
    paseo wait <id>
    and then 
    paseo logs <id>
    when done.
  1. 打印Agent ID和跟踪命令： 
    Handed off to [provider] ([model]). Agent ID: <id>
Follow along: paseo logs <id> -f
Wait for completion: paseo wait <id>
  2. 默认情况下不要等待Agent完成——用户可以选择等待或继续其他操作。
  3. 如果用户希望等待，请运行
    paseo wait <id>
    ，完成后再运行
    paseo logs <id>
    查看结果。