把工单交给自带密钥的编程智能体
文章建议把工单写成单一变更,说明背景、涉及范围和可验证的验收标准。作者在 Git A 任职,文末用该产品演示自带模型 API 密钥的工作流。
AI 深度解读
把 GitHub issue 交给 AI 编程 Agent,拿回一个能审的 PR,关键在于交代清楚三件事:它要改什么、运行时能碰什么、谁来判断改完了。来自 Git A 团队的作者给出了一份交接清单,涵盖工单、模型密钥、运行预算、CI 和审批。
如果你准备让 Agent 在云端用自己的 API key 跑任务,最值得先做两件事:把验收条件写成能检查的行为,再把模型密钥留在执行环境之外。功能做偏了可以退回修改,密钥暴露和失控的费用得靠运行前的设置来防。
工单写到什么程度,Agent 才知道何时算做完
作者建议像给刚入职的同事写工单一样写四项。标题只写一个改动,接着用一两句话交代为什么要改,知道涉及哪些文件、目录或接口就列出来,最后写下可以检查的验收条件。原因尤其有用。同一个需求可能有两种都能跑通的实现,知道业务为什么要改,Agent 才有依据选其中一种。
原文拿 /login 限流举例。验收条件是「1 分钟内尝试 5 次后返回 HTTP 429」「现有登录测试继续通过」「新增测试覆盖限流」。这样,Agent 写代码时有目标,审查者看 diff 时也有依据。原文没交代限制按 IP、账号还是其他维度计算。团队已有约定的话,应该把这项也写进工单。
测试随改动一起交付。Agent 分支要跑和人工提交相同的 CI,因为 Agent 自己补的测试只能说明它覆盖了自己想到的情况。审查再交给人,或交给一名使用独立指令的 Agent,逐项检查验收条件和改动范围。CI 工作流、部署脚本、锁文件和认证代码则单独设为人工审批路径。
自带 API key,为什么还要隔离执行环境
BYOK(bring your own key)让团队自行选模型,由模型提供商直接计费。作者强调,Agent 需要发起模型请求,真正的密钥可以由平台代持,也可以留在团队控制的网关里。如果把密钥放进 Agent 的环境变量,它运行的程序也可能读到,包括安装依赖时执行的脚本。团队已有 LiteLLM 的话,可以让 Agent 走同一个网关,集中记录调用、管理预算和切换模型。
每次运行单独设置两个上限,一个按分钟限制耗时,一个按美元限制模型支出。费用上限可以先用估算值。触发任意上限,都应停止并回报。这套安排还包括两个操作层面的要求:每项任务从干净的机器或容器启动,用完销毁;管理员能一次停止所有正在运行的任务。前者减少跨任务残留的文件、缓存和凭据,也让排查失败时更容易还原起点。后者适合同时跑了多个任务、需要马上止损的时候。
Git A 怎样把任务交回给审查者
作者用自家产品演示了整条流程。Git A 按组织配置模型连接,通过 Save and test 验证。支持 Anthropic、OpenAI、Google Gemini、Google Vertex AI、Amazon Bedrock、Azure OpenAI、OpenRouter、Mistral、xAI、DeepSeek、Groq、Together AI 和 Fireworks AI。团队也可以接入兼容 OpenAI 或 Anthropic 格式的自有网关,或在自有 runner 上使用通过 Ollama 或 vLLM 运行的模型。
创建 Agent 时指定它能访问的仓库和单次运行上限,保留 Every change comes with tests,再选执行程序。可以用 Claude Code、Codex、Gemini CLI、Goose、OpenCode,也可以用自定义命令或容器镜像。任务可直接指派,也可在 issue 里 @mention,或从命令行执行 ga issue assign。Agent 有疑问会回到 issue 里问。
最后交回一份待审改动,包含 diff、测试、检查结果,以及改了什么和为什么改的简短说明。Ask me 需要逐次批准,Land by itself when checks pass 允许检查通过后自动合入。作者称 Git A 能让多 Agent 的改动合入 main,省去推送被拒后的重试。计费方面,Agent 席位免费,机器分钟和存储用预付额度,模型账单仍由提供商结算。
我的判断
这份清单最实用的地方,是把审查标准提前写进工单,再复用团队原有的 CI 和审批机制。已有分支保护和强制审查的团队,可以先用现成机制接住 Agent 生成的 PR。让第二个 Agent 审查适合补一轮验收核对,敏感路径仍可以由熟悉系统的人判断。
作者在 Git A 工作,文章给出的是团队经验和产品流程。原文没有比较人工与 Agent 审查的漏判率,也没有给出自动合入在复杂改动上的结果。作者提到一个用临时分支统计推送重试的 Bash 脚本,但没有公布测量结果。干净环境也只是复现的一个条件,安装依赖和测试如果依赖随时变化的外部服务,相同工单仍可能跑出不同结果。首次接入时,我会选 Ask me,等团队看过一批实际改动,再决定哪些任务适合自动合入。
能拿来做什么
- 给下一张 Node 接口工单写清改动动机、涉及的路由和能断言的行为。做
/login限流时,同时注明计数维度、触发 429 的条件、要保留的回归测试和要补的新测试。 - 第一次让云端 Agent 跑任务前,把模型密钥放在平台或团队网关,设好分钟和美元上限,并确认超限时会停止、能看到停止原因。
- 让 Agent 分支沿用仓库的 CI,并给部署脚本、锁文件、认证代码等路径保留人工审批。收到 PR 后对照工单看 diff、测试和检查结果,确认改动范围再合并。