SuperAPI AI 工具集

handoff

智能体与模型

查看项目

更新于 10-16 08:29

技能介绍

用途

Handoff 用于生成“执行就绪、面向特定模型”的提示词,把一项工作交接给另一个 LLM 智能体或全新会话。其目标是生成“另一个智能体无需猜测即可执行的最小提示词”。

何时使用

  • 将一项有边界的任务委派给共享当前工作区的智能体。
  • 在全新会话、执行 /clear 之后,或在另一个平台上继续工作。
  • 在不同模型家族之间转移工作,并套用接收方偏好的提示词结构。
  • 当另一个编排器负责路由、监督、生命周期和集成时,准备一次性工作指令。
  • 为多个目标模型分别生成优化后的提示词。

何时不使用

  • 保存会话标识以便日后恢复:应使用 save-session。
  • 拆分并执行本会话的子任务:应使用 orchestrate。
  • 持续监督运行中的 tmux 智能体:应使用 tmux-pm。本技能可以调整工作指令,但不负责路由、窗格、合并或 DONE 消息。
  • 当不存在上下文边界时,在同一对话中继续。

交接模式

  • 共享工作区:接收方可以检查同一仓库、文件、分支、工作树、日志和产物。优先使用路径而非粘贴内容。
  • 全新上下文:接收方冷启动或在重置后开始。需要包含足够的已验证状态,使其无需先前对话记录即可重建工作。

保留目标身份与权限

按以下顺序确定接收方:

  1. 用户或调用方提供的精确模型、账户、运行框架和投入等级。
  2. 构建同一会话家族重启且身份已知时,使用当前精确的模型/运行框架。
  3. 用户或调用方提供的模型家族。
  4. 当模型和家族均未知时,使用厂商中立的提示词。

绝不静默更改调用方提供的模型、账户、投入等级、权限模式或安全通道。模型引用只用于调整提示词形态,不改变运行时设置。未确定的身份应放入占位符,而不是猜测。

读取一个厂商参考

只读取与接收方家族匹配的参考文件:

  • Anthropic Claude:references/anthropic.md
  • OpenAI GPT / Codex:references/openai.md
  • Google Gemini:references/google.md
  • xAI Grok / Grok Build:references/xai.md

时效性规则:当出现以下任一情况时,起草前需核对官方厂商文档:

  • 用户要求最新、当前、最新版、最佳或推荐的模型;
  • 目标版本不在匹配的参考文件中;
  • 参考快照超过 30 天;
  • 同级技能或调用方提供了更新的明确路由;
  • 模型可用性、ID、投入等级或提示行为存在冲突。

使用厂商一手来源。仅在核实事实后更新参考快照。若无法实时核实,保留调用方的路由,并将任何模型特定建议标注为可能过时。

收集执行关键上下文

只收集会改变接收方下一步行动的事实:

  • 目标以及结果为何重要;
  • 可观察的成功标准和完成门槛;
  • 当前已验证状态、基线、阻碍和未决问题;
  • 文件、分支、工作树、命令、URL、日志和产物;
  • 所有权边界和不得触碰的区域;
  • 授权、副作用和停止边界;
  • 验证命令和预期结果;
  • 输出位置、报告模式和协作契约。

当接收方可以自行读取产物时,不要粘贴大段日志或历史。区分已验证事实、假设和过时的交接声明。

构建基础交接

从最小执行契约开始。只应用所选参考中的模型特定改动,不要混入其他家族的指导。

共享工作区交接模板:

Target: [exact model/account/harness/effort, or known family]
Handoff type: shared workspace

Objective
[One concrete outcome and why it matters]

Success criteria
- [Observable completion condition]
- [Verification condition]

Verified context
- [Current state and relevant facts]

Inputs
- [Paths, branch/worktree, logs, docs, prior outputs]

Ownership and constraints
- Modify: [owned paths]
- Do not touch: [excluded paths]
- Authorization/stop rules: [state-changing or scope boundaries]

Verification
- [Commands or evidence checks]
- [Expected baseline/result]

Output contract
- [Deliverable location or exact response shape]
- [How to report blockers, uncertainty, and incomplete checks]

Coordination
- [Relationship to parallel work and notification contract]

全新上下文交接模板:

Target: [exact model/harness/effort when known; otherwise family]
Handoff type: fresh context

Project and objective
- Project: [name and one-sentence purpose]
- Outcome: [single concrete outcome and why it matters]
- Start by reading: [entry points]

Verified current state
- Repo/worktree/branch: [paths and refs]
- Completed: [verified work]
- Remaining: [work still required]
- Baseline/blockers: [known failures, risks, assumptions]

Task contract
- Success criteria: [observable completion bar]
- Scope: [owned paths or subsystem]
- Do not change: [explicit exclusions]
- Authorization/stop rules: [side-effect and scope boundaries]

Verification
- Already run: [commands and results]
- Run next: [commands and expected result]

Output contract
- [Deliverable shape and location]
- [How to report mismatches, blockers, TODOs, and uncertainty]

使用 [TODO: exact path] 而不是编造仓库事实。

应用模型特定调整

基础契约完成后:

  • 精确保留所选模型和运行时设置;
  • 当厂商参考的“良好形态”不同时,按其重构;
  • 只添加会改变本任务和目标模型行为的指导;
  • 除非交接对象是 API 运行框架配置,否则将仅 API 可用的控制项排除在普通聊天提示词之外;
  • 保留编排器的传输封装。例如,tmux 工作器的工作树设置、提交策略、PM 目标和精确 DONE 行保持不变。

不要假设所有前沿模型都想要相同的排序。Gemini 受益于将任务和关键限制放在末尾;Claude 常受益于 XML 分隔;GPT‑5.6 偏好精简的成果/证据/完成契约;Grok Build 受益于精确路径,同时自行加载持久项目规则。

保持质量标准

  • 除非所选模型被明确路由用于长周期编排,否则保持工作器任务原子化。
  • 定义“完成”的含义以及支持它的证据。
  • 已知时写明文件名和命令。
  • 保留精确值、范围词、账户边界和停止规则。
  • 审查任务先要求发现。
  • 研究任务定义来源边界、时效性和引用。
  • 要求接收方诚实报告失败或跳过的验证。
  • 不要索取私密思维链;改为请求结论、证据、假设、检查和简洁推理摘要。

返回格式

当被要求生成交接提示词时:

  • 在一个围栏代码块中返回可直接发送的提示词。
  • 在代码块之后列出未解决的假设或占位符。
  • 当多个目标模型需要不同调整时,返回各自独立的提示词。

限制

资料未提供该技能的安装方式、收费模式、支持平台或具体运行环境要求。