| name | model-handoff |
| description | 模型间任务交接协议(主会话 agent ⇄ 外包 agent,默认 Claude ⇄ Grok)。把「范畴可界定、机械、高 token」的活外包给另一模型跑,产出结果文档回灌仓库,主会话 agent 强制验收后继续开发。用户说「交给 Grok」「外包给 Grok 跑」时手动触发。核心红线:外包产物必须经主会话 agent 拉回源头抽查验证,绝不盖章放行。 |
| user-invocable | true |
模型间任务交接 Skill(主会话 agent ⇄ 外包 agent)
解决的问题
有些活范畴死板、体量大、烧 token:大文件探索、固定数据抽取、文档覆盖度爬梳、批量代码生成。这类活不需要主会话 agent 的项目上下文判断,用一段界定清楚的提示词就能让 外包 agent(默认 Grok) 代跑。
默认角色假设:
- 主会话 agent:当前对话里的 agent(Claude / Codex / Grok 等)
- 外包 agent:Grok(或用户指定的另一模型会话)
现实约束
主会话 agent 不能直接调用外包 agent。 这是人在环(human-in-the-loop)交接:
主会话判定+写提示词 → 用户把提示词丢进外包会话跑 → 外包把结果写进仓库文件
↓
主会话继续开发 ← 主会话强制验收(拉回源头抽查) ← 用户说「跑完了」
一、适配闸门(Fitness gate)
任何考虑外包的任务,先过闸门,输出裁决(✅ 适合外包 / ❌ 自己做)+ 理由。
✅ 适合外包(四条尽量都满足):
- 范畴可被一段提示词完全界定
- 机械 / 高 token——批量探索、固定数据抽取、覆盖度爬梳
- 产物可独立抽查——输出是文档 / 结构化数据
- 低耦合——产物是「素材/事实」,不直接改动产品代码
❌ 不外包(命中任一即自己做):
- 需要项目上下文的设计 / 架构 / 取舍判断
- 直接改产品代码、跑构建、动项目状态
- 不可逆或对外操作
- 产物无法被主会话验证
二、生成交接提示词
用 references/handoff-prompt-template.md 的骨架填。必含要素:
- 协议引导——让外包 agent 先读
AGENTS.md
- 精确范畴——要拿的要点逐条列死
- 数据源 + 可跑命令——精确路径、可复制命令
- 「已完成,别重做」——主会话侧已钉死的结论
- 输出格式——结构化写到指定路径
- 置信度标注——源受限时标来源 +「需确认」
- 升级而非瞎猜——拿不准就列待确认项
三、交接(停,等用户)
把提示词整段贴给用户复制,明确告知产出路径。然后停下。
四、回收 + 强制验收(核心红线)
用户说「跑完了/你审核」后:
- 读产物文档
- 拉回源头抽查——挑最要命的若干条声明,重跑源头对拆
- 报账——列「✅ 通过 N 条 / ❌ 实错 M 条」
- 就地纠错——有真值在手直接改正
- 诚实留白 ≠ 错
铁律:绝不盖章放行。
五、记档
写进 task-dossier 台账(若该任务有档案)。
触发条件
- 自动:规划任务时某子任务命中适配闸门画像,主动过闸门并建议外包
- 手动:用户说「交给 Grok」「外包给 Grok」等,或
/model-handoff