openclaw-handoff

交接

编写一段可复制到剪贴板的提示词，让另一个 Agent 调查、讨论或处理特定任务。

当用户要求 handoff <task>、说“写一份交接说明”或“把这件事委派出去”，或者想要一段给另一个 Agent 使用的提示词时使用。

工作流程

1. 从用户文本中确定任务。如果用户只给出一个简短标签，就根据当前仓库、近期讨论、分支名称、关联的 issue/PR、文档和明显的上下文推断。
2. 收集足够的信息，编写有用的交接说明：仓库/产品身份、相关的 issue/PR/分支名称、可能涉及的模块、限制条件和已知症状。不要替接手的 Agent 完成完整的独立审查，也不要替其决定最终技术方向。
3. 编写一段可独立使用的提示词，供全新的 Agent 使用。
4. 将完整提示词复制到剪贴板。
5. 最终回复：简短确认任务标题。除非用户提出要求，否则不要粘贴完整提示词。

交接提示词规则

提示词必须：

• 以讨论任务的方式开头，而不是只给出命令式工单。
• 要求接手的 Agent 在进行任何更改之前，先做全面的独立审查。
• 明确说明审查由接手的 Agent 负责；交接内容只提供起步背景和已知限制。
• 要求 Agent 判断这项任务是否值得做、是否已过时、是否已解决、范围是否过大，或是否有更合适的处理方式。
• 假设 Agent 从仓库、父目录、工作区目录或主目录开始，并且能够自行找到仓库。
• 避免使用文件系统路径。除非用户明确要求，否则不要使用绝对路径、主目录路径、检出名称或仓库相对文件路径。
• 使用可移植的定位线索：仓库所有者/名称、产品/模块名称、issue/PR URL、分支名称、软件包/插件名称、公共符号、命令名称、配置键、准确的错误文本、文档标题和搜索词。
• 提供足够的上下文，帮助接手的 Agent 找到正确的仓库、任务边界和预期结果。
• 包含限制条件、非目标、验证预期和期望的输出格式。
• 在相关情况下，告知接手的 Agent 重新检查仓库、GitHub 和 CI 的最新状态。
• 告知接手的 Agent：除非交接说明明确要求，否则不要推送、合并、关闭 issue/PR、添加标签或发布公开评论。

提示词模板

默认使用此格式：

I want to discuss and possibly work on: <short task title>

Context:
- <portable repo/product context>
- <what triggered this task>
- <known current state, branch/issue/PR names or URLs if relevant>
- <important constraints and ownership boundaries>

Before doing any implementation:
- Find the right repository from the current directory, a parent directory, or the usual workspace.
- Read the local agent/repo instructions.
- Inspect the relevant code, docs, tests, recent commits, and linked issue/PR state.
- Decide whether this task is still real, whether the proposed direction is a good idea, and whether a smaller/better fix exists.
- Call out stale assumptions, hidden risks, and anything that should stop the work.

Task:
- <what to investigate or implement if the review supports it>
- <expected behavior or decision criteria>
- <non-goals>

Validation:
- <focused tests/checks/live proof expected>
- <what evidence should be included>
- <what is explicitly not required>

Output:
- Start with your review findings and recommendation.
- Then give the proposed plan or patch summary.
- If you edit code, keep changes scoped and report exact proof run.
- Do not push, merge, close issues/PRs, label, or post public comments unless explicitly told.

剪贴板

在 macOS 上：

pbcopy < /tmp/handoff-prompt.txt

使用临时文件或管道。对于包含反引号、$、引号或用户文本的提示词，避免在行内使用 shell 引号。

如果 pbcopy 不可用，请使用适合当前平台的剪贴板工具（wl-copy、xclip、clip.exe），或输出提示词并说明无法复制到剪贴板。

质量标准

• 不要编造事实。只有在检查后，才能将事实标为已审查。
• 不要泄露路径。将意外出现的路径改写为符号、模块、命令、issue/PR URL 或搜索词。
• 为全新的 Agent 提供足够的背景，使其能快速了解情况；不要倾倒大量无关信息。
• 给接手的 Agent 的第一条实质性指示必须是：审查、讨论并评估。