什么是eve-software-factory-template?5分钟看懂这个贴个标签就交付Draft PR的AI软件工厂

原创2026-10-14 04:37:111,724 阅读

什么是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 的本质区别:交付的不是补全建议,而是一个能走完工程闭环的产物。

Foreman AI软件工厂 eve-software-factory-template 项目横幅

一句话定位: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 软件工厂

  1. 一键部署到 Vercel:用官方部署入口克隆模板,流程会自动配好 GitHub 连接器、Linear 连接器、Vercel Blob 存储,并提示你填两个关键变量:
    • FACTORY_REPO(必填):工厂工作的 owner/repo
    • FACTORY_LABEL(默认 factory):把 issue 交给工厂的标签
  2. 本地体验:链接部署项目并拉取环境变量后启动 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。

  1. 改模型只需一行:所有工位的模型集中在 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 都是好教材。
登录后查看全文
eve-software-factory-template