工具简介
AVP 是一款面向编码智能体（coding agents）的开源版本控制工具。与传统面向人类开发者的 Git 工作流不同，AVP 针对智能体自动生成代码、批量提交变更的使用方式进行设计，并可与 Git worktree 集成，帮助开发者在同一代码仓库中并行组织多个独立的工作区。根据官方描述，AVP 强调变更的可验证性：每次变更在合入 main 分支之前，都需要基于最新的 head 进行验证，以降低因基线代码过期而导致的合并风险。
主要功能
- Git worktree 集成：依托 Git 原生的多工作区能力，为不同任务或不同智能体分配相互隔离的检出目录，避免在同一个工作目录中互相干扰。
- 变更前基线校验：在变更被合入 main 之前，检查其是否基于仓库当前最新的 head，从而减少“基于旧代码开发、合并时才发现冲突”的情况。
- 面向智能体的版本控制流程：围绕自动生成、自动提交的代码变更场景组织提交与合入环节，便于将智能体产出的改动纳入可控的分支管理。
- 开源可自建：项目以开源形式提供，团队可以自行部署、审阅实现细节，并根据内部研发流程进行调整。
特色优势
- 降低并发冲突成本：通过 worktree 隔离多个智能体的工作目录，让并行任务各自独立演进，减少相互覆盖与环境污染。
- 提升合入可信度：“合入前基于最新 head 验证”这一约束，使进入主干的变更在时效性和一致性上更有保障，尤其适合无人值守或高频提交的自动化流程。
- 契合智能体协作模式：智能体往往在短时间内产生大量提交，AVP 把版本控制的重心放在变更的隔离与校验上，而不是仅依赖人工审查。
- 与既有 Git 生态兼容：基于 Git 构建，便于与现有的仓库托管、CI 流水线等环节衔接。
适用场景
- 使用多个编码智能体在同一仓库中并行开发不同功能或修复任务。
- 需要将智能体生成的代码自动提交并自动校验后再合入 main 的团队。
- 希望借助 worktree 在本地或服务器上组织多套隔离工作区的研发流程。
- 在 CI 之前增加一道“基线是否最新”检查，以减少合并返工。
使用建议
建议先在测试仓库中试用，梳理清楚智能体、worktree 与 main 分支之间的协作流程，明确哪些变更需要人工复核。团队可将“合入前基于最新 head 验证”作为合入门禁的一环，并与现有 CI 检查配合使用，而非完全替代代码审查。对于并发任务较多的情况，建议为每个任务约定清晰的命名与清理规则，避免 worktree 目录堆积。具体安装方式、配置项与支持的命令，请以项目官方仓库的最新文档为准。
