本站试运行 · 内容持续整理日报第一期筹备中留个问题 · 私人入口
Happily Play
一起学 · 一起做 · 一起分享
← 知识库

跨工具交接:让几个 AI 编程助手接力做同一件事

一份不超过 500 字的交接单,把谁派活、谁动手、谁验收写在项目里,换工具不用从头讲一遍。

康 · Claude 整理 · 来源:自建 skill · cross-ide-handoff已实测2026-11-02

我同时在用好几个 AI 编程工具:Claude Code、Codex、Grok Build,偶尔还有 DeepSeek 和 Kimi。额度用完、某个工具状态不好,或者想换个角度看问题时,经常要把做到一半的活交给另一个工具。以前每换一次就得重讲一遍背景,新工具还会把整个项目从头翻一遍。

这个 skill 只做一件事:让项目里永远只有一份「活的」交接单。

一份交接单,固定格式

交接单放在项目的 .ai/HANDOFF.md,只写当前这一件事,硬上限约 500 字。超过了说明它在记流水账,要删。

## Task                  目标 + 验收标准(开工后冻结)
## Roles                 派单 / 验收、执行者
## Baseline              开工时的版本和已有改动
## Read first            接手者只读这几个文件
## Executor self-report  执行者自报:跑了什么、没跑什么
## Acceptance            只有验收者能填
## Next action           下一步,一句话,写明归谁

历史不往里堆:任务换了,旧单整份挪进 .ai/handoff-archive/,新单留一行指向它。

改的人不验收

分工写在交接单里:Claude 派单、验收、管视觉排版;Codex 是主力执行;Grok Build、DeepSeek 依次备用。

最重要的一条是谁改的谁不判。执行者只能填「自报」,「验收」栏留给另一个工具。验收者要自己重跑检查,不采信叙述——实测里就遇到过执行者说「测试跑过了」,其实命令被权限拦下,根本没执行。

排版、配色这类拿不准的取舍,执行者不自己猜,记进「待定审美」,由验收者看着实际渲染出来的页面拍板。

派单:直接调起另一个工具

只有交接单,还得人手来回复制粘贴。所以配了几个小脚本,让 Claude 能直接调起 Codex 或 Grok 执行一张工单,结果落在项目里的固定目录,验收时对照着读。

权限只有两档:只读,或只能写项目目录。不提供「完全放开」的一档。

踩过的坑

  • Grok 在 Windows 上的沙箱参数不起作用,限定工作目录也挡不住它往外写。真正管用的只有显式的「禁止写某路径」规则,所以派给它的项目要放在用户目录之外。
  • 这条禁止规则只管它自己的改文件工具,管不住它运行的程序。所以默认只给改文件的权限,连「开子代理」也要关掉——子代理会重新拿到命令行。
  • Windows 自带的 PowerShell 5.1 里,如果脚本设成「遇错即停」,被调用的程序往错误输出写一行警告,整个脚本就会中断,结果全丢。派单脚本要把错误输出单独存文件。
  • 很多项目不是 Git 仓库,没法用 git status 分清哪些改动是谁的,只能在交接单里写明要动哪些文件,并留一份改前副本。

边界

实测过:Codex 的只读 / 可写两档,Grok 的权限拦截和完整派单流程。还没实测:接着上一次 Codex 会话继续、给 Codex 额外开放可写目录。

它保证的是交接不丢信息,管不了执行质量——质量靠验收。

配套的是 成果完整交付:交接单管过程,交付包管结果。

#多Agent#工作流#交接#独立验收

这条笔记是公开内容。合作讨论不在这里,也不出现在任何公开页面。