AgentPlane：面向确定性可审计AI代理工作流的Git原生治理框架

AgentPlane 是一款基于Git仓库本地运行的CLI工具，为AI代理驱动的开发工作流提供显式治理机制，通过任务状态、验证记录和确定性闭环等可见工件，实现可审计、可信赖的代理协作。

随着AI编程助手和代码代理的普及，开发团队面临着一个核心挑战：如何在享受自动化效率提升的同时，保持对代码变更的可控性和可审计性。传统的AI助手模式往往是"黑盒"式的——用户提出需求，代理直接修改文件，整个过程缺乏结构化的记录和明确的审批节点。

这种模式在单人快速迭代场景下尚可接受，但在团队协作、代码审查严格、合规要求高的环境中，"让代理直接改文件"的做法难以建立信任。团队需要知道：代理做了什么？为什么这样做？谁批准了这些变更？如何验证结果的正确性？

AgentPlane 提出了一种截然不同的范式——将AI代理工作流纳入Git治理体系。它不是要取代Git、编辑器或终端，而是在现有仓库中嵌入一层可见的代理工作流操作模型，使得代理执行变得可检查、可审计、可回滚。

核心理念可以概括为：信任源于可见状态。所有的审批、任务状态转换、验证和完成记录都保存在仓库中，而非某个外部托管平台的黑盒里。

AgentPlane 在仓库中引入了一组显式工件，使代理工作对人类和代理都保持可读性：

位于仓库根目录的策略文件定义了该仓库的代理工作策略。这包括代理的角色定义、工作模式、审批流程、代码风格要求等。它既是人类审阅者理解代理工作规则的入口，也是代理自身的行为准则来源。

仓库本地的代理工作目录，包含：

• config.json：当前仓库的配置状态
• tasks/：按任务组织的记录目录
• WORKFLOW.md：物化的工作流合约，描述当前工作流模式和规则
• tasks.json：可选的任务快照导出

这种设计的关键优势在于本地性和可检查性。没有外部托管的控制平面介入，所有状态都保存在开发者熟悉的Git体系中。

AgentPlane 支持两种集成风格，适应不同的协作需求：

Direct 模式（默认）：

• 单检出版本库
• 在当前工作树中快速迭代
• 适合个人开发和快速原型
• 完成任务时默认创建确定性闭环提交

Branch_PR 模式：

• 结构化的按任务分支或工作树流程
• 在 .agentplane/tasks/<task-id>/pr/ 下生成明确的PR工件
• 适合需要严格交接和集成纪律的团队
• 与现有的代码审查流程无缝集成

AgentPlane 将代理工作建模为显式的任务生命周期，每个阶段都有明确的记录和审批要求：