Governa：人机协作的代码仓库治理框架

Governa是一个用于同步和管理代码仓库治理模板的Go CLI工具，旨在为人类与AI编程Agent的协作提供明确的角色分工、审查流程和版本化合约，解决AI编程时代协作中的权限、审查和可复现性问题。

AI辅助编程已成为软件开发的新常态，但人类与AI Agent在同一代码库协作时面临新问题：谁有权做出哪些更改？如何审查AI提交的代码？如何确保协作过程可预测、可复现？Governa正是为解决这些问题设计的治理框架。

Governa的设计哲学是显式合约而非隐式约定：协作合约需显式、版本化、可复现，涵盖授权、审查等共识。角色分工清晰：DEV负责实现与测试，QA审查质量与安全，Maintainer为默认维护角色，Director为人类专属决策角色（不可分配给Agent），角色定义存储于docs/roles/目录。

Governa以Go CLI工具交付，静态编译支持跨平台运行，模板嵌入二进制确保目标仓库自包含。同步模式分两种：新仓库（交互式生成治理结构或非交互式运行）；现有仓库（保守适配，生成sync-review.md报告，根据内容相似度评分处理冲突）。

Governa支持模板演进：enhance命令的参考模式可识别改进模式生成AC文档，自检模式对比模板变化；ack命令允许开发者声明文件保持定制状态，平衡标准化与本地需求。

Governa目前验证于CLI类型AI Agent（如Claude Code、Codex CLI），对桌面/IDE集成Agent需额外适配。核心治理文件包括AGENTS.md（Agent行为合约）、arch.md（架构）、plan.md（计划）、CHANGELOG.md、docs/README.md及docs/roles/目录。

Governa通过明确规则使人机协作更可预测、可审计、可扩展，不取代人类判断。随着AI编程工具普及，此类治理框架将成为大型项目和团队的标准配置。