eve Software Factory

这是什么？适合谁？

eve Software Factory（Foreman）是 Vercel Labs 官方开源的”软件工厂”模板工程。它把 AI Agent 安插在开发循环的每个工位上，而把判断决策留给人：从 GitHub 和 Linear 接任务，经过分类、分析、实现、评审四个工站，最终在你自己的仓库里产出一个”已评审的草稿 PR”。你只需审查、标记 ready、合并。

适合人群：想让 AI Agent 端到端处理 issue 的中小团队、研究多 Agent 流水线架构的工程师、Vercel 生态用户。 使用前提：Vercel 账号、一个 GitHub 仓库（或 Linear 看板）、支持 Agent 调用的模型 API 配置、基本的 Git 工作流知识。

快速上手（3 步）

第一步：一键部署模板

打开仓库主页，点击 “Deploy with Vercel” 按钮，按提示克隆并部署工程：

# 也可以先克隆到本地研究结构
git clone https://github.com/vercel-labs/eve-software-factory-template
cd eve-software-factory-template

部署向导会要求填写环境变量：FACTORY_REPO（工厂工作的 owner/repo）和 FACTORY_LABEL（把 issue 移交给工厂的标签，默认 factory 即可）。

第二步：连接 GitHub / Linear

部署时通过 Vercel 的 Connectors 机制绑定 GitHub（触发器路径 /eve/v1/github）和 Linear（/eve/v1/linear）。工厂即可监听带 factory 标签的 issue 并自动开工。

第三步：给一个 issue 打标签验收

在一个测试 issue 上打 factory 标签，观察 Foreman 流水线运转：任务依次经过四个工站，最终在你的仓库出现一个草稿 PR。人工审查通过后标记 ready 并合并——这就是完整闭环。

初级用法

• 标签驱动：只有打了 FACTORY_LABEL 标签的 issue 才会进入工厂，不想让 Agent 碰的任务不打标签即可，控制粒度在 issue 级。
• 看懂四工站分工：Classifier 负责分诊（类型/优先级/复杂度，不可执行时反问需求方）；Analyst 基于仓库实时 checkout 产出带验收标准的计划；Implementer 在独立沙箱执行计划、跑仓库自带检查并推送分支；Reviewer 只看推送的分支 diff 独立评审，每个结论都附证据。
• factory brain（工厂大脑）：每轮运行之间，Foreman 会维护一份关于你仓库的笔记，每次运行都从这里起步，越用越懂你的项目。

高级玩法

1. 双源任务接入：同时连接 GitHub issue 和 Linear，让工厂同时消化两个渠道的任务队列。
2. 评审独立性设计：Reviewer 永远看不到 Implementer 的推理过程，只对真实 diff 负责——把这个模式借鉴到自己的多 Agent 系统里，可以显著减少”自己骗自己”式的通过。
3. 多工厂分工：为不同仓库或不同标签部署多个 Foreman 实例，实现按项目隔离的 Agent 产线。

常见踩坑（5 条）

踩坑 1：部署后工厂不响应 issue

• 现象：打了 factory 标签但没有任何动静
• 原因：FACTORY_REPO 写错（格式必须是 owner/repo），或 GitHub Connector 未授权目标仓库
• 解决：在 Vercel 项目设置里核对环境变量与连接器授权范围

踩坑 2：Classifier 把任务退回

• 现象：issue 被标记为”不可执行”并附提问
• 原因：这是设计行为——需求不清时 Foreman 宁可反问也不瞎做
• 解决：按提问补充 issue 描述后重新打标签

踩坑 3：Implementer 沙箱检查失败

• 现象：分支推送失败或 PR 缺失
• 原因：仓库自带的测试/lint 检查在沙箱内未通过
• 解决：先在本地跑通同一套检查，确保仓库自身是绿的

踩坑 4：模型 API 配额耗尽

• 现象：流水线中途停滞
• 原因：四工站都是独立 Agent，单任务消耗 token 明显高于单 Agent
• 解决：配置用量告警，高频任务考虑限流或错峰

踩坑 5：误让工厂处理敏感仓库

• 现象：担心代码外流
• 原因：工厂对 FACTORY_REPO 有读写权限
• 解决：用专门的测试仓库试点，生产仓库谨慎授权

FAQ（5 个常见问题）

Q1：eve Software Factory 免费吗？ A：模板本身 MIT 开源免费。实际成本来自 Vercel 部署和各工站 Agent 的模型 API 调用。

Q2：它和直接用 Claude Code / Codex 写代码有什么区别？ A：Claude Code 是单 Agent 交互式编码；Foreman 是流水线化的多 Agent 工厂——分类、计划、实现、评审分离且相互制衡，产出是可审查的 PR 而非对话。

Q3：必须用 Vercel 吗？ A：模板的部署路径是 Vercel 一键部署（官方 Connectors 触发器也绑定 Vercel 机制），自托管需要自行适配触发层。

Q4：支持私有仓库吗？ A：可以，通过 GitHub Connector 授权私有仓库，注意工厂成员的权限边界。

Q5：和 Devin 这类商业 Agent 产品什么关系？ A：Devin 是托管商业产品；Foreman 是开箱可改的开源参考架构，代码和流水线完全由你掌控。

小技巧（5 条）

1. 先拿小 issue 试产：选 1-2 个边界清晰的 bug 修复任务首跑，验证闭环后再放大任务复杂度。
2. 写好验收标准：Analyst 会基于 issue 生成计划，issue 里预先写清验收标准能显著提升 PR 质量。
3. 善用 factory brain：项目特有约定（目录结构、命名规范）写进仓库文档，工厂笔记会吸收它们。
4. 评审留证据：Reviewer 的结论附 diff 证据，审查 PR 时先看它的证据链再自己复核，效率更高。
5. 标签分层：用 factory 和 factory-experimental 两套标签区分稳健流与试验流。

进阶学习建议

• 精读四工站的提示词与沙箱配置，理解”评审者不见实现者推理”的隔离设计如何移植到自己的系统
• 研究 factory brain 的笔记持久化机制，对比你自己在用的 CLAUDE.md / AGENTS.md 方案
• 参考 ask-foreman.dev 官方文档 的 pipeline 章节理解工站编排
• 尝试为工站替换不同模型（如实现用强模型、分类用快模型）做成本/质量平衡实验

参考链接

• eve Software Factory GitHub 仓库
• Foreman 官方文档
• Pipeline 文档

本文基于公开资料于 2026-08-17 整理，社区指标反映 GitHub 公开数据。独立实测未进行，功能和配置项可能随版本更新而变化，请以官方文档为准。