项目2026-11-17 · 智涌AI

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

LoopForge 项目头图:左侧大字「LoopForge 交付流水线」与钩子「编程 Agent 按 SOP 干活,关键节点等人签字」,三张数据卡为 2,672 GitHub 星、10 种 Agent CLI 执行器、MIT 开源许可;右侧流程图展示内置缺陷修复 SOP 四步:澄清需求与设计方案、开发实现与独立评审、脚本运行测试、人工验收不过打回返工

让编程 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 的说法:

  1. 不配任何 API Key,先跑体验项目里的「平台验收 · 脚本与审批」,看一条只有脚本和人工审批的流程怎么停在关口、批准后继续。
  2. 配上所选执行器的 Key,就能在对话里让 Main Bot 生成文档或新项目。
  3. 在个人设置里用设备码连接 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 3Node.js 20+、Python 3.8+ 和一个编程助手
工作流Main Bot 对话 + 可视化画布自定义 SOP内置 Classic / Portable 工作流
证据Web 工作台里的运行详情、审批和指标artifacts/ 下的文件 + 可选本地看板

想要更轻的「一个仓库里装一套工程纪律 Skill」,可以对比站内的 Superpowers,LoopForge 的许可文件里也列了它经修改后的版本。多个 Agent 常驻后台、只想看谁卡住了,见 herdr。

部署前看这几条

适合谁

适合已经在用编程 Agent、想让几个人按同一套评审和测试流程交付的小团队,尤其是自己有服务器、希望代码和凭据不出内网的。个人开发者想试试「先澄清、再设计、独立审查」这套分工,用 Local 版就够,不用起服务。只是偶尔让 Agent 改个小 bug 的,直接用 CLI 更省事。

最后

先在一个练手仓库里跑 npx -y loopforge-cli@latest install claude,丢一个中等大小的需求给 /start-devflow,看它停下来让你确认范围时问得准不准,再决定要不要上平台版。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。