什么是eve-software-factory-template?5分钟看懂这个贴个标签就交付Draft PR的AI软件工厂
什么是eve-software-factory-template?5分钟看懂这个贴个标签就交付Draft PR的AI软件工厂
eve-software-factory-template 是 Vercel Labs 开源的 AI 软件工厂模板,代号 Foreman,基于 eve Agent 框架构建(MIT 协议)。它把一队 AI Agent 组织成流水线:给 GitHub Issue 贴上 factory 标签,分诊、规划、写码、评审四个岗位自动流转,最终在你的仓库交付一个经过独立 Review 的 Draft PR——人只需要负责"标记 ready"和"合并"。这就是它和单点 Copilot 的本质区别:交付的不是补全建议,而是一个能走完工程闭环的产物。
一句话定位:AI 打工,人做判断
普通 AI 编程助手是"你问它答",而 eve-software-factory-template 是一条无人值守的软件流水线:
任务(GitHub / Linear / 命令行)→ 分诊 → 规划 → 实现 → 独立评审 → Draft PR → 人来标记 ready 并合并
它的分工原则写在系统提示词里(见 agent/instructions.ts):Foreman 自己不写代码、不做深度分析,只负责调度任务、校验交接、组装结果;"标记 PR ready"和"合并"永远留在人这边,这是它的职责边界。
四个工位:一个任务如何变成 Draft PR
工厂的核心是四个独立工位(station),每个工位都是自己的子 Agent,有各自的指令、沙箱和工具,目录就在 agent/subagents/ 下:
1️⃣ classifier 分诊台:先判断"该不该做"
收到原始任务后,classifier 只凭文本做快速分诊:类型(bug / feature / security…)、优先级、复杂度、受影响模块,以及一个关键判断——needs_clarification。信息不足、继续做下去可能"做错东西"时,它会停下来向提问者追问,而不是盲目开工(规则见 agent/subagents/classifier/instructions.md)。
2️⃣ analyst 分析师:把需求变成可执行计划
analyst 在自己的沙箱里 checkout 真实仓库,读完相关文件后才产出:问题陈述、方案与备选、分步计划、风险、验收标准和测试策略。它只规划不动手——后续 reviewer 就是拿这份验收标准逐条打分的(见 agent/subagents/analyst/instructions.md)。
3️⃣ implementer 实现员:沙箱里写码、跑检查、推分支
implementer 按计划在独立 checkout 中创建 factory/ 前缀的分支,写完整可运行的代码(禁止 // TODO 占位),用仓库自己的 lint / typecheck / test 命令验证后推送分支。它刻意被安排在最强编码模型上(见 agent/lib/models.ts)。
4️⃣ reviewer 评审员:换个"视角"挑刺
reviewer 用不同供应商的模型,看不到实现员的推理过程,只 fetch 推送的分支、读真实 diff,逐条对照验收标准给出 approve / request_changes / reject。评审不过就打回实现员修改,最多 2 轮;通过后编排器才开 Draft PR。这套"实现与评审异厂商"的设计,就是工厂里的质检独立性。
🧠 额外一记:factory brain(工厂大脑) 每次运行前,Foreman 会读一份关于目标仓库的持久记忆——构建怪癖、验证坑、反复出现的评审发现(实现见 agent/lib/factory-brain.ts)。它让工厂越跑越懂你的仓库,且只允许受信任的调用者写入,防止不可信的 issue 内容污染共享上下文。
任务怎么进厂:6 种方式,标签是招牌
| 方式 | 触发 | 特点 |
|---|---|---|
🏷️ 给 issue 贴 factory 标签 |
GitHub labeled 事件 |
无人值守,全程自动,产出 Draft PR |
| 💬 在 issue / PR 里 @Foreman | 仅 Owner / Member / Collaborator | 交互会话,可随时追问澄清 |
| 📋 Linear 委托 | Linear Agent Session | 进度回写到 Linear |
| ⌨️ 本地 TUI | pnpm dev 直接派任务 |
本地运行视为不可信,写 GitHub 需你批准 |
| 🔴 工厂 PR 的 CI 红了 | check_suite 失败 |
自动诊断并修到工厂自己的分支(最多 2 次尝试),绝不碰你的分支 |
| 📝 有人开了新 PR | pull_request opened |
发一条面向 reviewer 的摘要评论 |
安全设计:AI 能写码,但"合并"权永远在人
这是这个项目最值得新手抄作业的部分(架构细节见 .github/ARCHITECTURE.md):
- Draft PR 是无人值守的天花板:自动运行只能创建 Draft PR(draft 无法合并),标记 ready、合并这类动作被策略直接拒绝,等待真人处理。
- 信任在入口盖章,不靠提示词:渠道在 webhook 派发的瞬间判定调用者身份并打标(agent/lib/trust.ts),下游能力只认这个标记。
- git 安全是结构性的:沙箱内的 git 永远指向字面量仓库 URL 而非
origin,凭证在沙箱防火墙处注入、从不进入沙箱;分支名校验拒绝main/master,AI 结构性地无法直接推主分支。 - 内置安全评估套件:evals/safety/ 下有"禁止直推 main""写入需审批""prompt-injection 抗注入"等用例,用回归测试把安全底线焊死。
快速上手:三步跑起你的 AI 软件工厂
- 一键部署到 Vercel:用官方部署入口克隆模板,流程会自动配好 GitHub 连接器、Linear 连接器、Vercel Blob 存储,并提示你填两个关键变量:
FACTORY_REPO(必填):工厂工作的owner/repoFACTORY_LABEL(默认factory):把 issue 交给工厂的标签
- 本地体验:链接部署项目并拉取环境变量后启动 TUI:
git clone https://gitcode.com/gh_mirrors/ev/eve-software-factory-template
cd eve-software-factory-template
pnpm install
vercel link && vercel env pull
pnpm dev
给 Agent 一句"用户反馈重置密码邮件会收到两遍,修一下",就能看到四个工位依次点火、最终落到 Draft PR。
- 改模型只需一行:所有工位的模型集中在 agent/lib/models.ts 一处管理,换供应商是单行编辑的事。
项目结构速览
agent/
agent.ts # 根 Agent:模型 + 会话预算
instructions.ts # Foreman 的系统提示词(流水线总控)
channels/ # 入口:GitHub / Linear / eve 路由
subagents/ # 四大工位 + researcher 调研员
skills/ # 按需加载技能:写作质量 / issue 分诊 / GitHub-Linear 桥接
tools/ # 偏好、factory brain、artifact 读写工具
lib/ # 信任、审批、git 凭证、Blob 命名空间
evals/ # 路由 / 安全 / 全流水线评估
README.md # 快速开始
.github/ARCHITECTURE.md # 组件图、数据流、信任模型
5 分钟总结
- 它是什么:一个可部署的 AI 软件工厂模板,贴
factory标签 → 自动交付 Draft PR,人只做最后判断。 - 核心机制:classifier → analyst → implementer → reviewer 四工位流水线 + factory brain 持久记忆。
- 安全哲学:Draft PR 是无人值守上限;信任在派发时判定;git 与凭证安全是结构性的。
- 适合谁:想在自有仓库上搭"issue 进、PR 出"自动化流水线的团队;以及研究多 Agent 编排、权限设计、Agent 安全回归测试的工程师——evals/ 和 agent/lib/trust.ts 都是好教材。
