Skip to content
BranchesTags

Repository files navigation

RepoPilot — Evidence-first AgentTeam

面向开源与企业研发团队的可审计仓库自治维护 AgentTeam

将 GitHub Issue 与失败 CI 安全推进到经过独立验证的 Pull Request， 并完整保留决策、工具、审批、回滚点与经验证据。


RepoPilot 从 Issue 到 Verified PR，不跳过任何证据
5
不同职能 Agent		 8
Streamable HTTP MCP 工具		 100%
关键动作证据留痕		 0
未审批自动合并

RepoPilot 建立在 AgentTeams v1.2.2 之上，面向 GOAI「新智基座 · Agent Infra」赛道设计。默认策略为 pull_request_only：Agent 可以创建分支、提交和 Pull Request，但不能自动合并、 删除分支、修改权限或密钥。

使用过程演示

RepoPilot 使用流程：Issue、Triage、Locate、Patch、Verify、Verified PR

Issue → Repo Lead 分诊 → Locator 定位 → Fixer 最小修复 → Verifier 独立验证 → Verified PR

打开可交互的 8 阶段闭环 ↗ · 下载高清 MP4

动图展示的是确定性使用流程；在线展示站还提供可点击证据链、Agent Identity、 Skill/MCP、审批门禁以及真实 Issue/CI 证据。

维护闭环

GitHub Issue / Failed CI
          │
          ▼
   Repo Lead 分诊与拆解
          │
          ▼
 Locator 根因定位 ──► Fixer 最小修复 ──► Verifier 独立验证
                                                │
                  人工审批 ◄── 高风险门禁 ◄─────┤
                                                │
                                                ▼
                                      Archivist 沉淀 Runbook

每个关键阶段都会把决策、工具调用、Git 引用、CI 结果和审批事件写入 PostgreSQL 追加式 SHA-256 证据链，并通过 OpenTelemetry Trace 与证据控制台支持回放。

为什么是 RepoPilot

问题 RepoPilot 的处理方式 可验证证据
Issue 分诊依赖人工 Repo Lead 统一分类、风险判断和 DAG 拆解 任务计划、Matrix 事件、Run 状态
自动修复容易直接猜答案 Locator 与 Fixer 职责分离，先复现和证明根因 复现命令、代码位置、影响面、补丁
修复者自行验证存在偏差 Verifier 独立运行 before/after 测试与 GitHub Checks 测试结果、Check Runs、残余风险
高风险动作缺少控制 合并等动作要求带版本号的一次性人工审批 审批人、意见、版本、消费时间
经验无法复用 Archivist 查重、脱敏并写入 Runbook 来源 Run、证据链、检索结果

AgentTeam

Agent 职责 自主边界
Repo Lead 分诊、风险判断、DAG 拆解、任务委派 不修改代码；高风险动作必须发起审批
Locator 复现、代码/符号定位、影响面分析 仅读取和实验，不修改仓库
Fixer 最小补丁、回归测试、分支、提交、PR 停在 Pull Request，不合并、不强推
Verifier 独立复现、测试、CI 和残余风险验证 不修改补丁，不把绿灯视为合并授权
Archivist Runbook 查重、脱敏、结构化和沉淀 不修改仓库或 GitHub 状态

Agent Identity 完整定义位于 deploy/agentteams/repopilot-team.yaml， Skill 契约位于 skills/。

核心能力

AgentTeams 原生协作
使用官方 agentteams.io/v1beta1 Worker/Team CRD、Team Leader、 Matrix 房间、共享任务状态与 MinIO 工作区，而不是自建多 Agent 模拟器。
Skill 与 MCP 工程化
提供 5 个 Apache-2.0 自定义 Skill；控制面暴露 8 个 Streamable HTTP MCP 工具， 覆盖 evidence、审批、Runbook、Issue、PR、Checks 和受控合并。
不可变执行证据
Evidence 使用 canonical JSON 与 SHA-256 哈希链；数据库触发器拒绝更新和删除。 控制台会重新验证完整链路并展示 CHAIN VERIFIED。
生产级安全边界
包含 GitHub 仓库 allowlist、Webhook HMAC 验签、delivery 并发幂等、显式状态机、 审批乐观锁和审批一次性消费。
RAG 与可观测
PostgreSQL 提供 Runbook 全文检索并预留 pgvector；可选接入阿里云官方 alibabacloud-agentloop-experience Skill。OpenTelemetry 通过 OTLP 对接 AgentLoop、LoongSuite 或兼容后端。

系统架构

flowchart LR
    GH[GitHub Issue / Failed CI] --> CP[RepoPilot Control Plane]
    CP --> DB[(PostgreSQL + pgvector)]
    CP --> MX[Matrix Admin → Manager DM]
    MX --> M[AgentTeams Manager]
    M --> TL[Repo Lead]
    TL --> L[Locator]
    TL --> F[Fixer]
    TL --> V[Verifier]
    TL --> A[Archivist]
    L & F & V & A --> MCP[RepoPilot MCP via Higress]
    MCP --> GHAPI[GitHub REST API]
    MCP --> DB
    DB --> UI[Evidence Console]
    CP --> OTEL[OTLP / AgentLoop / LoongSuite]
Loading

更多设计细节见 docs/architecture.md。

工程结构

RepoPilot/
├── apps/
│   ├── control-plane/       # Fastify REST / Webhook / MCP / 审批 / 证据账本
│   └── console/             # 飞行记录器风格 React 证据控制台
├── packages/contracts/      # Zod Schema、共享类型和显式状态机
├── deploy/agentteams/       # AgentTeams v1.2.2 Worker / Team 清单
├── skills/                  # 5 个可复用 RepoPilot Skills
├── competition/             # 初赛简介、评审映射和提交清单
├── docs/                    # 架构、安全、部署和 Demo 文档
├── API.md                   # REST / Webhook / MCP 出入参
├── Method.md                # 外部 SDK、HTTP Method 与调用契约
└── docker-compose.yml       # PostgreSQL 16 + pgvector

快速开始

环境要求

  • Node.js 20+
  • pnpm 9+
  • Docker Desktop / Docker Engine

模型凭证不是构建、测试或本地控制面运行的前置条件。

git clone https://github.com/wellkilo/RepoPilot.git
cd RepoPilot
cp .env.example .env
docker compose up -d postgres
pnpm install --registry=https://registry.npmjs.org
pnpm build
pnpm --filter @repopilot/control-plane start

访问控制台：

http://127.0.0.1:3000

也可以使用一键初始化：

./init.sh

创建首个 Run

curl -X POST http://127.0.0.1:3000/api/v1/runs \
  -H 'Content-Type: application/json' \
  -d '{
    "source": {
      "type": "github_issue",
      "repository": "wellkilo/repopilot-testbed",
      "issueNumber": 1
    },
    "executionPolicy": "pull_request_only"
  }'

需要读取 GitHub Issue 时，在本机 .env 配置 GITHUB_TOKEN。如果没有配置 AgentTeams Matrix，Run 会停在 awaiting_dispatch，不会用 Mock Agent 伪造执行结果。

AgentTeams 真实协作

真实五 Agent 推理需要一个 OpenAI 兼容模型端点，可以使用：

  • 阿里云百炼等托管服务；
  • 其他 OpenAI 兼容 API；
  • 本地 Ollama 等兼容端点。

模型密钥只交给 AgentTeams/Higress，不进入 RepoPilot 源码、数据库或部署清单。

部署说明：

可复现测试床

仓库 wellkilo/repopilot-testbed
Issue #1 · Zero evaluation scores are normalized to one
失败 CI GitHub Actions Run 31680709748

测试床包含一个确定性缺陷：合法的 score=0 被 || 1 误判为缺失值。 类型检查通过，CI 只因对应回归用例失败，适合完整演示定位、修复、验证和 PR 证据链。

验证

pnpm typecheck
pnpm test
pnpm lint
pnpm format:check
pnpm build

测试覆盖状态机、Webhook 验签、证据哈希、数据库不可变触发器、delivery 并发幂等、 审批版本与一次性消费、HTTP 冲突语义及控制台标签。

安全边界

默认允许 必须人工审批
读取 Issue / CI、创建分支与提交、推送非保护分支、创建 Pull Request、读取 Checks、 记录 evidence 合并 Pull Request、删除分支、破坏性回滚、修改权限、修改密钥、执行其他高风险工具

详细威胁模型与生产加固项见 docs/security.md。

文档导航

文档 内容
API.md REST、Webhook 和 MCP Schema
Method.md AgentTeams、Matrix、GitHub、PostgreSQL 和 OTel 方法契约
docs/architecture.md 架构、状态机和部署剖面
docs/security.md 权限、审批、凭证和 evidence 完整性
docs/deployment.md 本地、AgentTeams、Webhook 和可观测部署
docs/demo.md 比赛 Demo 流程与失败分支
competition/ 初赛简介、评审映射和提交清单

当前边界

  • 未配置模型服务时，不能完成真实 AgentTeams 推理；构建、测试、控制面和测试床不受影响。
  • Runbook 默认使用 PostgreSQL 全文检索；vector(1536) 已为语义召回预留。
  • AgentLoop Recall 是可选能力，没有凭证时自动降级到本地 Runbook。
  • 控制台审批身份当前通过受信反向代理 Header 演示；生产环境必须接入 OIDC/SSO。

RepoPilot · Make repository automation observable, reviewable and reversible.

Apache-2.0

About

Auditable repository maintenance AgentTeam built on AgentTeams, MCP, PostgreSQL evidence chains and human approval gates.

wellkilo.github.io/RepoPilot/

Topics

agent-infrastructureagentteamsgithub-automationmcpmulti-agentopentelemetrypostgresql

Resources

Readme
License

Security policy

Security policy
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages