跨工具交接:让几个 AI 编程助手接力做同一件事
一份不超过 500 字的交接单,把谁派活、谁动手、谁验收写在项目里,换工具不用从头讲一遍。
我同时在用好几个 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 额外开放可写目录。
它保证的是交接不丢信息,管不了执行质量——质量靠验收。
配套的是 成果完整交付:交接单管过程,交付包管结果。
这条笔记是公开内容。合作讨论不在这里,也不出现在任何公开页面。