开源工具评测:LoopForge 给 AI 写代码装上流水线和签字台
一、它到底帮你干什么
一句话:它不替你写代码,它管着 AI 按流程写、在哪一步停下来等你点头。
写代码的还是你已经在用的 Claude Code、Codex、CodeBuddy。LoopForge 在它们外面加了一层——决定谁上、按什么顺序上、哪一步必须人确认、干完了东西放哪。
说三个具体场景,你就知道这东西是不是给自己准备的:
场景一:你让它修个登录 bug,它顺手把旁边三个文件也重构了。 第二天打开 diff,二十个文件变更,你得一个一个翻哪些是它"贴心"改的。LoopForge 的办法很硬:方案阶段就写死这次只能改哪几个文件,实现时多改一个,代码评审直接判失败。
场景二:它写完代码,自己 review 自己。 同一个对话里,它清楚自己当时为什么那么写,所以看哪都对。LoopForge 把评审换成一个全新角色,看不到实现过程,只拿到代码和方案。
场景三:跑到一半你关了窗口。 第二天打开,分支上躺着半成品,谁也不知道走到哪一步、哪一步没做完。LoopForge 把状态写进文件,一条命令就能查到停在哪、下一步该谁。
这三个场景要是都不像你的日常,这工具你可以先不用。

二、装它之前,先选一种用法
两种形态,能力不一样,先决定走哪条路。
| 平台版 | 本地版 | |
|---|---|---|
| 怎么装 | 克隆仓库,./start.sh 起服务 | 一条 npx 命令 |
| 依赖 | Docker + Compose + Python 3 | Node 20+ + Python 3.8 |
| 在哪操作 | 浏览器打开 0.0.0.0:8090 的网页工作台 | 就在你现有的 Claude Code 里 |
| 能改流程吗 | 能,有可视化设计器 | 不能,只用内置那套 |
| 有统一审批台吗 | 有,Needs review 收件箱 | 没有,靠对话确认 |
| 适合 | 3 人以上、要共享流程和留痕 | 一个人、想要固定节奏 |
这张表的第四行是分水岭:本地版可以用上流程,但改不动流程。想按自己团队的规矩重画流程,只能上平台版。
我的实测边界得说清楚:本地版我是真跑了、真装了 85 个文件、真读了里面的命令和流程定义;平台版没跑起来——这台机器没装 Docker,apt 源又连不通。所以上面平台版的描述来自官方文档和部署文件,不是我跑出来的。完整的工作流程我也没跑通(需要宿主 CLI 和模型 key,环境里没有),第四节讲的是它设计上怎么走,来自安装产物里的命令和流程定义,不是我的运行录像。
三、四条命令,我实际跑了一遍
在一个空目录里跑:
npx -y loopforge-cli@latest --version
# 0.2.2
npx -y loopforge-cli@latest doctor
# OK: assets and installations are healthy
npx -y loopforge-cli@latest install claude
# OK: install edition=classic host=claude project=/tmp/lf-local written=85 unchanged=0
npx -y loopforge-cli@latest status claude
# classic/claude: files=85 changed=0 missing=0四条全通,install 往空项目里写了 85 个文件。所以这不是"装了个插件",是往你仓库里塞了一整套岗位编制。
装完你会看到这几样东西:
| 装了什么 | 干什么用 |
|---|---|
agents/ 7 个 | 七个岗位:指挥、架构、开发、评审、测试、单干、知识沉淀 |
rules/ 9 份 | 每个岗位的行为守则 |
checklists/ | 评审和验收的检查清单 |
commands/ 12 个 | 你直接敲的斜杠命令 |
skills/ 5 个 | 需求头脑风暴、技术设计、写计划等能力包 |
workflows/ | 流程定义 |
最后那条 status 报的 files=85 changed=0 missing=0 挺有用:它能告诉你这套配置有没有被手改过、有没有被删漏。相当于给流程本身也装了个体检。

四、真正干活的时候,你只需要敲一行
这是全文最想让你看明白的一节。
一条命令开始
/start-devflow "给用户列表加个导出 CSV 的接口"敲完就不用管了。它先扫一遍代码,判断这是大活还是小活。
小活(改一两个文件、影响面小):直接派一个"单干"角色从头做到尾,不啰嗦、不搞流程。
中大活(涉及多个模块、有风险):走完整流程,一个阶段换一个角色。
install 跑完会提示你在 Claude Code 里敲这个命令。不过我翻文档时撞到一处矛盾:workflows/devflow.md 里写着 Claude Code 不注册这个斜杠命令,得用 $devflow-codex start 或直接说人话触发。如果 /start-devflow 不认,就改成直接说"用 devflow 做个 XX"——这是我实测撞到的第一处文档不一致。
大活会走这六个阶段
| 阶段 | 谁干 | 产出什么 | 你要做什么 |
|---|---|---|---|
| 需求澄清 | 主线程 + 你 | 01-requirement/requirement-report.md | 回答问题,确认边界 |
| 技术方案 | 架构角色 | 02-design/tech-design.md、execution-plan.md | 看方案,点头 |
| 写代码 | 开发角色 | 03-code/change-report.md | 不用管 |
| 代码评审 | 评审角色 | 03-code/code-review-report.md | 看结果,点头 |
| 跑测试 | 测试角色 | 04-e2e/test-report.md | 看报告,点头 |
| 沉淀经验 | 知识角色 | 05-knowledge/knowledge-report.md | 不用管 |

注意"你要做什么"这一列——六个阶段里你得说话四次,剩下两次它自己干。这就是它跟"AI 一口气写完"最大的区别。
你会在哪几个地方被叫停
第一次是需求阶段。 有个细节我觉得挺讲究:哪怕你的需求写得再清楚,它也必须在开工前跟你复述一遍边界——要做什么、不做什么、怎么算成功,等你明确回一句"对"才往下走。文档里写得很死:用户没确认,不许标记完成、不许进下一步。
另外三次是硬门禁:方案出来停下、评审通过停下、测试跑完停下。这三处不给过,流程不往下走。
中间想看看进度,或者中断了想接着干
/status-devflow {你的任务名}它给你回一行进度摘要,加上一张各阶段状态表——哪个完成、产物在哪。只读,不改任何东西,随时可以敲。
关掉窗口、第二天回来:
/resume-devflow {你的任务名}它会读状态文件,找到第一个没做完的阶段,重新开一个该角色的助手接着干。已完成的产物不删,失败的阶段也不会被标成完成。
不想干了:
/abort-devflow干完了提交
/git-commit "feat: 加用户列表导出接口"暂存、提交、推一条龙。这个命令独立于主流程,流程跑完了单独敲也行,不写提交信息它会按规范自己生成。
五、这套设计对你意味着什么
不聊它配置文件里写了啥,就说几条你能感知到的差别。
流程是固定下来的,不是每次看心情。 这次先出方案再动代码,下次还是。你不用每次都在 prompt 里叮嘱"记得先给方案"——它压根没有别的走法。
评审换了个人看。 不是"你让它认真检查一下自己",是一个没参与实现的新角色来看。它看不到实现时的纠结,只拿代码和方案,判断标准不一样。
它不会顺手改你的其他文件。 这条我认为最实用。方案阶段就把要改的文件列清楚了,实现时越界一个就算失败,不是提醒你注意、是直接判死。Agent 那种"顺手把旁边也重构一下"的毛病,从机制上被堵住。
它跑测试是真跑。 跑测试用的是脚本命令,不让模型"感觉一下"。跑完还要你签字,跑没跑过一目了然。

产物都在,交接不用嘴对嘴。 六个阶段各留一份文件,外加流程总结。谁接着干、出了事查哪一步,翻文件就行。
六、成本和坑,别忽略
往项目里塞 85 个文件,侵入性不小。 小项目里这堆配置比业务代码还显眼,也容易跟你已有的 agent 配置打架——同一个项目里每个宿主只能启用一种版本。
平台版强依赖 Docker,安全边界得自己扛。 官方文档写得很直白:默认把宿主机的 Docker socket 挂给容器,等于给了容器控制宿主 daemon 的权限,"适合可信团队,不是不可信多租户隔离"。另外新装默认监听所有网卡,账号建好之前最好先用防火墙挡住。
执行器只认三家:CodeBuddy、Codex、Claude Code。你用别的 CLI,这套接不上。
文档有几处对不上,我实测撞到四处。 一处是斜杠命令(第四节提过);commands/start-devflow.md 说要读 .claude/rules/global.mdc,实际装下来叫 global.md;另外 workflows/devflow.md 里提到的 devflow-codex/SKILL.md 和 .agents/skills/devflow-codex 两个路径,安装产物里都不存在。AI 执行时能自己绕过去,但对人读文档是干扰,也说明多宿主适配还在打磨。
项目还很早期。 3 个半月、313 star、58 个 open issue,文档和边界都在动。
源码编译门槛偏高。 dev.sh 要求 Go 1.26.10+,比主流发行版本高一截;README 徽章写 MIT,但 GitHub API 的 license 字段识别成 NOASSERTION,用之前建议自己看一眼 LICENSE 原文。
七、你该不该用
值得试:3 到 10 个人、已经在用 Claude Code 或 Codex 干活、但交付质量开始失控的团队。典型场景是——你们已经接受 AI 写代码了,现在想让它的产出能过评审、能进主干、出了问题查得到是哪一步的锅。
可以先放放:一个人写玩具项目(85 个文件的成本收不回来);不能接受往仓库塞配置的;CLI 不是那三家的;以及只想"让 AI 快点写完"、不打算加人工确认的——这工具的前提就是人要在关键点签字,把关卡全关掉,剩下就只是个 Docker 沙箱。
我自己的判断:方向对,完成度还在爬坡。方向对在于,AI 编码往下走,瓶颈一定从"模型能不能写"转到"流程能不能管"。完成度不够在于文档一致性、部署体验、社区积累都还早。
你要是正好卡在"agent 挺好用但不敢让它进主干"这个阶段,花半小时装上,看看那 85 个文件长什么样,值。哪怕最后不用,那套流程和检查清单也够你抄回自己团队。
# 30 秒装上看看
npx -y loopforge-cli@latest install claude
# 然后在 Claude Code 里
/start-devflow "<你的需求>"仓库在 Tencent/LoopForge,README 标 MIT(以 LICENSE 原文为准),觉得有用去点个 Star。