LoopForge 是什么:腾讯开源的编程 Agent 交付流水线

让编程 Agent「修一下这个 bug」,结果全看这一次运气:可能跳过方案直接改,可能忘了跑测试,可能自己审自己写的代码。腾讯开源的 LoopForge 想把这件事变成一条固定的流水线:方案、实现、评审、测试分给不同角色,关键节点停下来等人签字,每一步留下产物。干活的仍是 Claude Code、Codex、CodeBuddy 这些 CLI,LoopForge 管它们外面的分工、沙箱和检查点。这篇按官方 README 和文档,讲它是什么、两种用法怎么装,以及部署前要看清的几处边界。
它是什么
| 仓库 | github.com/Tencent/LoopForge |
|---|---|
| 维护者 | 腾讯(Tencent 组织) |
| 许可证 | MIT(第三方组件保留原许可,其中包含经修改的 obra/superpowers) |
| 热度 | GitHub 2,672 星、390 fork(GitHub API,2026-11-17 北京时间) |
| 语言 / 部署 | Go;Docker Compose 一键安装,自带 MySQL |
| 最新正式版 | v0.3.8(2026-11-12 21:05 北京时间);另有预发布 v0.3.9-rc.1 |
解决什么问题
README 把单个 Agent 直接干活的问题归成几条,LoopForge 对应的做法如下:
| 直接用 CLI 的常见问题 | LoopForge 的做法 |
|---|---|
| 每次流程不一样,可能跳过方案或测试 | 同一条 SOP、同样的阶段和检查;内置后端、前端、缺陷修复、产品方案四类 SOP |
| 自己写、自己审 | 方案、实现、评审、测试各有独立角色,可分别选执行器、模型、规则、Skills 和 MCP 工具 |
| 做到一半停下没人发现 | 节点状态、工具轨迹、日志和产物集中显示,可暂停、重试失败步骤、从任意节点重跑 |
| 结果没人把关 | 人工关口:看完报告放行,或打回到指定环节返工 |
SOP 里有五种节点:Agent(一个角色)、脚本(构建、测试、lint 这类确定性步骤,README 原话是「不需要 AI 的地方就不用 AI」)、人工关口、子 SOP、预览构建。每个节点声明产物和依赖,依赖完成后自动往下走。
它不替代 Claude Code 或 Codex,而是回答:谁来做、在哪个沙箱里、按什么顺序、经过哪些检查、由谁签字。
两种用法
平台版:团队一起用。准备好 Git 和 Docker,克隆后一条命令启动:
git clone https://github.com/Tencent/LoopForge.git
cd LoopForge
./start.sh
# 国内拉 ghcr.io 慢,可指定镜像站
MIRROR=ghcr.nju.edu.cn ./start.sh
./start.sh 拉取 compose.yaml 里固定版本的发布镜像,建好 MySQL 和平台服务,导入内置沙箱、通用 SOP 和体验项目,宿主机不用装 Go 或 Node.js。服务默认监听 0.0.0.0:8090,第一个注册的账号自动成为管理员。用 ./start.sh logs / stop / restart / pull 管理。
上手顺序按 README 的说法:
- 不配任何 API Key,先跑体验项目里的「平台验收 · 脚本与审批」,看一条只有脚本和人工审批的流程怎么停在关口、批准后继续。
- 配上所选执行器的 Key,就能在对话里让 Main Bot 生成文档或新项目。
- 在个人设置里用设备码连接 GitHub,选仓库,再让 Main Bot 改代码提 PR,或者跑一条项目 SOP。
Local 版:个人在已有编程助手里用。需要 Node.js 20+ 和 Python 3.8+,在项目目录里执行:
npx -y loopforge-cli@latest install claude
npx -y loopforge-cli@latest status claude
然后在 Claude Code 里输入 /start-devflow "为订单列表增加状态筛选,并补充接口测试"。Codex 的入口是 $devflow-codex "<需求>",Cursor 和 CodeBuddy 同 Claude Code。小改动走「理解 → 实现 → 自检 → 交付」的精简路径;中大型任务先澄清并等你确认范围和验收标准,再走设计、实现、独立审查、测试。需求、方案、代码变更、审查意见和测试结果落在 artifacts/{task_slug}/,中断后用 /resume-devflow {task_slug} 接着跑。
| 平台版 | Local | |
|---|---|---|
| 适合 | 团队共享工作区、SOP、审批和运行记录 | 个人开发者在 IDE / CLI 里用 |
| 依赖 | Docker + Python 3 | Node.js 20+、Python 3.8+ 和一个编程助手 |
| 工作流 | Main Bot 对话 + 可视化画布自定义 SOP | 内置 Classic / Portable 工作流 |
| 证据 | Web 工作台里的运行详情、审批和指标 | artifacts/ 下的文件 + 可选本地看板 |
想要更轻的「一个仓库里装一套工程纪律 Skill」,可以对比站内的 Superpowers,LoopForge 的许可文件里也列了它经修改后的版本。多个 Agent 常驻后台、只想看谁卡住了,见 herdr。
部署前看这几条
- 默认面向可信团队。新安装监听所有网卡,已登录用户能读实例里各项目的数据,成员可以自助注册(
.env里设AGENTFLOW_ALLOW_SIGNUP=false关闭)。放到公网前先读部署指南的账号与访问边界,配好 HTTPS;云主机上建管理员账号前,最好只放通自己的 IP。 - Docker socket 不是隔离边界。沙箱容器由平台通过宿主机 Docker socket 启动,等于给了平台控制宿主机 Docker 的权限,文档写明不适合不可信的多租户场景。
- 部分入口只用 CodeBuddy。需求澄清、通知汇总、Bot 回复和运行评测目前固定用 CodeBuddy,模型列表只列 CodeBuddy 的模型;选了别的 CLI 的模型会被直接拒绝。
- 凭据各配各的。Claude Code 之后列出的 7 种 CLI 每次运行都在私有 HOME 里生成配置,始终用需求责任人自己填的 Key 和 Base URL。团队推广时每个人都要配。平台不附带模型额度。
- Local 还跑不了平台 SOP。Local 目前只跑内置工作流,把平台 SOP 导出到本地执行写在后续计划里。
- 版本还在 0.3。近一周连发了 v0.3.5、v0.3.6、v0.3.8,命令和配置以仓库文档为准。
适合谁
适合已经在用编程 Agent、想让几个人按同一套评审和测试流程交付的小团队,尤其是自己有服务器、希望代码和凭据不出内网的。个人开发者想试试「先澄清、再设计、独立审查」这套分工,用 Local 版就够,不用起服务。只是偶尔让 Agent 改个小 bug 的,直接用 CLI 更省事。
最后
先在一个练手仓库里跑 npx -y loopforge-cli@latest install claude,丢一个中等大小的需求给 /start-devflow,看它停下来让你确认范围时问得准不准,再决定要不要上平台版。