SKILL.md
只读
名称
paseo-handoff
描述
带着完整的上下文将当前任务移交给另一个 agent。当用户输入“handoff”、“hand off”、“hand this to”或希望将工作交接给另一个 agent 时使用。
Handoff Skill
将当前任务——包括上下文、决策记录、失败尝试和约束条件——完整交接给全新的 agent。由于接收方 agent 起始状态为零上下文，因此 handoff prompt 必须是一份自包含的交接简报（briefing）。
用户参数： $ARGUMENTS
前置条件
请先阅读 paseo skill。除非用户在本次请求中明确指定了 provider，否则在选择 provider 前必须先读取 ~/.paseo/orchestration-preferences.json。在读取该文件之前，切勿创建接收方 agent。
解析参数
- Provider — 优先使用用户显式指定的 provider；否则根据
impl首选项解析（若任务仅涉及样式调节，则使用ui首选项）。 - 隔离模式（Isolation） — 匹配到 "in a worktree" / "worktree" → 创建
isolation: "worktree"的 workspace，分支名取自任务的简短描述。 - 任务描述 — 用户输入的其他所有内容。
交接 Prompt 结构
接收方 agent 没有历史上下文。Prompt 需包含以下内容：
## Task
[祈使句形式的任务描述。]
## Context
[为什么要做这个任务，以及必要的上下文。]
## Relevant files
- `path/to/file.ts` — [文件作用及为何重要]
## Current state
[当前状态：已完成哪些、哪些正常运行、哪些存在问题。]
## What was tried
- [尝试过的方案] — [失败或放弃的原因]
## Decisions
- [决策 — 对应理由]
## Acceptance criteria
- [ ] [验收标准]
## Constraints
- [禁止事项 / 必须保留的要求]
保留任务语义。 仅调查类任务 → "请勿修改任何文件。" 修复类任务 → "实现具体修复。" 重构类任务 → "进行重构，而非重写。" 务必精确传达用户的原始意图。
启动
在专用 workspace 中准备交接：
- 选择当前 workspace 或使用指定的隔离模式调用
create_workspace。 - 调用
create_agent，标题设为[Handoff] <task>，初始 prompt 传入交接简报；如需明确位置，传入选定的workspaceId。 - 将 agent 和 workspace 返回给用户，并说明在用户手动分离（detach）之前，它将一直保留在 subagent 轨道中。
切勿将独立性（independence）编码为某种创建模式，也不要调用 CLI 或底层协议级别的 detach 操作。分离（detach）是用户在 subagents 轨道中的手动操作。
除非用户明确表示不需要回调，否则保持 notifyOnFinish 省略状态。
默认无需等待——由用户决定是跟进查看还是转去处理其他工作。请告知用户 agent ID 以及如何跟进（详见 paseo skill 介绍）。
