GitHub 趋势 · 第 59 期
给 AI 写了 121 KB 规则，给用户只写了 11 KB
#AI-Agent#开源工厂#许可合规
今天 Go 分语言日榜上当日新增最多的新面孔是 superplanehq/superplane（+377）。它自己的口号是 open source factory（开源工厂）：把 backlog 里的 issue 交给 AI agent，最后吐出一份等待评审的 PR。Apache-2.0，7,113 star，背后是一家公司在运营。
把它挖出来的原因不是动量，是一个数字：这个仓库里给 AI 写的规则文件合计 121,230 字节，而根目录里两份面向人类入口的文档合计只有 11,437 字节。
先给结论：工程质量看得见，但它不是给「clone 下来就能跑」的人准备的产品。README 全文 5,398 字节，里面没有一行安装命令；想自托管，你能依赖的安装物是 releases 里一个 1,493 字节的脚本，加一个 4,080 字节的单机包。而它给 agent 写的规则里有两条全大写的红线。
一、判断一个 AI 项目值不值得看，我现在干两件事
大部分人看一个让 AI 干活的项目，先看宣传页和 demo 视频。这两年我越看越觉得性价比最高的是另两个动作，广告里写不出来：
- ▪数一数它写给 AI 的规则文件和写给人的文档，哪一边更厚；
- ▪看它发钱的时候，要求谁来署名。
两个动作都不需要跑代码，五分钟能做完。SuperPlane 恰好在这两个问题上给出了很极端的答案。
它的悬赏页写着：必须由人类 GitHub 账号开 PR，而且 PR 里必须附一段演示视频。一个专门让 AI 自动干活的开源项目，在付钱条款里把署名权留给了人。
二、SuperPlane 是什么
README 的自我介绍是一句：「SuperPlane turns high-confidence backlog issues into verified, review-ready pull requests so engineers can focus on work that needs judgment.」
它在中间扮演调度者：接 issue、拉编码 agent、跑 CI、等人审批、把失败的上下文塞回 agent。README 对边界也写得清楚：「Ambiguous work and decisions that need human judgment stay with your team.」模棱两可的活和需要判断的决定，它不接。
| 字段 | 值 |
|---|---|
| 仓库 | superplanehq/superplane（owner 类型：Organization） |
| 开源许可 | Apache-2.0 |
| star / fork | 7,113 / 635 |
| 未关闭 issue | 621 |
| 默认分支 | main |
| 建仓 / 最后推代码 | 2025-05-07 / 2026-09-12 |
| 自标状态 | beta（README 徽章 status-beta） |
| 技术栈 | Go（gRPC + REST/OpenAPI 网关）+ TypeScript/React（Vite） |
| 必备依赖 | PostgreSQL（状态）+ RabbitMQ（消息） |
| 仓库体积 | 454,116 KB（约 443 MB，API 的 size 字段） |
三、它把「工厂」拆成了五个词
README 里有一张字典式的表，把自己的业务抽象成五个资源。这张表写得像数据库 schema，读起来像一份规格书：
| 资源 | 它在 README 里的职责 |
|---|---|
| Factory | 持有 work order、automation line 与团队策略 |
| Work order | 记录一个被委派的任务，从接入到最终结果 |
| Line | 定义处理一个 work order 的有序阶段 |
| Automation | 跑 agent、调工具、等事件、或要求审批 |
| Run | 跟踪一步的持久执行、输入输出、重试与成本 |
第二张表是它能接上的东西：六个领域，README 点名 35 个第三方。
| 领域 | 点名的集成 |
|---|---|
| AI 与编码 agent | Claude、Cursor、OpenAI、OpenRouter、Perplexity |
| 源码管理与 CI | GitHub、GitLab、Bitbucket、Semaphore、CircleCI、Harness |
| 云与交付 | AWS、Google Cloud、Azure、Cloudflare、Docker Hub、Render |
| 可观测 | Datadog、Grafana、Honeycomb、New Relic、Prometheus、Sentry |
| 事故与服务 | PagerDuty、Rootly、FireHydrant、incident.io、Jira、ServiceNow |
| 通信 | Slack、Discord、Microsoft Teams、Telegram、SendGrid、SMTP |
宽度不是纸上谈兵：最新版本 v0.30.0 的发行说明里，单一版本就录了 Linear 入局、GitLab 一批触发器与组件，还有一个新的 Run Claude Code 执行组件。
四、真正的交付物在 releases 里
最新版本 v0.30.0 于 2026-07-27 发布，挂了 7 个资产。这七个东西基本上就是一个自托管用户能拿到的全部：
- ▪install.sh—— 1,493 字节，官方唯一一个面向用户的安装脚本；
- ▪superplane-single-host.tar.gz—— 4,080 字节；
- ▪CLI 二进制四份（macOS 与 Linux 各两种架构）：macOS amd64 49,283,008、macOS arm64 47,007,426、Linux amd64 47,732,715、Linux arm64 45,152,008 字节；
- ▪superplane-sbom.json—— 2,200,598 字节。
这个组合有一个很别扭的对比：四个 CLI 二进制每个 45–49 MB，而那个 single-host 包只有 4 KB。4 KB 装不下任何东西，它只能是一个引导脚本；我没有拿到这个 tar.gz 的内容，只看到大小，所以不替它下结论。另外，这四份二进制里没有 Windows。
还有一件事值得记：代码每天在推，版本停在 47 天前。仓库的最后一次 push 是今天，而最新发行版 v0.30.0 距今 47 天。更微妙的是版本说明本身：同一份 changelog 里，新增 canvas 节点清理 worker 与回滚同一条 worker 并列，修复卡死的循环执行与回滚这个修复并列——一个版本里自己撤回了两件新东西。
五、上手：三行命令，全在 Docker 里
README 里跟上手有关的只有一句：「Contributor setup is Docker-based.」然后它把你交给 AGENTS.md 与 CONTRIBUTING.md。能真正跑起来的三行命令在 CONTRIBUTING.md 里：
git clone https://github.com/YOUR_USERNAME/superplane.git cd superplane make dev.up # Build images and start containers (Postgres, RabbitMQ, app shell, …) make dev.setup # Codegen, Go + JS deps, database create/migrate (run inside the app container) make dev.server # Start air + Vite (UI at http://localhost:8000)
三个前提：macOS 或 Linux、Make、Docker。AGENTS.md 里连 Go 版本都钉死了（go.mod 里钉着 1.26.2，由开发容器提供），主机上不需要装 Go 或 Node，UI 起在 http://localhost:8000。
但请注意，这是贡献者路径，不是产品安装路径。要跑真正的 factory（让 agent 真去改你的 GitHub 仓库），你还得另外起一个 runner 仓库、在组织里连上 GitHub 与 Claude 集成；AGENTS.md 里写明，没有 SUPERPLANE_GITHUB_APP_* 几个环境变量，本地 onboarding 直接走不通。
六、那个 10.6 倍
回到开头的第一个动作。把仓库根目录里给 agent 用的文件逐个量一遍，结果是这样：
| 目录 / 文件 | 个数 | 合计字节 |
|---|---|---|
| AGENTS.md | 1 | 13,012 |
| CLAUDE.md | 1 | 27 |
| .agents/skills | 7 | 44,033 |
| .cursor/skills | 4 | 33,717 |
| .cursor/rules | 5 | 9,727 |
| .cursor/commands | 7 | 20,714 |
| 合计 | 25 | 121,230 |
对照组是人类的两个入口：README 5,398 字节 + CONTRIBUTING 6,039 字节 = 11,437 字节。前者是后者的 10.6 倍。
这些文件的语气也值得读一遍。AGENTS.md 第一条就是：「Read this file in full.」紧接着另一个小标题：「Do not rediscover the build system.」划红线的那两条则是全大写的：「NEVER MANUALLY CREATE MIGRATION FILES.」「NEVER DROP LOCAL DATABASES WITHOUT ASKING.」
同一份文件里还写明了 CI 是 Semaphore（.semaphore/ 里 6 条流水线）而不是 GitHub Actions，并且反复提醒不要去重新探测构建系统。
还有三份「不许变差」的基线文件直接入库：.go-coverage-baseline.json（2,991 字节）、.models-tx-debt-baseline.json（24,345 字节）、.configuration-fields-baseline.txt（3,238 字节）。AGENTS.md 里有一句直接的说法：CI 在 ESLint 预算变大时会失败。
七、我的判断
适合谁：团队里已经有稳定的 GitHub + CI + Slack 链路，想让 agent 处理那些「谁都能做但没人想做」的 issue（改文案、补测试、升级依赖），并且愿意接受 beta 状态和自托管的运维成本。35 个集成名字不是虚的，覆盖面确实宽。
不适合谁：想要开箱即用的人。README 没有安装命令，单机包 4 KB，权限模型、审批、多租户这些要自己趟。不想碰 Docker 与 Postgres + RabbitMQ 这套中间件的人也不用考虑。
三个要留意的点：
- ▪未关闭 issue 621 个 / 7,113 star，每 100 star 对应 8.7 个未关闭 issue；仓库 API 返回的订阅数（subscribers_count）是 9。这两个数字我都是原样引用，没有去解释它们为什么长成这样。
- ▪它自己挂着 beta 徽章，且最新版本已经 47 天没动；
- ▪悬赏条款里最硬的一条：PR 必须由人类账号开，并且必须附一段演示视频。官方写的是「A human GitHub account must open the pull request」与「AI tools are welcome; human judgment and polish must drive the work」。
公平地说一句：AGENTS.md 的第一行写明这份文件同时面向 AI coding agents 与人类贡献者，所以 121 KB 不等于「只给 AI 看的文档」。但 .agents/skills 与 .cursor/ 下的 23 个文件是 agent 配置，人类读它们的场景确实少得多。
八、数据与出处
地址：https://github.com/superplanehq/superplane
star：7,113（Trending Go 日榜与仓库 API 一致，635 fork 也一致，本期无口径差）；今日新增 +377
榜单出现情况：仅 Go 分语言日榜；全语言日榜（16 条）、周榜（23 条）、月榜（23 条）均未收录
许可：Apache-2.0。LICENSE 11,353 字节为标准全文，附录署名 Copyright 2025-present SuperPlane Inc. —— NOTICE 587 字节写 Copyright 2026 SuperPlane, Inc. —— 两处年份不一致，按原文引用
状态：archived=false、disabled=false，README 自标 beta
发行：v0.30.0（2026-07-27），7 个资产
未核实项：① superplane-single-host.tar.gz 的内容；② 悬赏的真实数量——悬赏页靠 JS 渲染，静态抓取只能看到 Open bounties (0) 与 Unable to load bounties. Please try again later. 两句，我不把 0 当结论
数据来源：GitHub Trending 官方页面与 GitHub REST API，抓取时间 2026-09-12 12:3x（GMT+8）
你所在的团队有没有把「改文案、补测试、升级依赖」这类活交给 agent？卡在哪一步，欢迎在评论区说说。
下一期：如果榜单上出现动量更高的新面孔，就回到单项目精读；如果没有，就换一个主题族做横向合集。现在还挂着一笔账：「把模型塞进小设备与边缘」那一族。
#AI-Agent#开源工厂#许可合规
GitHub 趋势 · 第 59 期