
AutoCraft:用AI模型流水线管理GitHub仓库积压issue和PR
来源标题:AutoCraft: Harness for maintaining GitHub repositories with a large backlog
AutoCraft 是一款用于维护积压大量 issue 和 PR 的 GitHub 仓库的模型工具,可将所有 issue 与 PR 镜像到本地数据库并运行模型流水线处理。它调用 Claude Haiku、Sonnet 和 Opus 进行分类、排优先级、查重、请求维护者决策、审查、编写修复、验证和合并,安全操作自动执行,其余由模型提议、人工确认。该工具最初为 storytold craft 应用开发,也可通过 autocraft-server 跟踪其他组织或用户的仓库。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
AutoCraft 是一个模型 harness,用于维护积压量很大的 GitHub 仓库。它把每个 issue 和 PR 镜像到本地数据库,并在其上运行一条由多个模型步骤组成的流水线。Jev 分类器与模型 Sonnet、Opus 一起,负责分类、排定优先级、查找重复项、向维护者请求决策、审查、编写修复、验证和合并。
模型可用的工具是一组固定的 GitHub 操作(评论、标签、分支、PR、合并),全部经由同一个写入模块,并配有 safe-merge 风格的检查。在规则判定为安全的地方,操作自动执行;否则由模型提出建议,再由人工确认。每个 issue 和 PR 都有自己的一段 Opus 与维护者之间的对话,并附有维护者可以执行的操作卡片。整条流水线围绕维护者的判断力来设计——判断力才是稀缺资源,token 成本不是。
AutoCraft 最初是为 storytold 的 craft 应用编写的,现在也能跟踪其他 GitHub 组织或用户拥有的仓库:通过 autocraft-server repos track owner/name,无需修改源码。命名方式和 GitHub App 同步的限制见 Track repos and sync。
各阶段按以下顺序运行。每个阶段的细节、限制和规则见 docs/pipeline.md。
图中是 dashboard 的首页(模拟数据)。每一列是一个阶段及其计数,列上方的标签列出等待人工处理的事项。
不可信代码只在独立的构建环境中运行(一个以另一个 OS 用户身份运行的 worker,配合 rootless Podman),绝不在持有 GitHub 或 Claude 凭据的环境中运行。
使用工具的模型调用在 bubblewrap 沙箱内运行。它们可以对公开跟踪仓库的只读检出执行 Read、Grep 和 Glob,可以使用一个 Haiku 探索子代理,并可以在公开条目的快照上使用只读的条目工具(search、item、similar items、PR diff)。其他调用不带工具运行。
只有 src/github/write.ts 会写入 GitHub。每一次写入都会记录到审计表中,如果有其他文件执行写入,测试就会失败。
每一次对 GitHub 的写入都需要操作员对该仓库的批准。批准在 dashboard 上给出,不能从 CLI 设置。
dashboard 需要 GitHub 登录。角色分为 operator(回答、批准、开关、账户)、maintainer(读取和评论)和 viewer(只读)。
贡献者自己的 agent 通过 dashboard 上的 MCP server(POST /mcp)携带个人 token 进入 Inbox。它们以所属用户的角色行事,回传的内容属于反馈,与 dashboard 的 Feedback 框相同:仍需由 operator 回答。MCP 的决策回答和撤销目前被禁用(src/dash/mcp/index.ts 中的 answering.enabled),在配置了 GitHub App 登录时也是如此。请在 dashboard 上回答决策。
一个流水线开关(开/关)可以关闭整条流水线,按仓库的流水线开关可将其限制在选定的仓库上,每个步骤还有每日限额。
见 Trust boundary。
Items 是一个可筛选的列表;点击某一行,其详情会在该行下方就地展开。Needs you 会在所选决策旁显示决策队列,连同其 Evidence、Discussion 和条目时间线。条目页面同时展示 AutoCraft 侧和 GitHub 侧。UI 设计文档描述了布局和筛选方式。
Requirements
Needed Used for
Node 24 or later (engines in package.json), pnpm 直接运行 TypeScript;通过内置的 node:sqlite 使用 SQLite
gh, logged in 同步(gh api graphql)以及所有 GitHub 写入
git 克隆、diff 和推送
claude (Claude Code CLI) 所有 Claude 调用
bwrap (bubblewrap, /usr/bin/bwrap) 使用工具的调用的沙箱。没有它时,这些调用将不带工具运行;AUTOCRAFT_NO_SANDBOX=1 会强制如此
jev (optional) TypeSafe 的 Jev 模型的 CLI,供 classify、priority 和 duplicate 步骤使用(jev --compact ask)。没有它、被关闭(autocraft-server accounts jev off),或其账户余额耗尽、密钥被拒时,由 Haiku 通过 Claude 账户完成 Jev 的工作(Claude 用量增加)
Podman and a second OS user Verify 和 Fix 的构建环境(可选)
sqlite3, curl deploy/backup.sh 和 deploy/hook.sh
Install
git clone https://github.com/storytold/autocraft.git cd autocraft pnpm install pnpm -C web install && pnpm -C web build # writes web/dist node src/cli.ts # lists every command
autocraft 是 package.json 的 bin;node src/cli.ts <command> 运行的是同一个程序。数据库由 $AUTOCRAFT_DB 指定,默认是 ~/.local/share/autocraft/mirror.db。
Sync 需要 gh 登录一个对跟踪仓库有读取权限的账户。同一个账户会在操作员批准的仓库中执行写入(标签、评论、关闭、推送、合并),因此它需要在这些仓库有写入权限。
将 client ID、client secret 和一个随机会话密钥(至少 32 个字符)写入一个权限为 0600 的 JSON 文件: { "github_client_id": "..."
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。