【免费下载链接】eve-software-factory-template
Meet Foreman, an eve Software Factory.
eve-software-factory-template 是一个开箱即用的 AI 代码工厂模板：基于 eve 框架打造的智能体 Foreman 会自动接管 GitHub 上的 Issue，依次经过分类、分析、实现、审查四道工序，最终交付一份经过独立审查的草稿 Pull Request。本文将带你通过 Vercel 一键部署，从零上线属于你自己的 AI 代码工厂。
🏭 先认识一下：Foreman 能帮你做什么
一句话概括：把「Issue」变成「已审查的草稿 PR」。
Foreman 会把每个任务送过四道独立工序，每道工序都是一个拥有独立指令、沙箱和工具集的子智能体：
| 工序 | 职责 |
|---|---|
| Classifier | 分诊任务：类型、优先级、复杂度、是否可执行；不清楚就直接向提问人追问 |
| Analyst | 基于仓库真实代码产出实施计划与验收标准 |
| Implementer | 在独立沙箱中写代码、跑仓库自己的检查、推送特性分支 |
| Reviewer | 站在独立厂商的模型上审查真实 diff，最多 2 轮修改循环 |
流水线定义在 agent/instructions.ts，各工序源码位于 agent/subagents/ 目录（classifier、analyst、implementer、reviewer、researcher）。
任务进入工厂的方式很简单：给 Issue 打上factory标签，流水线自动运行并回报进度；也可以在 Issue 或 PR 里 @Foreman 发起交互会话，或通过 Linear 委派任务。更多介绍见 README.md。
✅ 部署前准备：3 项检查清单
- 一个 Vercel 账号（免费额度即可）
- 一个 GitHub 账号，以及你要交给工厂处理的
owner/repo仓库 - 工厂对该仓库需要 contents、issues、pull requests 的写权限（Vercel 的 GitHub 连接器会自动完成安装）
如果之后想本地开发，请准备 Node 24.x 环境，版本要求见 package.json 的engines字段。
🚀 最快部署步骤：Vercel 一键上线
- 获取项目源码：
git clone https://gitcode.com/gh_mirrors/ev/eve-software-factory-template- 打开仓库主页，点击Deploy with Vercel按钮，用 GitHub 授权登录。
- Vercel 会自动完成全部初始化：GitHub 连接器（触发路径
/eve/v1/github）、Linear 连接器（触发路径/eve/v1/linear）、public 模式的 Vercel Blob 存储。 - 按提示填写两个环境变量：
FACTORY_REPO：工厂要工作的owner/repo（必填）FACTORY_LABEL：触发工厂的 Issue 标签，保持默认factory即可
- 点击部署，等待构建完成。
全程无需手写任何配置文件，这就是「一键部署」的意义。
⚙️ 环境变量速查表
完整说明见 .env.example：
| 变量 | 必填 | 默认值 | 作用 |
|---|---|---|---|
FACTORY_REPO | 是 | — | 工厂工作的目标仓库owner/repo，缺失会导致构建失败 |
FACTORY_SETUP_COMMAND | 否 | — | 每次构建时在沙箱内执行一次（如pnpm install），让每次运行自带依赖 |
FACTORY_LABEL | 否 | factory | 把 Issue 交给工厂的标签 |
FACTORY_BRANCH_PREFIX | 否 | factory/ | 工厂 PR 的分支前缀，自动修 CI 也只碰这些分支 |
FACTORY_BOT_NAME | 否 | GitHub App slug | @提及 使用的机器人名字 |
GITHUB_CONNECTOR/LINEAR_CONNECTOR | 是 | — | 由 Vercel Connect 自动填充，无需手动设置 |
🔍 部署后验证：给 Issue 打个标签
部署成功后，做一次最小验证：
- 打开
FACTORY_REPO仓库，创建一个测试 Issue。 - 给它打上
factory标签。 - 观察 Foreman 自动回帖：先给出分诊结果，各工序完成时发进度说明，最后产出一个草稿 PR 并关联 Issue。
注意工厂的安全边界：无人值守的运行默认被拒绝一切写操作，只允许打标签、在自己的 Issue 里发进度、开关 Issue 和创建草稿 PR；把 PR 标记为 ready 以及合并，永远留给人来做。策略代码见 agent/lib/github/approval.ts。
💻 本地调试：pnpm dev 快速上手
想在本地体验同款运行时（TUI 里直接给 Foreman 派活）：
pnpm install pnpm dev首次启动在 TUI 中执行/model链接模型提供方，然后拉取线上环境变量：
vercel link vercel env pull给智能体一个任务（例如"用户反馈重置密码邮件发了两次，修一下"），就能看到四道工序依次开工。本地运行默认被视为不受信调用，对 GitHub 的修改会在 TUI 中弹出审批卡片，等你确认。如果要手动发布到生产环境，请使用eve deploy（它封装了生产部署参数）。
❓ 常见问题
Q：构建失败，提示 FACTORY_REPO 缺失怎么办？FACTORY_REPO是必填项，在 Vercel 项目的 Environment Variables 中补上owner/repo后重新部署即可。
Q：工厂会不会直接推送代码到 main 分支？不会。所有分支名都会经过校验，main/master一律拒绝；对应测试用例见 evals/safety/no-direct-push-to-main.eval.ts。
Q：想深入了解完整架构？推荐阅读 .github/ARCHITECTURE.md（组件图、数据流、信任模型）和 AGENTS.md（开发命令与安全约定）。
部署完成后，你的 AI 代码工厂就开始 7x24 小时值班了：人负责判断，Foreman 负责干活。
【免费下载链接】eve-software-factory-template
Meet Foreman, an eve Software Factory.
相关推荐
Bruno 安装指南：Windows、macOS、Linux 三平台各一条命令
Bruno 安装指南：Windows、macOS、Linux 三平台各一条命令 Bruno 是一款开源 API 客户端，可理解为轻量版的 Postman / I
开发工具接口测试桌面应用CLI如何快速上手Chalice：从零创建并部署你的第一个Lambda REST API完整指南
如何快速上手Chalice：从零创建并部署你的第一个Lambda REST API完整指南 Chalice 是 AWS 官方的 Python Serverles
后端云原生从Objective-C到Swift：JHChainableAnimations跨语言动画开发完全攻略
从Objective C到Swift：JHChainableAnimations跨语言动画开发完全攻略 JHChainableAnimations是一款让iOS
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
