企业官网建设流程全解析

本文带你用3 步在本地跑通 eve-software-factory-template（Foreman，一个基于 eve 框架构建的 AI 软件工厂）：完成配置拉取，启动pnpm dev的 TUI 开发环境，并和 Agent 完成第一次对话。即使你没用过 Agent 框架，跟着做也能顺利跑起来。

1️⃣ eve-software-factory-template 是什么？

Foreman 是一个AI 软件工厂：给它一个任务（bug 报告、功能需求），它会自动经过四个"工位"，最后在你的目标仓库上交付一个已审查的 draft PR，你负责审核和合并即可。

完整流水线写在 agent/instructions.ts，README.md 用"四个工位 + 工作如何到达"讲清楚了整体运转方式，新手建议先读一遍。

2️⃣ 动手前 1 分钟：开发环境要求

项目基于Node.js 24.x，使用pnpm管理依赖，动手前先确认这两项：

💡 Node 版本在 package.json 的engines字段中声明，版本不符时请先用 nvm 等版本管理器切换。

3️⃣ 三步跑通 pnpm dev TUI 开发环境

第 1 步：克隆仓库并安装依赖

git clone https://gitcode.com/gh_mirrors/ev/eve-software-factory-template cd eve-software-factory-template pnpm install

pnpm install会安装eve、@vercel/connect、@github-tools/eve-extension等核心依赖。

第 2 步：从 .env.example 拉取配置

cp .env.example .env

配置模板是 .env.example，打开.env关注必填项：

⚠️FACTORY_REPO缺失或格式不对时，项目会在启动时直接报错拒绝启动，这是刻意的 fail-fast 设计，见 agent/lib/constants.ts。

第 3 步：启动 TUI 并完成第一次对话

pnpm dev

pnpm dev实际执行的是eve dev（对应 package.json 的 scripts）。TUI 启动后：

1. 在 TUI 中执行一次/model，链接你的模型提供商（每个工位都要靠模型干活）；
2. 给 Agent 下达一个任务，例如：users report the password reset email arrives twice, fix it；
3. 观察四个工位依次触发，最终以一个 draft PR 收尾。

4️⃣ 第一次对话时，背后发生了什么？

Foreman 不会自己直接写代码，而是把任务严格按顺序推进：

1. classifier先分诊，任务不清晰时它会反过来提问，而不是做错东西；
2. analyst拉取真实仓库，产出计划 + 验收标准；
3. implementer在自己的沙箱里编码、用仓库自带检查验证，推送factory/前缀分支；
4. reviewer独立审查，不通过可以打回重做（最多 2 轮）。

两个值得了解的安全细节：

• 本地运行被视为不可信：涉及 GitHub 的改动（推分支、开 PR）会先在 TUI 中等待你的批准才生效；
• reviewer 看不到 implementer 的推理过程，只看真实 diff，保证审查独立性。

5️⃣ 常见问题与实用命令

AGENTS.md 提供了完整的命令清单，常用几个：

• pnpm typecheck：TypeScript 类型检查；
• pnpm check/pnpm fix：代码规范检查与自动修复；
• pnpm eval：运行内置评估套件（会消耗真实 token，谨慎使用）。

6️⃣ 下一步：从本地 TUI 到生产

本地跑通后，你可以继续：

• 部署上线：README 提供 Vercel 一键部署流程，会自动创建 GitHub / Linear 连接器，并提示填写FACTORY_REPO和FACTORY_LABEL；
• 读源码：整个 Agent 都在 agent/ 目录下，agent/agent.ts 配置根 Agent 的模型与会话预算，agent/subagents/ 是四个工位，agent/skills/ 是按需加载的技能；
• 看评估套件：evals/ 按失败类型组织（routing/、safety/、pipeline/），是了解 Agent 行为如何被守护的绝佳样本。

到这里，eve-software-factory-template 的开发环境就完全跑通了——接下来，给它一个真实任务，看看 AI 软件工厂如何工作。