范围漂移才是协作翻车主因

开发者尝试把终端里的Claude Code和代理式编程环境Antigravity接起来时，最容易出问题的环节不是代码生成质量，而是上下文与范围漂移。发一句“重构这个模块并更新测试”这种宽泛指令，结果往往是配置文件被改、邻近包的依赖被破坏、令牌消耗一路膨胀。

想让AI代理之间可靠地交接任务，需要一份严格交接契约：明确列出可修改文件、隔离密钥、给出可复现的验证命令，并且必须人工确认差异后再接受。

不受约束的委派会带来三类风险

AI代理会在给定的上下文窗口和文件树里照字面执行指令。把一个不受约束的工作区交给代理，主要会触发三个问题：

  • 范围蔓延：模型自作主张去“清理”无关的辅助函数、重排空白，或者重构项目目录结构。
  • 密钥泄露与损坏：代理读取本地.env文件或凭据，不小心把它们带进生成的测试日志或脚本里。
  • 架构假设冲突：一个代理假定某种抽象层，另一个代理却按另一套约定重构导入路径。

为了保持控制，API凭据和环境设置应当与任务上下文隔离开。用BetterToken运行Claude Code时，认证通过终端层的环境变量干净地管理，而不是塞进任务提示文件里。开发者可以在BetterToken Dashboard里实时监控输入和缓存上下文的令牌消耗，在意外重试循环推高成本之前就抓住它。

交接契约框架

不要再用松散的自然语言描述来委派任务，改用一份结构化的交接契约，把边界定义清楚。

四步任务委派流程

按下面四步走，就能在Claude Code和Antigravity之间完成干净的交接。

第一步：定义交接规范

创建一个专门的规范文件（比如task_handoff.md），里面写清约束，并且不嵌入任何密钥：

  • 模块：src/parser.py
  • 目标：在不改变公共API的前提下，减少parse_payload()里的内存分配。
  • 可修改：src/parser.pytests/test_parser.py
  • 只读：其他所有文件。
  • 严格禁止：.env*secrets/*infrastructure/*
  • 验收标准：所有测试通过pytest tests/test_parser.py；基准测试显示延迟至少降低20%；requirements.txt里不新增依赖。

第二步：隔离工作区和权限

在调用Antigravity或把任务转给Claude Code之前，先做好环境清洁：

  • 不要把API密钥或敏感凭据嵌入任务提示。
  • 让凭据只存在于终端环境变量中。
  • 确认代理只能访问任务相关的文件树。

第三步：执行并验证

代理完成任务后，不要直接合并。先运行规范里写好的验证命令，确认测试通过、基准达标、依赖没有变化。任何超出文件边界的改动都要在人工审查差异时被标记出来。

第四步：人工确认差异

把代理产生的差异交给开发者逐项查看。只有确认改动都落在可修改文件范围内、没有夹带密钥或无关重构，才接受结果。这个人工确认环节是防止范围漂移进入主分支的最后一道闸门。

交接契约的价值不在约束，而在可验证

这套框架的核心不是把代理管死，而是让每一次委派都有明确的验收边界。文件边界、密钥隔离、可复现验证命令、人工差异确认，四样东西合起来，才能让两个AI编程代理在协作时不越界、不泄密、不烧掉多余的令牌。