文献地图 · 2026

AI 原生开发与智能体编码:
谁在真正把经验写下来

这份清单只收「有人真的跑过一遍」的文档:给出机制的工程博客、给出数字的落地报告、给出判断的实践者自述。 分两个栏目——技术大牛(个人实践者的方法论)与公司(团队级的生产化经验), 均按公开发布时间降序,并按可复用程度给 1–5 星。

27篇文档
10个人 · 大牛
17公司 · 团队
16五星必读
01–102026 时间跨度
按重要度筛选 27 / 27
01

技术大牛

个人视角的价值在于「可模仿」:他们公开的是自己每天怎么开窗口、怎么写规则文件、在哪一步停下来人工看一眼。 以下 10 位作者都在生产环境里长期使用,而不是评测一次就写结论。

2026.08.20 ★★★★★

「我能向别人解释这段代码吗」才是上线金标准

Simon Willison(Django 联合创造者)· Talking Postgres Ep 42;亦见其持续更新的《Agentic Engineering Patterns》

测试通过与「意图正确」是两件事。解释动作同时验证理解深度与意图保真,这是 agent 时代唯一低成本的双重校验。

  • 红绿 TDD 是核心验证范式:先写失败的测试,逼 agent 跑到每一行;file revisitation 指标显示「没跑到的代码」就是静默失败
  • 当 feature 边际成本趋零,决策从「做什么」变成「哪些不该做」——工程管理能力比编码能力更稀缺
  • 同名指南把 Git 定位成 agent 的时间机器:bisect 定位回归、revert 救场、子 agent 只为省上下文而不为炫技
验证闭环认知债 访谈精读 ↗
2026.07.08 ★★★★★

Bun 从 Zig 重写为 Rust:53.5 万行、11 天、64 个并行 agent

Jarred Sumner(Bun 作者)· Rewriting Bun in Rust,Simon Willison 转述与拆解

「如何评审一个 +100 万行的 PR?」答案是:不要评审代码,要评审生成代码的流程。

  • 决定性前提:Bun 的测试套件用 TypeScript 写,天然成为语言无关的 conformance suite,agent harness 才能自动对照移植
  • 手段不是一次性大改,而是动态 workflow + 试跑 + 对抗式评审(adversarial review)的组合编排
  • 代价公开:59 亿非缓存输入 token、720 亿缓存读取,按 API 价约 16.5 万美元;出错时修的是 loop,不是手改产物
大规模迁移对抗评审成本 simonwillison.net ↗
2026.05 ★★★★★

新的软件生命周期:10% 是模型,90% 是 harness

Addy Osmani(前 Google Cloud AI Director)· The New Software Lifecycle,Google 白皮书配套长文

「把标准设在 eval,而不是 demo。」同一句话决定了你落在 vibe coding 还是 agentic engineering。

  • hardness 可测:只改 harness、模型不动,Terminal Bench 2.0 上就有团队从 30 名外进到前 5;LangChain 靠系统提示与中间件加了 13.7 分
  • 静态上下文(每轮都加载,贵而可靠)vs 动态上下文(按需加载,便宜),这条边界应当作架构决策进 PR 评审
  • eval 要拆成 output eval(结果对不对)与 trajectory eval(路径是否合理)——看起来对但跳过了检查,比明显错更危险
Harness上下文工程Eval addyosmani.com ↗
2026.04.30 ★★★★★

Vibe coding 抬地板,agentic engineering 保天花板

Andrej Karpathy · Sequoia AI Ascent 2026 对谈;概念首发于 2026.02.04 的 X 长帖

Agent 是「有尖刺的实体」:能力很强、随机性很高。工程的职责是把它放进有边界、有验证、有回滚的流程里。

  • 四条专业动作:先写详细规格再 prompt;批判性审 diff(正确性 + 安全);设计自动评估回路;管理 agent 在代码库里的权限
  • 他点名 eval 设计是连资深工程师都最欠练的一项技能
  • 反例来自他自己的 MenuGen:agent 用 email 串 Google 与 Stripe 账号,用户付了钱却没到账——高阶设计决策仍会犯低级错误
范式定义规格先行 The New Stack ↗
2026.04.02 ★★★★★

Harness 工程学:给编码 Agent 装前馈与传感器

Birgitta Böckeler(Thoughtworks Distinguished Engineer)· martinfowler.com

只有反馈没有引导,agent 会重复犯同样的错;只有引导没有反馈,agent 会把规则编码进去却永远不知道是否奏效。

  • 二维矩阵:Guides(事前引导)/ Sensors(事后感知)× 计算式(linter、类型检查、结构测试,毫秒级可靠)/ 推算式(AI 评审、LLM as judge,慢而概率性)
  • 最有效的传感器是「为 LLM 消费优化过的信号」——自定义 linter 报错里直接写修复指令,一种正向的 prompt injection
  • 预言了一个趋势:harness 会像今天的服务模板一样被预制,「团队按有哪些现成 harness 来选技术栈」
Harness架构约束 martinfowler.com ↗
2026 · 年中 ★★★★★

仓库意外变成了 agent 之间的黑板

Giles Edwards-Alexander(Thoughtworks EMEIA CTO)· An Accidental Blackboard

10 个工程师 4 天造出航司 IROps 系统。真正的发现不是速度,而是多个 agent 自发用 repo 里的 plan 文件完成了协同。

  • 起因是一条纪律:agent 必须持续 commit 并从 main rebase;副作用是 plan 的进度更新随代码一起被其他 agent 看见
  • 一个 agent 把 plan 某行标为 in-progress,另一个就绕开;完成后对方不仅知道可以接手,还拿到了实现说明
  • 这是经典 blackboard 模式的自发涌现——协调结构不是设计出来的,是被 commit 纪律逼出来的
多 Agent 协同涌现行为 martinfowler.com ↗
2026.02.05 ★★★★★

一个怀疑论者的六步 AI 采纳路径

Mitchell Hashimoto(Vagrant / Terraform / Ghostty 作者)· My AI Adoption Journey

「我不打算跑多个 agent,也不想跑。」在一个人人比并行数的时期,这是最有信息量的反向样本。

  • 第二步最狠:每件事做两遍——先手工做完,再逼 agent 在看不到答案的前提下做出同等质量,靠摩擦换取对边界的直觉
  • 第三步把下班前 30 分钟用来布任务(深度调研、模糊探索、Issue 分诊),换取次日「热启动」
  • 第五步 harness engineering:agent 每犯一次错,就工程化一个方案让它永不再犯;Ghostty 的 AGENTS.md 每一行都对应一个历史失败案例
  • 刻意关掉桌面通知——上下文切换比等待更贵,由人决定何时打断 agent
Harness人机节奏技能形成 mitchellh.com ↗
2026.01.02 ★★★★★

Claude Code 作者自己的 13 条日常配置

Boris Cherny(Claude Code 创造者,前 Meta Principal Engineer)· How I Use Claude Code

「给 Claude 一个能验证自己工作的方式,最终质量会提升 2–3 倍。」其余 12 条都是这句话的配套。

  • 并行不是目的:终端 5 个 + 网页 5–10 个,靠编号标签与系统通知调度,本质是把 agent 当工人池而非助手
  • 团队共享一份进 git 的 CLAUDE.md,看到 Claude 做错就补一条——他称之为 Compounding Engineering(复利工程)
  • 多数会话从 Plan mode 起步,谈妥计划再切自动接受;/permissions 预授权代替 --dangerously-skip-permissions
  • 长任务用后台 agent 或 Stop hook 做确定性复核,而不是靠人盯
工作流规则文件并行 13 条整理 ↗
2026 · 年初 ★★★★★

编码 Agent 的上下文工程:从巨型 AGENTS.md 到分层入口

Birgitta Böckeler(Thoughtworks)· martinfowler.com,Exploring Gen AI 系列

「上下文工程 = 策展模型看到的东西,以得到更好的结果。」所有配置最终都是一堆 markdown,区别只在加载时机。

  • 区分 instructions(让它做某事)与 guidance(它应遵守的通用约定),两者常混但值得分开管理
  • 提出「上下文接口」概念:tools / MCP servers / skills 都是「告诉 LLM 还能去哪拿上下文」的描述
  • 提醒先反思代码库本身是否 AI-friendly——现有代码就是最强的上下文来源
上下文工程Skills martinfowler.com ↗
2026 ★★★★★

把 AI 辅助编码当作一门真正的工程学科

Gene Kim & Steve Yegge· Vibe Coding: Building Production-Grade Software(IT Revolution)

写给组织而非个人:当模型写掉大部分代码,意图与心流比语法更重要,但质量纪律一条都不能少。

  • 与 Addy Osmani 的《Beyond Vibe Coding》构成一对:一本面向个人开发者,一本面向工程组织
  • 作者组合本身是信号——Phoenix Project 的组织视角 + 前 Google/Amazon/Sourcegraph 的一线视角,序言由 Dario Amodei 撰写
组织视角书籍 书目与定位 ↗
02

公司

团队级文档的看点是「约束条件下的取舍」:几百万行遗留代码、支付级合规、移动端编译链、几千名工程师的治理。 2026 年的一条主线很清楚——瓶颈从「生成」移到了「验证」与「环境」。

2026.10.22 ★★★★★

给 AI Agent 一台能编译、能作证的远程机器

Shopify Engineering· We gave AI agents a mobile dev environment

「把工作交出去的能力,已经超过了把工作跑起来的能力。」瓶颈不在模型,在机器与可观测性。

  • Remote Dev:每个 River 会话配一台远程 Mac,经 SSH 接入;Android 模拟器因 macOS 不支持嵌套虚拟化,被放到独立 Linux VM 上再挂回同一会话
  • 温机池把巨型单体仓库的环境准备从 30+ 分钟压到几分钟;长任务放进 tmux 窗格让 agent 实时观察,而不是 sleep 硬等
  • 验证做成可见证据:先录故障、再录修复前后对比;Live Preview 用 WebSocket 把模拟器推到浏览器,非移动同事也能直接试
  • 结果:River 在移动端合并 PR 中的占比从 6% 升到 61%
验证闭环开发环境移动端 shopify.engineering ↗
2026.10.15 ★★★★★

Meta Forum:从 human-in-the-loop 走向 human-on-the-loop

Meta Engineering· Forum 应用的 AI 原生工程实践

「弱信号不会消除约束,它只是把约束从写代码移到评审那些看起来完成、其实没有的代码上。」

  • 把「完成」的定义从「能编译」改成「自动化测试与视觉检查都通过」,并把 build / 单测 / UI spec 比对三个信号塞进 agent 循环内部
  • 运营模型五件套:rules(永久规则,错一次就写进去)、skills、agents(自动化检查)、commands(串成工作流)、hooks(每轮 lint、提 PR 前验测试)
  • navigation agent 像真人一样操作运行中的应用、读屏、报回归;也用来做激进滚动、乱序浏览的压力测试
  • 最大收益来自改代码库和工具链而非改 prompt;为隔离原型风险,用共享代码库但独立 build flavor 的沙箱包
验证闭环Hooks组织模式 实践综述 ↗
2026.09 ★★★★★

Uber 软件工厂:把成本拆成可优化的六项

Uber Engineering· Running a Software Factory Efficiently at Uber Scale(AI Engineer 2026)

70% 以上的 PR 由 agent 产出之后,真正难的不是生成代码,而是把每次会话的成本逐项归因。

  • 规模:3,600+ 个 agent skill、每天 3 万次 skill 执行、模型网关每天 1 亿+ 请求、MCP 网关 1,000+ 工具、2,500 个可复用 skill
  • 固定同一模型做对照:每千次请求成本较峰值下降约 34%,每次会话成本较 6 月峰值下降 52%
  • 上下文图谱(4,000 万条记录 / 150 类节点)替代「每次向 20–30 个系统分别查询」,显著降低 token、轮次与延迟
  • 度量口径值得抄:按产出计价——每个合并 PR 的成本、每个评审、每个告警,而非每 token 成本
规模化成本治理上下文图谱 uber.com/blog ↗
2026 · 年中 ★★★★★

Anthropic 官方 Claude Code 最佳实践

Anthropic Engineering· Best practices for Claude Code(持续更新)

几乎所有最佳实践都源于同一个约束:上下文窗口会很快填满,而填满后性能下降。

  • 把「给 Claude 一个可运行的检查」当作第一原则,并给出验证强度的四个档位:同一 prompt 内自检 → /goal 条件 → Stop hook 确定性闸门 → 换模型做第二意见(干活的不许给自己打分)
  • 四阶段工作流:Explore(plan mode 只读)→ Plan(Ctrl+G 可直接改计划)→ Implement → Commit
  • 要求 agent 呈交证据而非主张成功:测试输出、执行的命令与返回、截图——看证据比你自己重跑更快
验证闭环上下文管理 anthropic.com/engineering ↗
2026 · 年中 ★★★★★

Anthropic 内部团队怎么用 Claude Code

Anthropic· How Anthropic teams use Claude Code

最有价值的是「任务分类直觉」:产品边缘的抽象任务可异步放养,核心业务逻辑必须同步盯着改。

  • 快速原型:开 auto-accept,从干净 git 状态起步、频繁提交检查点,先看 80% 完成度方案再接手收尾
  • Vim mode 是早期最成功的异步项目,约 70% 的最终实现由 Claude 自主完成
  • 安全团队把 Terraform plan 丢进去问「这会做什么、我会不会后悔」;事故时用栈回溯把定位从 10–15 分钟压到 5 分钟
组织模式安全工程 官方 PDF ↗
2026 · 年中 ★★★★★

Google:让编码 Agent 驱动「智能体质量飞轮」

Google Developers Blog· Driving the Agent Quality Flywheel from Your Coding Agent

「优化器永远不给自己的工作打分」——一个看似小的架构选择,决定了你是在改进 agent 还是在刷指标。

  • 五阶段闭环:准备数据集 → 跑推理产 trace → 评分(AutoRaters 或自定指标)→ 失败聚类归因 → 定点修改并对比基线
  • AutoRaters 会先从多轮对话里还原用户真实意图,再为该 case 生成专属 rubric,最后多样本多数投票
  • 明确定位:它是方法论 + 编排,不是自主系统——提案由人批准,合成场景只用于冷启动
2026 · 年中 ★★★★★

Google Agent Skills:把 skill 当产品运营,而不是当文档

Google Cloud· Behind the scenes: How we build, test, and scale Google Agent Skills

一个写得含糊的 skill 会拖垮整个 agent 体验,所以「谁能发布」必须有一道自动化的门。

  • 入库前强制 CI:frontmatter 与命名 lint、全量链接检查(专治幻觉链接)、结构模式校验
  • 提交时评一次 + 每周对全库定时评一次,比较「有 skill / 无 skill」的准确率与 token 消耗,做 2×2 判定
  • 明确 owner 制:API 变更导致 skill 失效,由 skill owner 负责修;架构上优先引用远程 MCP 工具而非裸 CLI
2026 · 年中 ★★★★★

Google:验证而非生成,才是 agentic 开发的真正瓶颈

Google / Flutter 团队· AI makes it easy to migrate. Flutter makes it easy to scale.

并行的 agent 会引入「非确定性漂移」:两边单测都过,三周后线上转化率掉 3%,因为重试时机行为不同。

  • 给出可量化的反馈环对比:原生双栈一次 build-link-archive 2–5 分钟,闭环热重载 <200ms,widget 测试 <500ms
  • 引内部与外部数据:73% 开发者称用 AI 起步更快,但 46% 在关键调试上不信任 AI 结果、必须人工核对
  • 「代码库是组织积累的记忆」——Day 1 迁移很快,Day 2000 的维护成本才是真账
验证闭环迁移反馈速度 goo.gle ↗
2026 · 年中 ★★★★★

Airbnb:3,500 个测试文件迁移,6 周 vs 预估 1.5 年

Airbnb Engineering· Enzyme → React Testing Library 大规模迁移

成功的驱动不是更强的模型,而是「每个文件都必须过 Jest + lint + tsc」这道闸门——agent 无权宣布自己完成。

  • 四步状态机逐文件推进,失败就把错误连同当前文件回传重试;首批 4 小时迁完 75%
  • 「sample → tune → sweep」循环把自动化率推到 97%,剩下 3% 由工程师用一周手工收尾(当作计划内工作,不算失败)
  • 上下文选择比 prompt 措辞更关键:每个 prompt 最多携带 50 个相关文件;作者原话是「最有效的路线就是暴力重试」
大规模迁移状态机 案例拆解 ↗
2026.05 ★★★★★

Microsoft:agentic 时代给 builder 的十条新规则

Microsoft· Introducing Command Line, and the new rules for builders(Build 2026)

「代码是一次性的。」当代码可弃,评审就可以毫不留情,spec 反而成了那个耐久产物。

  • 默认 agent-first;上下文与 skills 是最重要资产;同一个 agent 失败出现两次,就把它升级成可复用的 skill / eval / workflow
  • 计划才是真正的工作——计划做好了,实现常常能一把过;人判断力集中在计划上,执行交给自动驾驶
  • 原型替代详细 PRD(「要 demo,不要 memo」);taste 而非时间成为最稀缺资源
  • 明确警告:不要让 code review 变成瓶颈——把首轮评审交给 agent,人只保留架构判断
组织变革品味 commandline.microsoft.com ↗
2026.05 ★★★★★

Google《The New SDLC With Vibe Coding》白皮书

Google· Addy Osmani / Shubham Saboo / Sokratis Kartakis,50 页免费白皮书

「你的主要产出不是代码,而是生产代码的那个系统。」这是全篇最该被记住的一句。

  • 开篇数据:85% 专业开发者常用 AI 编码 agent、51% 每天用、约 41% 新代码由 AI 生成
  • 把 vibe coding 与 agentic engineering 定义为一条光谱的两个端点,区分维度是结构、验证、人类判断的浓度——不是「用不用 AI」
  • 六类上下文(指令 / 知识 / 记忆 / 示例 / 工具 / 护栏),静态与动态的切分是真正的架构决策
  • 给出直白的判定线:周末原型可以纯 vibe;处理支付的生产 API 必须 agentic engineering
方法论Harness上下文工程 全文拆解 ↗
2026.04.20 ★★★★★

Cloudflare:用七个专家 Agent 编排代码评审

Cloudflare Blog· Orchestrating AI Code Review at scale

「把所有 diff 塞进一个万能 prompt」必然产出噪音——幻觉语法错误、给已有错误处理的函数提「建议加错误处理」。

  • 架构:以开源 agent OpenCode 为核,外面套 CI 原生的编排层;协调 agent 按风险等级最多派出 7 个专项评审(安全 / 性能 / 质量 / 文档 / 发布 / 内部规范)
  • 协调者负责去重、判严重度、合并成一条结构化评论;发现问题时可主动阻塞合并
  • 规模与成本公开:单月 48,095 个 MR 上跑了 131,246 次评审,中位耗时 3 分 39 秒、中位成本 $0.98,工程师仅在 0.6% 的 MR 上推翻机器人结论
代码评审多 Agent 编排 blog.cloudflare.com ↗
2026.02.11 ★★★★★

OpenAI:整仓由 Codex 生成,人类只负责掌舵

Ryan Lopopolo(OpenAI)· Harness engineering: leveraging Codex in an agent-first world

「人掌舵,agent 执行。」5 个月、3→7 人、约 100 万行代码、1,500 个 PR、零行手写代码。

  • 连脚手架、CI 配置、格式化规则、乃至指导 agent 的 AGENTS.md,都由 Codex 自己生成
  • 拒绝巨型 AGENTS.md:约 100 行只当「地图」,真正的知识放结构化 docs/,做渐进式披露;另设 doc-gardening agent 定期扫过时文档
  • 架构约束机械化:Types→Config→Repo→Service→Runtime→UI 单向分层,用自定义 linter 与结构测试强制,报错里直接注入修复指令
  • 熵治理:曾每周五花 20% 时间清「AI slop」,改为把 golden principles 写进仓库 + 后台 agent 定期扫描并开重构 PR,多数一分钟内可评审自动合并
  • 吞吐量改变合并哲学:agent 吞吐远超人类注意力时,纠错成本低而等待成本高
Harness架构约束技术债 openai.com ↗
2026.02.09 ★★★★★

Stripe Minions:每周 1,300+ 个 PR,零人工写码

Stripe· Minions: Stripe's one-shot, end-to-end coding agents(Part 1 / Part 2)

「对人好用的工具,对 LLM 也好用。」Minions 没有独立基建,直接跑在工程师日常用的 devbox 上。

  • 完全无人值守:Slack 里 @ 一下,到产出通过 CI 的 PR,中间无人介入;devbox 10 秒预热、与生产隔离,因此可跳过一切确认提示
  • blueprint(蓝图)= workflow 的确定性 + agent 的灵活性:确定性节点跑 git / lint / 测试,「实现任务」「修 CI」这类节点才交给 agent 循环
  • 反馈左移做到极致:push 时启发式跑相关 lint(<5 秒),CI 里 300 万+ 测试多数带 autofix;明确纪律「常常一次、最多两次 CI」
  • Toolshed 中央 MCP 服务器暴露 400+ 工具;agent 规则按子目录条件生效,避免海量无条件规则污染上下文
无人值守Devbox反馈左移 stripe.dev/blog ↗

国内厂商

目前仅见二手转述与产品公告,缺一手工程博客,按线索处理(★★★)
2026.04 ★★★★★

腾讯:全面转向 AI Native 研发,目标「0 人工 Coding」

腾讯技术工程· 经媒体报道转述

「把 AI 当打字员用,天花板很低;把 AI 当施工队用,才有真正的效率革命。」

  • 据报道于 2026 年 4 月宣布整体转向;未见公开的 harness 细节与度量口径
二手来源组织变革 报道 ↗
2026.03 ★★★★★

阿里 Qoder:Leader Agent 拆任务、专家池并行

阿里 ATH 事业部· Experts Mode,经报道转述

按需求临时组建「AI 工程专家团」——后端、前端、测试、审查员各在独立上下文里并行。

  • 宣称成本降至单一顶级模型的 1/2–1/5,代码保留率 86.81%;内部 AI 生成代码占比接近 40%
  • 配套动作更值得注意:钉钉把大量 GUI 重构为 CLI,让 agent 绕过人工直接调用企业 IT 设施
二手来源多 Agent 报道 ↗
2026.02 ★★★★★

字节 TRAE:抖音生活服务链路 43% 代码由 AI 贡献

字节跳动· 企业版 SOLO 模式 +《2026 企业级 AI 编程实践手册》,经报道转述

把内部「用 TRAE 开发 TRAE」的经验沉淀成方法论——这条自举路径本身比数字更有参考价值。

  • 定位从「辅助工具」升级为「能独立驾驶的 AI 工程师」;据称超大规模老旧单体仓库的深度重构仍受上下文截断困扰
二手来源AI IDE 报道 ↗

星级怎么给

  1. ★★★★★ — 给出可复用的机制 + 可核对的数字,且被后续实践反复引用,接近必读
  2. ★★★★ — 有一手经验与细节,适合拿来对照自查
  3. ★★★ — 观点或二手转述,仅作线索,需回到一手来源验证

筛选与日期口径

只收「描述了怎么做、而不只是宣布做了什么」的文档:必须包含机制、约束或度量中的至少两项。 纯产品发布稿、纯评测对比、纯观点社媒帖不入表。

日期为原文公开发布时间。其中数条仅能确证到年或半年(标注为斜体),按已知区间就近归位, 不影响主题排序的正确性。

读完之后,三件事大概可以做

  1. 把你仓库里的 AGENTS.md 改成「每条对应一个真实失败案例」,而不是抄一份通用规范
  2. 给 agent 一个能返回 pass / fail 的检查,并让它自己跑到通过为止——这是所有五星文档的共同点
  3. 把「完成」的定义从「能编译」上调到「构建 + 测试 + 视觉/行为验证都通过」,并把证据挂到 PR 上