Software Factory

By 陈成 · Published October 29, 2026

什么是 software factory,一线怎么做,对 Qoder 意味着什么?

2026-10-28 整理,2026-10-29 补充 Matt Pocock 课程发布推文。来源:X 书签(搜 "software factory" 共 10 条)及其评论、书签里的链接、X 搜索、Reddit 搜索。

TL;DR


1. 什么是 Software Factory

几种有代表性的定义:

来源 定义
Matt Pocock(software-factory skill) 一套 agent 系统,把 tickets、PRs、定时任务变成合并的代码,跑在用户自选的远程基础设施上
Cole Murray(OpenInspect) 接收信号(issue、Slack 消息、告警、cron、用户 prompt),由 AI agent 驱动循环,转化成结果(PR、修复、回答)。他觉得更准确的叫法是"公司级 agent 基础设施"
Zach Lloyd(Warp) 围绕开发核心循环 triage → spec → implement → review → verify → ship → monitor 的自动化,每一步由 agent 和人混合推进
Addy Osmani 工厂 = 规模化的 loop。agent 在边界内干活,人在边界上做决定
Sarah(Composio) 工厂不是 agent、harness 或 skills,仓库本身就是工厂:CI、lint、类型系统是机器

自动化分级(Qodo / Itamar Friedman,借鉴自动驾驶)

级别 含义
L0–L1 人执行 / AI 辅助单点
L2 Agent 干大块活,人主动监督、串联各阶段
L3(agentic SDLC) 限定条件下能跑完交付流,但人仍是必需的审批或救援
L4(lights-on factory) 对有边界的变更类型能走完授权生命周期(验证、允许的发布、安全回退),遏制失败不依赖人立即介入;边界和演进仍由工程师拥有
L5(dark factory) 几乎覆盖全部软件工程,熄灯无人

Qodo 的建议:以"有边界的 L4"为务实目标,别空想 L5。可以对"成熟内部服务的例行变更"冲 L4,支付授权之类继续紧控。口号是 System > Agents > LLMs。

背景:dark software factory 一词较早由 StrongDM 团队推广(2026 年初,主张代码不由人写、也不由人审),Bryan Helmkamp 的 Fabro 也自称 "dark software factory"。


2. 典型架构

综合 Matt Pocock、Ben Holmes(Warp)、Vercel Foreman、Mike Fishbein 几家的流水线:

flowchart LR
  subgraph SRC[工单来源]
    A1[人: Slack / Linear / Issue]
    A2[用户反馈按钮]
    A3[监控/告警]
    A4[定时任务 cron]
  end
  SRC --> T[Triage / Explore Agent<br/>判断能否做、要不要追问]
  T -- 需要澄清 --> H0[打标签等人]
  T -- 可做 --> SP[Spec / Plan Agent<br/>验收标准 + 测试]
  SP --> IM[Implementer Agent<br/>独立沙箱 + worktree]
  IM --> CK{自动检查<br/>types / lint / tests}
  CK -- 失败 --> IM
  CK -- 通过 --> RV[独立 Review Agent<br/>不看实现者的推理]
  RV -- 不通过, 限次数 --> RW[Rework Agent]
  RW --> RV
  RV -- 通过 --> HR[人审 + 合并]
  HR --> MON[上线 & 监控]
  MON --> A3
  HR -.抽样 1/10.-> RETRO[Retro / Gardener Agent<br/>改进 skills、AGENTS.md、lint]
  RETRO -.PR.-> SP

Matt Pocock 的术语表(PR #1316 中的 SKILL.md)

只许用这些词,避免"job / workflow / session / sandbox"之类的混用:

设计原则:

  1. Start slow:"每个 trigger 都是油门,没有刹车的油门就是 slop cannon。" 三个刹车:自动检查、自动 review、人审。一次只加一个自动 trigger,先节流(如十个 bug 报告里只处理一个),loop 设重试上限。
  2. Fill every slot:服务买现成的,task 自己造。现成方案对比:
Slot 全 GitHub Linear 自建 tracker
Ticket tracker GitHub Issues Linear 自建 app
Orchestrator GitHub Actions 自建 server + DB 自建 app
Runner Actions runner Actions / E2B / Daytona / VPS 自建或沙箱
Observability 不需要 LLM tracing 平台 自建
  1. Question every task,每个 task 回答 5 个问题:什么触发?做什么、读写哪些服务?接着触发什么?人在哪里重新介入?什么能防止两个 run 做同一件事?

示例 task(EXAMPLE-TASKS.md):Explore(分诊)、Implementer、Automated review、Rework(有次数上限)、Decompose(拆大 spec)、Ratchet(每天从 lint 例外列表拿掉一个文件修好)、Fix(修工厂自身失败的 run,且不允许链式修复)、Architecture(夜间扫描重构候选)、Retro(每 10 个合并 PR 抽 1 个复盘,提 PR 改工厂自己的指令)。

一个细节坑:GitHub 内置的 GITHUB_TOKEN 产生的事件不会触发新 workflow,会悄悄断掉链条。从第一天起就该用 GitHub App 身份。


3. 一线实践案例

个人 / 小团队

团队 / 公司

设计 / 非代码


4. 开源 / 产品一览

名称 定位 链接
mattpocock/skills software-factory 设计工厂用的术语表 skill(PR 未合并),配 /grill-me 使用 PR #1316
Software Factories for Real Engineers(Matt Pocock / AI Hero) 两周 cohort 课程,11/9 开课;从软件基本功(review、代码库设计、DDD、变异测试、反馈回路)讲到工厂 spec aihero.dev
Sandcastle(Matt Pocock) TS 原语 sandcastle.run(),在 Docker/Podman/Vercel 沙箱里跑 agent,管 worktree、事件、token、断点续跑;支持 Claude Code、Codex、Pi github ⭐8.6k
OpenInspect(Cole Murray) 仿 Ramp Inspect 的后台 agent 系统:Web/Slack/GitHub/Linear/webhook 入口,定时与事件自动化,多人协作 github ⭐3.4k
Open Agents(Vercel) 云端 coding agent 参考平台;关键设计是 agent 不跑在沙箱里,通过工具操作沙箱 github ⭐5.8k
Foreman(Vercel) 给 issue 打 factory 标签 → Classifier / Analyst / Implementer / Reviewer 四个 agent → draft PR;合并不在工具面里 github
Fabro "dark software factory",在 agent 会话外套一层确定性工作流图,单个 Rust 二进制 github
Warp factory examples Factories as Code 示例,含 triage agent 的指令 github
Factory(Droid) 商业产品,桌面 app、Slack、多模型路由、Droid Computer factory.ai
Forgeo 个人做的 backlog 守护进程式工厂 github
simoncorry/foundry 个人版 github

5. 反复出现的设计原则

  1. 生成者和评审者分离:"学生不改自己的作业。"reviewer 只看推送上来的分支,看不到实现者的推理(Foreman、Fishbein)。不过 Qodo 提醒:再起一个叫 reviewer 的 agent 并不等于独立;验收标准得有独立的权威来源,防止 agent 改考题。
  2. 合并权留给人:Foreman 根本不给 agent 合并工具;Matt 的设计里 run 永不等人,人的动作就是下一个 trigger。
  3. 确定性闸门比 prompt 强:lint、类型、测试优先于 skill 里的文字说明(Sarah、Matt 的 ratchet task)。
  4. 先度量,再自我改进:给对话打分 → 改 skill → 用分数验证(Warp);成功的 run 变成 eval(dex)。小心 Goodhart:分数高不等于代码好,仍需人抽检。
  5. Runner 无状态,记忆放在 tracker / git:便于并行、断点续跑和审计。
  6. 限次数 + 熔断:rework 循环设上限,到了交给人;夜间 loop 有熔断,防止越挖越深。
  7. 防重复:两个 run 不做同一件事,同一来源不重复建票,并行 workstream 不碰同一块代码。
  8. 路由与成本:规划用强模型,执行用便宜模型;由组织级路由来选模型,而不是每个人自己挑。
  9. 仓库要对 agent 友好:就近放置、端到端类型、允许局部重复。
  10. 先装刹车,再踩油门:质量约束先于吞吐。Matt 把刹车列为 review、代码库设计、DDD/统一语言、变异测试、反馈回路,都是老的工程基本功,不是新工具。
  11. Spec 用完即弃:spec 是到代码为止的中间产物(Matt),不必当成长期维护的文档;长期的真相在代码、测试和类型里。

6. 质疑与冷思考(来自评论区和 Reddit)


7. 落地建议(综合)

flowchart TD
  S0[先 grill:真的需要工厂吗?<br/>想让它拦住哪种失败?] --> S1[选一类重复、低风险的工作<br/>例: lint ratchet / 依赖升级 / 小 bug]
  S1 --> S2[先装刹车<br/>类型 + lint + 测试 + 独立 review + 人审]
  S2 --> S3[一次加一个 trigger,先节流<br/>loop 设上限]
  S3 --> S4[度量<br/>成功率 / 每次成功的成本 / 人工介入点]
  S4 --> S5[外环 gardener<br/>抽样复盘 → 改 skill、lint、AGENTS.md]
  S5 --> S6{指标达标?}
  S6 -- 是 --> S7[放开节流 / 扩到下一类工作]
  S6 -- 否 --> S2
  1. 先用 /grill-me 加 Matt 的 software-factory 术语表做设计,回答清楚 5 个问题。
  2. 起步阶段全部放在 GitHub 上(Issues + Actions + App 身份),不需要专门的可观测性平台。
  3. 投入优先级:仓库的 agent 友好度 > 确定性闸门 > 独立 review > 编排。
  4. 尽早接 retro / gardener 外环,让工厂自己变好;否则每次熔断都只是人在擦屁股。

8. 对 Qoder 意味着什么

不少设计目前是"已定方案、未实施"或"暂缓",下文按实际状态写,不把设计当成已上线功能。

8.1 一句话

Qoder 的领域模型(Issue / Agent / ChatSession / Turn + Human Owner)几乎就是 Matt 术语表里的 tracker + task + run,槽位基本齐全,缺的正好是业界最强调的那部分:刹车和外环。另外,"Issue 被指派后自动开工"这条主链路目前没有上线:客户端 Issue Execution 从未发布,相关代码正在删除。按 Qodo 的 L0–L5 分级,产品现在处于 L2:人从 Issue 点"开始处理",Agent 干一大块活,人自己验收。

8.2 槽位对照:Matt 的术语 → Qoder 现状

工厂槽位 Qoder 对应物 状态
Ticket tracker(人机界面) Team Project → Issue,状态对齐 Multica:backlog/todo/in_progress/in_review/done/blocked/cancelled ✅ 已有
Task(定义一次,跑多次) Agent(可复用配置:指令、模型、Skill、MCP)+ Automation 任务模板 ✅ 已有,但 Agent 是"人设",不是 explore / implement / review 这种职能 task
Trigger:人工 Issue"开始处理"→ 绑定该 Issue 的个人 ChatSession(RuntimeOwner,只能读、改字段和标签,不能发评论) ✅ 已有(10/09 起)
Trigger:@ / 指派 Discussion 里 @Agent 即执行;Issue 评论 @ 和指派自动执行 Discussion ✅;Issue 侧 ❌ 未上线
Trigger:定时 本地 Automation(at/every/cron,每任务最多 1 running + 1 pending,溢出记 missed/queue-overflow);云端 Automation 走 RM,间隔 ≥ 60 分钟 ✅ 已有
Trigger:事件(PR、CI 失败、告警) Trigger Registry 只注册了 schedule,"缺失 Provider 的事件触发必须显式失败" ❌ 留白
Ticket source:IM / 反馈 IM 宿主 + 钉钉/企微等渠道包可以起 ChatSession;Crash 自动生成完整 Issue Report ⚠️ 进的是会话或支持侧,不进 Issue
Runner 本机 ChatSession、Worktree 模式(detached worktree)、Remote SSH Execution Host、Peer Device、Qoder Cloud Agent(QCA Environment) ✅ 种类很全;但默认跑在用户桌面上,不是一次性 runner
Orchestrator 刻意不做:"服务端只保存状态投影,不另建执行调度引擎" ❌ 设计上不做
多 agent 协作 Agent Team = 带团队关系的 Discussion,@ 谁谁执行,TL 负责协调(尚未完成实现) ⚠️ 进行中
刹车:人审 Turn 完成只到 in_review,done 必须由 Human Owner 验收;Waker(数字员工)必须挂一个 Human Sponsor ✅ 理念与 L4 一致;Waker 暂缓
刹车:自动检查 / 独立 review / rework 上限 无。Turn 结束和 in_review 之间没有任何确定性闸门 ❌ 缺
防重复 sourceEventId 冻结身份、请求幂等键、指派幂等、(Issue, Agent) 绑定唯一 ChatSession、queued/running 时禁止关闭范围 ✅ 比多数 DIY 工厂做得扎实
外环:自我改进 Skill 自进化(SDK evolution.skill):推荐 → 用户确认 → 新会话加载 skill-creator 改 skill,写入有 hash 核验 ⚠️ 只针对个人会话,Automation 会话明确不注入;没有按 run 打分、抽样复盘
可观测性 五个执行状态 + 埋点 + Feedback 诊断归档 ⚠️ 没有按 Issue 统计成功率、成本、人工介入次数

8.3 Qoder 已经站在对的一边的地方

  1. 合并/验收权留给人:in_review ≠ done、Human Owner 和执行目标分开、Waker 必须有 Sponsor。这与 Foreman 不给合并工具、Qodo"边界由工程师拥有"是同一个判断,可以直接作为对外的 L4 叙事。
  2. 幂等和身份冻结:sourceEventId、Turn outbox、终态幂等、Squad/Agent revision 在首次物化时固定到 TurnAgentSnapshot。Matt 的第 5 问("什么能防止两个 run 做同一件事")和 Fishbein 评论区提的"过期的已通过状态",Qoder 在协议层已经回答了。
  3. Runner 选择面宽:本机、Worktree、SSH、Peer、Cloud 共用一套 ChatSessionRuntime。Cole Murray 说控制面、沙箱、harness 已经商品化,这部分 Qoder 不缺。
  4. 人机介入结构化:澄清和授权是结构化请求,可以回到 Issue 或 Discussion,而不是像 Fred Jonsson 那样只能屏蔽 AskUser hook。

8.4 风险:按 Matt 的说法,Qoder 现在是"只有油门"

8.5 建议(按投入产出排序)

  1. 把"刹车"做成产品能力,而不只是多加几个 trigger。在 Turn 完成到 in_review 之间加一个"闸门"阶段:项目级配置的确定性检查命令(typecheck / lint / test),失败自动回到同一 ChatSession 修,带重试上限,超限转 blocked 并 @ Human Owner。这是 Matt 课程的核心卖点,也是 Qoder 状态机里最便宜的一刀。
  2. 独立 Review 作为一等 task:起一个不继承实现者 ChatSession 的 reviewer 会话,只给它 diff / 分支和验收标准,结果写回 Issue 评论。不要用 Team / Discussion 承载,否则就没有独立性。
  3. 补事件 Trigger Provider:Trigger Registry 已经留好了位置。第一批只接 Git host(PR 打开、CI 失败、Issue 打标签),对应 Foreman 的"打 factory 标签触发"。上线时默认节流,例如每个项目同时最多 N 个 run。
  4. 让 Crash / Feedback / IM 能进 Issue:现在它们进的是支持侧或单个会话。"监控 → 自动建 Issue → triage agent"是 Warp、Matt 架构图里闭环的最后一段,Qoder 的诊断归档已经比多数团队完整。
  5. Issue 接 Cloud Runner:QCA 和云端 Automation 已经证明云端链路可行。Issue 执行能选云端以后,"关电脑也能跑"和"一次性 runner"两个前提才成立。
  6. 外环:从个人 Skill 进化扩展到项目级 Retro。Skill 自进化的推荐、确认、核验链路已经有了;缺的是输入源,即按 Issue 结果(是否一次通过闸门、被人打回几次、花了多少 token)打分,每 N 个 done 抽 1 个复盘,以 PR 的形式改项目 AGENTS.md、Skill 或 lint。对应 Ben Holmes 的 gardening 和 Matt 的 Retro task。
  7. 定位:一线实践者普遍主张"自建并拥有"。Qoder 不必和他们争,可以对齐 Matt 的"服务买现成的,task 自己造":Qoder 提供 tracker、runner、闸门和可观测性,task(职能 Agent + Skill + 触发规则)由团队在仓库里自己定义和版本化。
  8. 先在自己身上用(dogfood):Qoder 仓库有分层的 AGENTS.md、完整的架构决策记录和多项机器检查,本身就是 Sarah 说的"仓库就是工厂"。可以先挑一类有边界的工作冲 L4,比如 Matt 的 Ratchet(每天从 lint 例外里修掉一个文件)、i18n 与 gui:inventory 台账同步、图片 WebP 化(images:prepare 已经是确定性流程)。用 Qoder 自己跑,拿到成功率和每次成功的成本,再决定对外怎么讲。

参考链接

X 书签(及评论)

X 搜索

Reddit

代码 / 文档

Read this report as Markdown · Cite it (BibTeX)