技能介绍

问题：编码代理常常跑在“黑盒”里

当编码代理直接接入本地仓库时，常见风险是：任务意图不清楚、改动范围不可追踪、缺少审批关卡，最终只能靠人工翻聊天记录或 commit message 来复盘。对需要审计的团队来说，这类“不透明的代理运行”并不可接受。

核心能力与关键步骤

该技能围绕 AgentPlane 把编码代理放进受管理的本地 Git 工作流，核心不是替代代理本身，而是为代理的运行过程补齐治理结构：

显式策略文件：在仓库内声明代理可以做什么、必须经过哪些流程，避免治理规则只存在于口头约定。
任务状态与计划：代理工作时保留任务意图、计划和检查结果；上游维护者还要求 agent-generated PR 包含 task intent、plan、checks 与 ACR。
审批机制：在关键动作前设置 approvals，让人类可以在合入前介入，而不是事后补救。
关闭记录：任务结束保留 closure records，方便追溯谁批准、基于什么计划、完成了哪些校验。

典型工作流是：先在仓库中初始化治理结构，再通过引导流程把编码代理接入；代理在策略约束下产生变更，过程中持续写入状态与审批记录，最终形成可审计的闭环。

适用边界与注意点

它适合需要本地 Git 工作流可审计的团队，尤其是希望代理生成 PR 时附带任务说明和检查证据的场景。前提是环境已具备 Node.js、Git 仓库以及仓库内使用的编码代理运行时；上游对系统要求和限制有专门文档，落地前需要按环境核对。它解决的是“让代理工作可治理”，不是替代代码审查或 CI。