GitMono Agent Team

面向 Libra + Monorepo 的最小三 Agent 协作仓库。它不负责替代模型或代码托管平台，而是把三个角色之间必须共享的工程契约固化为可验证文件和一个本地 MCP 服务：

• Implementer（实现）：在锁定的 baseCommit 上完成受限范围的改动，交付 PatchSet 与自测证据。

• Verifier（验证）：独立复跑验收、记录失败原因或通过证据，不能绕过测试结论。

• Integrator（集成）：检查基线、路径冲突、审查结论和风险门禁；只提交“允许合并”的决定，不直接替代人工审批。

架构遵循 GitMono 方案中的链路：IntentSpec → Task → PatchSet → Evidence → Decision。Libra 保存会话、checkpoint 与版本化证据；本仓库的 team-protocol MCP 只负责角色间的结构化交接和合并门禁。

快速开始

1. 安装并初始化 Libra（或将现有 Git 仓库转换为 Libra 仓库）。

   libra init --from-git-repository <your-repository>
   cd <your-repository>
   libra agent enable

2. 将 mcp/mcp.template.json 复制到所用 Agent 客户端的 MCP 配置，并把 <ABSOLUTE_PATH_TO_THIS_REPOSITORY> 替换为本仓库绝对路径。libra 是 Libra 官方示例中的 stdio MCP；team-protocol 是本仓库提供的协作接口。

3. 复制 examples/intent-spec.example.json，为一次工作创建 IntentSpec。将同一文件、同一 baseCommit 交给三个 Agent。

4. 按以下顺序交接：Implementer → Verifier → Integrator。每次交接由 team.submit_handoff 写入 .agent-team/handoffs.jsonl；集成前调用 team.get_gate。

   npm test
   npm run demo

Related MCP server: Hivelore

目录

agents/                   三个角色的系统提示与边界
skills/                   三个角色可安装的 Agent Skill
contracts/                IntentSpec、Handoff 的 JSON Schema
mcp/                      MCP 客户端配置模板与工具契约
src/mcp-server.js         无外部依赖的 stdio MCP 服务
src/protocol.js           校验、路由与合并门禁逻辑
examples/                 可复制的 IntentSpec / Handoff 样例
test/                     协议与 MCP 调用测试

不可变协作规则

1. baseCommit 是本轮协作的基线；任一 Agent 发现不一致必须阻塞交接。

2. Implementer 只交付指定 allowedPaths 内的 PatchSet 和其自测；Verifier 不修改同一 PatchSet。

3. Verifier 的 passed 交接必须包含通过的 test 证据；失败必须回传 Implementer。

4. Integrator 的 approved 决定必须建立在实现、通过测试和通过审查三类证据之上。

5. risk: high 永远需要 human_approval 证据，MCP 不会将其判为可合并。

6. 每次交接都应写入可选的 Libra sessionId / checkpointId，使审计可追到 Think + Code 过程。

MCP 工具

完整输入输出见 mcp/tools.md。JSON Schema 可用于 CI、Hook 或其他编排器；本服务不调用 LLM，也不直接执行 git merge。

与 Libra 的关系

Libra 是 Git 兼容、面向 Agent 的版本控制层，可捕获 Agent session 和 checkpoint，并原生提供 MCP 接入。这里按照其公开配置采用：

{
  "command": "libra",
  "args": ["code", "--stdio"]
}

因此任务事实不在聊天窗口中漂移：IntentSpec 绑定 base commit，Handoff 绑定 PatchSet/Evidence，Libra trace 绑定会话与 checkpoint。详见 Libra README。