Agentic Coding 思想入门:五位先驱,五张地图 & AGENTIC-CODING-CLASSICS

写给已经在用 Claude Code / Cursor / Aider,但没有读完那几篇思想原典的人。

2025 是软件方法论被 LLM 彻底重写的元年:Karpathy 把”vibe coding”送进维基百科又在 2026-04 升级为 agentic engineering;Anthropic 给出 5 种 workflow + 1 种 agent 的设计图;Dex Horthy 写下仿 Heroku 的 12-Factor Agents 宪法;Geoffrey Huntley 用 100 行 bash + 297 美元做完了 5 万美元的合同;Armin Ronacher(Flask 作者)半年后冷静地发回信告诉你”每个具体决策都还在迭代”。

5 篇精读 + 5 篇逐段全译 + 1 篇术语谱系 + 1 篇 Jesse Vincent 全译。中文圈第一次把这些原典系统性翻译过来。

怎么读

按编号顺序读最稳。01-10 是”精读 + 全译”严格 1:1 配对,从任何一篇进来都能跳到对位篇。

• 看到「📖 配套全文」就是一篇精读对应的英文原文逐段中译
• 看到「📝 配套精读 + 译者点评」就是回到精读视角
• 11 是术语词典(Prompt → Context → Vibe → Harness → Agentic 五代术语谱系)
• 12 是 Jesse Vincent 那篇 Superpowers 前传的完整翻译版

五位先驱地图

	作者	身份	流派
#1	Andrej Karpathy	前特斯拉自动驾驶总监,OpenAI 创始成员	哲学/纲领派
#2	Anthropic 工程团队(Schluntz, Zhang)	Claude 的造物主	工程纲领派
#3	Dex Horthy	HumanLayer 创始人,访谈 100+ 创业者后写的	生产纪律派
#4	Geoffrey Huntley	独立工程师,正在用 AI 自建一门编程语言	激进/黑魔法派
#5	Armin Ronacher	Flask 作者,Earendil agent 平台主创	现实主义派

这五位有意选成五种立场,因为这个领域还没有共识,任何只读一派的人都会把片面当全面。

12 篇阅读地图

① 五位先驱(精读 + 全译配对)

编号	标题	类型
01	Karpathy《Software 3.0:AI 时代的软件》	精读 ⇄
02	Karpathy《Software 3.0》逐段全译	全文 ⇄ 01
03	Anthropic《Building Effective Agents》:5 种 workflow + 1 种 agent	精读 ⇄
04	Anthropic《Building Effective Agents》逐段全译	全文 ⇄ 03
05	Dex Horthy《12-Factor Agents》:可靠 LLM 应用的 12 条宪法	精读 ⇄
06	Dex Horthy《12-Factor Agents》逐段全译(CC BY-SA 4.0)	全文 ⇄ 05
07	Geoffrey Huntley《Ralph Wiggum 作为软件工程师》:100 行 bash 的反叛宣言	精读 ⇄
08	Geoffrey Huntley《Ralph Wiggum》逐段全译	全文 ⇄ 07
09	Armin Ronacher《Agent Design Is Still Hard》:半年实战后的勘误表	精读 ⇄
10	Armin Ronacher《Agent Design Is Still Hard》逐段全译	全文 ⇄ 09

② 词典 + 番外

编号	标题	类型
11	术语谱系:从 Prompt 到 Agentic Engineering(2022-2026 五代术语进化线)	词典
12	Jesse Vincent《我在 2025 年 9 月怎么用编程 Agent》(Superpowers 前传)	全文

类型说明

• 精读:中文重写 + 译者点评,每篇 2500-3500 字。固定六段:影响力卡片 / 一句话总结 / 金句墙 / 核心精读 / 译者总评 / 调研来源
• 全文:对原文逐段翻译,原文段落用 blockquote 标出,中文跟在下面;译者注用 🟢 emoji 标记。每篇 4000-7000 字
• ⇄ 表示精读和全文严格 1:1 配对

几条贯穿全系列的判断

如果你只想看核心结论,这里就是:

1. “Agent” 这个词正在分裂成两派

• 官方派 / 工程派(Anthropic + 12-Factor + Armin):绝大多数自称 agent 的产品,其实是 workflow —— 这没毛病,反而是你该追求的。Anthropic 的核心忠告是 “建最适合的系统,不是最复杂的”
• 激进派 / 黑魔法派(Geoffrey Huntley + 部分 Karpathy):LLM 在某些任务上,粗暴重复比精巧设计更优。Ralph 用 100 行 bash 在 5 个独立验证里替代了 5 万美元的合同

你必须同时知道这两派,否则会被任何一方的拥趸搞得焦虑。

2. 术语在过去 12 个月内更换了三轮

时间	主流术语	谁推
2022-2024	Prompt Engineering	OpenAI / 学术圈
2025	Context Engineering	Anthropic / 12-Factor 派
2025-02	Vibe Coding	Karpathy
2025末-2026	Harness Engineering	Anthropic 主推
2026-04+	Agentic Engineering	Karpathy(Sequoia AI Ascent 2026-04-29)

Prompt ⊂ Context ⊂ Harness,后者完全囊括前者作为子问题。如果这五个词不在你词汇表里,你读 2026 年之后的任何 agent 文章都会半懂不懂。详见 11。

3. 关键事实(已校验)

• 12-Factor Agents GitHub 19,619 stars / 1,486 forks(2026-05-02)
• obra/superpowers 150,000 stars(Medium 2026-04 引用)
• Karpathy 演讲:YC AI Startup School,2025-06-17
• Anthropic《Building Effective Agents》:2024-12-19,作者 Erik Schluntz + Barry Zhang
• Geoffrey Huntley Ralph 原文:2025-07-14;$297 vs $50k 推文:2025-07-11
• Anthropic ralph-loop 官方插件:Daisy Hollman + Boris Cherny
• Armin Ronacher《Agent Design Is Still Hard》:2025-11-21

完整核验记录在 _meta/VERIFICATION_LOG.md(本仓库内)。

推荐阅读路径

只有 30 分钟:01(Karpathy)+ 07(Ralph)。一头一尾,光谱两端,你会立刻明白这个领域有多分裂、多刺激。

打算自己造 agent:03(Anthropic)+ 05(12-Factor)+ 09(Armin)。三篇是工程教科书,读完少踩 80% 的坑。

产品经理 / 创业者:01(Karpathy 的 autonomy slider)+ 09(Armin 谈 SDK 选型)。一个给方向,一个给现实约束。

想形成完整观点:01 → 03 → 05 → 07 → 09(五篇精读)按顺序读,从”思想”到”工程”到”反叛”到”冷静”。读完留给你一个比读单篇更复杂、也更接近真相的图景。

想读完整原文中文版:配对读 02 / 04 / 06 / 08 / 10(逐段全译,所有 🟢 是译注)+ 12(Jesse Vincent 全译)。

想搞清术语:直接看 11(术语谱系词典)。

这个系列没在做的事

• 不是技术教程:不教你怎么 npm install、怎么写第一个 prompt
• 不是工具评测:不会告诉你 Cursor 还是 Claude Code 谁更好
• 不是预测未来:这五位自己都不预测,我也不预测
• 不假装中立:每篇都有 🟢 译者点评,我会告诉你我相信什么、不相信什么

---

关键日期:这个系列写于 2026-05-06。术语和工具仍在快速迭代 —— Karpathy 在 2026-04-29 Sequoia AI Ascent 上正式提出 agentic engineering 接班 vibe coding,这是这次更新加进来的。读完它们你不会得到答案,但你会得到一份正确的问题清单。在这个领域,这就够了。