vercel-labs/eve-software-factory-template 来源：https://github.com/vercel-labs/eve-software-factory-template # Eve 软件工厂模板 文档 (https://ask-foreman.dev/docs) 代理架构 (https://vercel.com/kb/agent-stack) MIT 许可证 认识 Foreman，一个 eve 软件工厂，它将 AI 代理置于开发循环的每一个阶段，并将判断决策权交给人类。Foreman 从 GitHub 和 Linear 接收任务，将每个任务依次经过四个站点处理，并在您的仓库中交付一个经过审查的草稿拉取请求。您进行审查、标记就绪并合并。 通过 Vercel 部署 (https://vercel.com/new/clone?demo-title=eve+Software+Factory&demo-description=Software+factory+built+on+eve%3A+AI+agents+work+each+stage+of+the+development+loop%2C+and+people+make+the+judgment+calls.&project-name=eve-software-factory&repository-name=eve-software-factory-template&repository-url=https%3A%2F%2Fgithub.com%2Fvercel-labs%2Feve-software-factory-template&env=FACTORY_REPO%2CFACTORY_LABEL&envDefaults=%7B%22FACTORY_LABEL%22%3A%22factory%22%7D&envDescription=FACTORY_REPO+is+the+owner%2Frepo+the+factory+works+on.+FACTORY_LABEL+is+the+issue+label+that+hands+an+issue+to+the+factory%3B+the+default+label+is+fine.&connect=%5B%7B%22type%22%3A%22github%22%2C%22env%22%3A%22GITHUB_CONNECTOR%22%2C%22triggers%22%3Atrue%2C%22triggerPath%22%3A%22%2Feve%2Fv1%2Fgithub%22%7D%2C%7B%22type%22%3A%22linear%22%2C%22env%22%3A%22LINEAR_CONNECTOR%22%2C%22triggers%22%3Atrue%2C%22triggerPath%22%3A%22%2Feve%2Fv1%2Flinear%22%7D%5D&stores=%5B%7B%22type%22%3A%22blob%22%2C%22access%22%3A%22public%22%7D%5D&demo-image=%2F%2Fimages.ctfassets.net%2Fe5382hct74si%2F45PVqbeL5egwsqBRpGt6SQ%2F99e9f270dc22e07f499236af3a11a190%2Fimage.png&redirect-url=https%3A%2F%2Fask-foreman.dev%2Fwelcome) ## 工作原理 - 分类器 对任务进行分类：类型、优先级、复杂度、是否可操作。当任务不可操作时，Foreman 会询问请求者，而不是构建错误的内容。 - 分析师 基于您仓库的实时检出，将其转化为包含验收标准的计划。 - 实施者 在其自己的沙箱中执行计划，使用您仓库自身的检查进行验证，并推送一个分支。 - 审查者 独立地根据真实的差异判断所有内容，为每个判决提供证据。 每个站点都是一个独立的代理，拥有自己的指令、沙箱和工具。审查者只看到推送的分支，从不接触实施者的推理过程。 在运行之间，Foreman 维护一个 工厂大脑：关于您仓库的笔记，每次运行都从此开始。完整详情请参见流水线 (https://ask-foreman.dev/docs/pipeline) 和工厂记忆 (https://ask-foreman.dev/docs/memory)。 ## 工作如何触发 - 为 issue 添加 factory 标签。 流水线将自动运行，在各站点完成时发布进度更新，最后以链接到该 issue 的草稿 PR 结束。 - 在 issue 或 PR 上 @提及它。 来自仓库所有者、成员和协作者的提及将启动一个交互式会话。 - 在 Linear 中委派。 Linear Agent Sessions 运行相同的流水线，并将进度报告回 Linear。 - 开发者 TUI。 在本地将任务交给它。对 GitHub 的更改将等待您的批准。 - 工厂 PR 上的红色 CI。 Foreman 诊断失败并推送修复到其自己的分支，从不涉及您的分支。 - 有人打开一个拉取请求。 Foreman 为审查者发布一个引导性评论：是摘要，而非审查。 ## 部署 通过 Vercel 部署 (https://vercel.com/new/clone?demo-title=eve+Software+Factory&demo-description=Software+factory+built+on+eve%3A+AI+agents+work+each+stage+of+the+development+loop%2C+and+people+make+the+judgment+calls.&project-name=eve-software-factory&repository-name=eve-software-factory-template&repository-url=https%3A%2F%2Fgithub.com%2Fvercel-labs%2Feve-software-factory-template&env=FACTORY_REPO%2CFACTORY_LABEL&envDefaults=%7B%22FACTORY_LABEL%22%3A%22factory%22%7D&envDescription=FACTORY_REPO+is+the+owner%2Frepo+the+factory+works+on.+FACTORY_LABEL+is+the+issue+label+that+hands+an+issue+to+the+factory%3B+the+default+label+is+fine.&connect=%5B%7B%22type%22%3A%22github%22%2C%22env%22%3A%22GITHUB_CONNECTOR%22%2C%22triggers%22%3Atrue%2C%22triggerPath%22%3A%22%2Feve%2Fv1%2Fgithub%22%7D%2C%7B%22type%22%3A%22linear%22%2C%22env%22%3A%22LINEAR_CONNECTOR%22%2C%22triggers%22%3Atrue%2C%22triggerPath%22%3A%22%2Feve%2Fv1%2Flinear%22%7D%5D&stores=%5B%7B%22type%22%3A%22blob%22%2C%22access%22%3A%22public%22%7D%5D&demo-image=%2F%2Fimages.ctfassets.net%2Fe5382hct74si%2F45PVqbeL5egwsqBRpGt6SQ%2F99e9f270dc22e07f499236af3a11a190%2Fimage.png&redirect-url=https%3A%2F%2Fask-foreman.dev%2Fwelcome) Vercel 部署流程会设置所有内容：GitHub 连接器、Linear 连接器、Vercel Blob 存储，以及 FACTORY_REPO 和 FACTORY_LABEL 环境变量的提示。 配置（参见 .env.example）： | 变量 | 是否必需 | 默认值 | 功能 | | — | — | — | — | | FACTORY_REPO | 是 | — | 工厂工作的 owner/repo（缺少它构建将失败） | | FACTORY_SETUP_COMMAND | 否 | — | 在构建时在沙箱检出中运行一次（例如 pnpm install），以便每次运行开始时依赖项已安装 | | FACTORY_LABEL | 否 | factory | 将 issue 交给工厂的 issue 标签 | | FACTORY_BRANCH_PREFIX | 否 | factory/ | 标记工厂自身 PR 的分支前缀，这些是自动化 CI 修复唯一会涉及的分支 | | FACTORY_BOT_NAME | 否 | GitHub App 的 slug | @提及名称，未设置时自动从连接器解析 | | GITHUB_CONNECTOR / LINEAR_CONNECTOR | 是 | — | 从 Vercel Connect 连接器 UID 自动设置 | ## 本地开发 关联您部署的项目（或新项目），拉取其环境变量，并启动 TUI： bash vercel link vercel env pull pnpm dev 将任务交给代理（“用户报告密码重置邮件收到两封，请修复它”），观察四个站点按顺序启动，最终在 FACTORY_REPO 上生成一个草稿 PR。本地运行被视为不受信任，因此对 GitHub 的更改会等待您在 TUI 中批准。 ## 资源 - Foreman 文档 (https://ask-foreman.dev/docs) - Vercel Connect (https://vercel.com/docs/connect) - Eve 文档 (https://eve.dev/docs/introduction) - GitHub Tools Eve 扩展 (https://github-tools.com/frameworks/eve-extension) ## 探索更多模板 - Eve 营销团队 (https://vercel.com/templates/eve/eve-marketing-team) - Eve 个人代理 (https://vercel.com/templates/nuxt/eve-personal-agent) - Eve Sanity Copilot (https://vercel.com/templates/eve/eve-sanity-copilot)