Agent Skills 中文课非官方

Reading Map · 技能的书架

参考书目:技能背后的六本书

这些技能不是凭空发明的。它们的词汇、检查清单与方法论,大多能在几本经典软件书里找到源头。这一页把技能与书双向对上:哪本书点名了哪个技能、对应课程哪几章、该从哪几章读起。每条关系都附原文证据——标「推断」的只代表术语同源,不当作定论。

6 本书3 技能点名2 课程点名1 术语推断

三个定性标签,三种证据强度

  • 技能点名:上游 SKILL.md 直接署名。
  • 课程点名:Matt 的付费课里点名;本站实战系列是其笔记。
  • 术语推断:技能使用该书术语,但未署名。

上游 skills 没有官方书单;这是按技能源码中的署名与术语整理的证据地图,不是 Matt 的推荐列表。

书 → 技能

书对应技能课程章节定性
《软件设计哲学》

John Ousterhout

/codebase-design、/improve-codebase-architecture、/tdd0002 参考层五技能0005 工程模块技能点名
《修改代码的艺术》

Michael Feathers

/codebase-design、/tdd、/implement0002 参考层五技能0003 实战:跑通主流程前三站0007 大型任务交付技能点名
《重构:改善既有代码的设计》

Martin Fowler

/code-review、/implement、/tdd0001 全局地图0003 实战:跑通主流程前三站0007 大型任务交付技能点名
《设计原本:计算机科学巨匠 Fred Brooks 的思考》

Frederick P. Brooks Jr.

/grilling、/grill-me、/grill-with-docs0002 参考层五技能0004 把不确定变成决策0005 基础工作流(下)课程点名
《程序员修炼之道:通向务实的最高境界》

Andrew Hunt & David Thomas

/to-tickets、/tdd、/ask-matt0001 全局地图0002 参考层五技能0007 大型任务交付课程点名
《领域驱动设计:软件核心复杂性应对之道》

Eric Evans

/domain-modeling、/wait-what、/codebase-design0002 参考层五技能0006 协作技能术语推断

技能 → 书(反查)

技能书关系
/ask-matt《程序员修炼之道:通向务实的最高境界》推荐 to-tickets 时沿用这个词
/code-review《重构:改善既有代码的设计》Standards 轴的坏味道基线取自第 3 章
/codebase-design《软件设计哲学》深模块词汇与 Design It Twice 直接取自本书
/codebase-design《修改代码的艺术》Seam 词条直接署名 Michael Feathers
/codebase-design《领域驱动设计:软件核心复杂性应对之道》因 bounded context 撞词,要求避开 boundary
/domain-modeling《领域驱动设计:软件核心复杂性应对之道》GLOSSARY.md 与 ADR 的实践与通用语言同源
/grill-me《设计原本:计算机科学巨匠 Fred Brooks 的思考》以设计树组织访谈
/grill-with-docs《设计原本:计算机科学巨匠 Fred Brooks 的思考》访谈的同时沉淀 GLOSSARY.md 与 ADR
/grilling《设计原本:计算机科学巨匠 Fred Brooks 的思考》design tree 概念来自本书
/implement《修改代码的艺术》在预定 seam 上尽量用 /tdd
/implement《重构:改善既有代码的设计》收尾自动调用 /code-review
/improve-codebase-architecture《软件设计哲学》用 deepening 扫描模块形状
/tdd《软件设计哲学》接口形状有争议时,点名去查 codebase-design
/tdd《修改代码的艺术》测试必须写在提前约定好的 seam 上
/tdd《重构:改善既有代码的设计》循环里不顺手重构,重构留给 review
/tdd《程序员修炼之道:通向务实的最高境界》每个红-绿循环是一发 tracer bullet
/to-tickets《程序员修炼之道:通向务实的最高境界》工单被定义为 tracer-bullet 纵切
/wait-what《领域驱动设计:软件核心复杂性应对之道》要求用 GLOSSARY.md 里的 ubiquitous language 重讲
技能点名John Ousterhout

《软件设计哲学》A Philosophy of Software Design

深模块:小接口后面藏大量行为

斯坦福教授 Ousterhout 的这本书只谈一件事:管理复杂度。核心概念是深模块——接口小而实现深,调用者不必理解背后的复杂。Matt 的 codebase-design 直接借用了这套词汇,并参考书中 Design It Twice 的做法写了同名子文件;但他明确拒绝了书中「深度 = 实现行数 ÷ 接口行数」的量化定义,改成「深度即杠杆」:看一个模块替调用者吸收了多少复杂度、撑起了多少调用点,而不是数行数。

核心理念

  • 复杂度是软件设计的主要敌人,它来自依赖与信息泄露。
  • 深模块:小接口 + 大量隐藏的实现;浅模块则相反。
  • 信息隐藏:模块边界应当藏起决策,而不是暴露内部。
  • Design It Twice:并行设计两套接口再取舍,第一想法通常不是最好的。
  • Matt 的改写:深度看杠杆,不看实现行数与接口行数的比例。

对应技能

  • /codebase-design深模块词汇与 Design It Twice 直接取自本书
  • /improve-codebase-architecture用 deepening 扫描模块形状
  • /tdd接口形状有争议时,点名去查 codebase-design
怎么读:先读第 2–6 章(复杂度、模块化、信息隐藏),再读第 11 章 Design It Twice;读到量化定义时记住 Matt 的改写。

原文证据

  • 技能源码engineering/codebase-design/DESIGN-IT-TWICE.md:3查原文 ↗
    Based on "Design It Twice" (Ousterhout): your first idea is unlikely to be the best.
  • 技能源码engineering/codebase-design/SKILL.md:107查原文 ↗
    **Depth as ratio of implementation-lines to interface-lines** (Ousterhout): rewards padding the implementation. We use depth-as-leverage instead.
  • 课程原文content/lessons/0002.mdx:87查原文 ↗
    词源是 Ousterhout《A Philosophy of Software Design》,但 SKILL.md 末尾明确拒绝了「深度 = 实现行数÷接口行数」的量化定义。

A Philosophy of Software Design · 书目页 ↗

技能点名Michael Feathers

《修改代码的艺术》Working Effectively with Legacy Code

Seam:不修改原地也能改变行为的地方

这本书教人给遗留代码加测试,靠的是找到接缝(seam):不在某处编辑代码,也能在某处替换行为。Matt 把 seam 收进 codebase-design 的共享词汇,并强调它是模块接口所在的位置;测试、预留接缝、发布前的 test seam checkpoint 都用这个词。为了避免与 DDD 的 bounded context 撞车,技能里还明确要求避开 boundary 一词。

核心理念

  • Seam(接缝):在不编辑某处代码的前提下,改变该处行为的位置。
  • 测试放在 seam 上:跨公共接口验证行为,不钻进实现内部。
  • 一个 adapter 是假想 seam,两个才是真 seam。
  • 发布前设 test seam checkpoint:确认测试写在正确的公共边界。

对应技能

  • /codebase-designSeam 词条直接署名 Michael Feathers
  • /tdd测试必须写在提前约定好的 seam 上
  • /implement在预定 seam 上尽量用 /tdd
怎么读:先读第 2–4 章(反馈、感知与分离、seam 模型),再对照 codebase-design 的 Seam 词条。

原文证据

  • 技能源码engineering/codebase-design/SKILL.md:22查原文 ↗
    **Seam** _(Michael Feathers)_: a place where you can alter behaviour without editing in that place; the *location* at which a module's interface lives.
  • 课程原文content/workshop/0007.mdx:90查原文 ↗
    test seam checkpoint:概念出自 Michael Feathers 的《Working Effectively with Legacy Code》。

Working Effectively with Legacy Code · 书目页 ↗

技能点名Martin Fowler

《重构:改善既有代码的设计》Refactoring: Improving the Design of Existing Code

坏味道基线:零文档也能审出问题

Fowler 的《重构》第 3 章给出一套代码坏味道词汇——Mysterious Name、Duplicated Code、Feature Envy、Data Clumps 等。Matt 的 code-review 把它设为 Standards 轴的免费基线:即使仓库没有任何规范文档,审查也有共同的判断语言;仓库自己的规定叠加在基线之上,而不是替换它。

核心理念

  • 坏味道是判断题的共享词汇,不是硬性规则。
  • 基线兜底:零规范文档时,agent 也能用坏味道审出东西。
  • 仓库规范叠加并覆盖基线,不是替换。
  • 重构是在不改变外部行为的前提下改善内部结构;本课把重构留给 review。

对应技能

  • /code-reviewStandards 轴的坏味道基线取自第 3 章
  • /implement收尾自动调用 /code-review
  • /tdd循环里不顺手重构,重构留给 review
怎么读:直接读第 3 章 Bad Smells in Code,对照 code-review 的八条基线;其余章节当字典查。

原文证据

  • 技能源码engineering/code-review/SKILL.md:38查原文 ↗
    the **smell baseline** below: a fixed set of Fowler code smells (_Refactoring_, ch.3) that applies even when a repo documents nothing.
  • 课程原文content/workshop/0007.mdx:250查原文 ↗
    来自 Martin Fowler《Refactoring》的 code smells——Feature Envy、Shotgun Surgery、Divergent Change、Mysterious Name 等经典术语。

Refactoring: Improving the Design of Existing Code · 书目页 ↗

课程点名Frederick P. Brooks Jr.

《设计原本:计算机科学巨匠 Fred Brooks 的思考》The Design of Design

Design concept 与设计树

《人月神话》作者 Brooks 晚年这本书讨论设计本身:设计概念(design concept)是设计者脑中那个尚未成形的目标,对话、交接文档、代码都只是逼近它的资产。Matt 的 grilling 借用了设计树的意象:每个决策下面挂着依赖它的子决策,一轮只问前提已解决的问题。这本书在技能里没有署名,但在 Matt 的付费课里被点名——本站实战系列正是那门课的笔记。

核心理念

  • Design concept(设计概念):设计真正的目标,任何交付物都只是它的近似。
  • 设计是对话:设计概念在讨论中逐渐清晰。
  • 设计树:决策分叉成依赖它的子决策,走完所有分支才收敛。
  • 设计没有唯一正确答案,只有取舍与迭代。

对应技能

  • /grillingdesign tree 概念来自本书
  • /grill-me以设计树组织访谈
  • /grill-with-docs访谈的同时沉淀 GLOSSARY.md 与 ADR
怎么读:先读 Design Concept 与设计过程两部分,再回来对照 grilling 的 frontier 规则;不必按顺序读完。作者的另一本书《人月神话》是软件工程经典,但 design concept 出自本书。

原文证据

  • 课程原文content/lessons/0002.mdx:36查原文 ↗
    把计划画成一棵树:每个决策下面挂着依赖它的子决策。概念来自 Frederick Brooks《The Design of Design》。
  • 课程原文content/workshop/0005.mdx:27查原文 ↗
    《The Design of Design》的作者 Frederick P. Brooks Jr. 有个概念叫 design concept。

The Design of Design · 书目页 ↗

课程点名Andrew Hunt & David Thomas

《程序员修炼之道:通向务实的最高境界》The Pragmatic Programmer

Tracer bullets:从第一张票就贯通所有层

书里的 tracer bullet(曳光弹)指先打一条贯穿所有层的薄切片,用真实反馈校准后续设计。Matt 的 to-tickets 把工单定义为 tracer-bullet vertical slices:每张票都打通数据库、API、前端,而不是按层横切;tdd 的每个红-绿循环也被称为一发 tracer bullet。技能里用这个词但未署名,课程里明确点出了出处。

核心理念

  • Tracer bullet:先打通端到端的薄切片,用真实反馈修正方向。
  • 纵切优于横切:横切把反馈推迟到所有层拼起来之后。
  • 每个测试循环是一发曳光弹,根据上一轮反馈调整下一发。
  • 原型与曳光弹不同:原型可丢弃,曳光弹留在系统里。

对应技能

  • /to-tickets工单被定义为 tracer-bullet 纵切
  • /tdd每个红-绿循环是一发 tracer bullet
  • /ask-matt推荐 to-tickets 时沿用这个词
怎么读:读 Tracer Bullets 与 Prototypes and Post-it Notes 两节,再对照 to-tickets 的纵切规则。

原文证据

  • 课程原文content/workshop/0007.mdx:148查原文 ↗
    这个概念与 tracer bullets 源远流长,可追溯到《The Pragmatic Programmer》。
  • 术语使用engineering/to-tickets/SKILL.md:27查原文 ↗
    Break the work into **tracer bullet** tickets.
  • 术语使用engineering/tdd/SKILL.md:32查原文 ↗
    each test a **tracer bullet** that responds to what the last cycle taught you.

The Pragmatic Programmer · 书目页 ↗

术语推断Eric Evans

《领域驱动设计:软件核心复杂性应对之道》Domain-Driven Design: Tackling Complexity in the Heart of Software

通用语言与限界上下文:用词就是设计

Evans 这本书的两个概念渗进了技能,但全书名从未出现。domain-modeling 让每个仓库维护 GLOSSARY.md,让所有人和 agent 说同一套话——这就是 DDD 的通用语言(ubiquitous language);wait-what 明确要求用 GLOSSARY.md 里的 ubiquitous language 重新讲一遍。codebase-design 则把 boundary 列为要避开的词,因为它与 DDD 的 bounded context 撞车,要求改说 seam 或 interface。这本书是「用而不注」的典型:实践同源,证据是术语而非署名。

核心理念

  • Ubiquitous Language(通用语言):团队与代码共用一套词,词义写进词汇表。
  • Bounded Context(限界上下文):同一个词在不同上下文里可以有不同含义,先划边界再谈统一。
  • 模型驱动设计:代码结构应当反映领域模型。
  • 本课的用法:GLOSSARY.md 承载通用语言;bounded context 作为避开 boundary 一词的理由出现。

对应技能

  • /domain-modelingGLOSSARY.md 与 ADR 的实践与通用语言同源
  • /wait-what要求用 GLOSSARY.md 里的 ubiquitous language 重讲
  • /codebase-design因 bounded context 撞词,要求避开 boundary
怎么读:先读第 2 章(Ubiquitous Language),再读第 14 章(Bounded Context);只想知道本课怎么用,读 0002 的 domain-modeling 一节即可。

原文证据

  • 术语使用engineering/codebase-design/SKILL.md:22查原文 ↗
    _Avoid_: boundary (overloaded with DDD's bounded context).
  • 术语使用engineering/codebase-design/SKILL.md:109查原文 ↗
    **"Boundary"**: overloaded with DDD's bounded context. Say **seam** or **interface**.
  • 术语使用productivity/wait-what/SKILL.md:7查原文 ↗
    use the ubiquitous language from `GLOSSARY.md`

Domain-Driven Design: Tackling Complexity in the Heart of Software · 书目页 ↗

从哪本开始

  1. 先读《软件设计哲学》第 2–6 章:模块、接口、深模块是整套技能的共享词汇。
  2. 再读《重构》第 3 章与《修改代码的艺术》第 2–4 章:审查与测试的日常语言都在这里。
  3. 想追方法论源头,读《设计原本》的 design concept 与《程序员修炼之道》的 tracer bullets。
  4. 《领域驱动设计》按需读:先看0002 的 domain-modeling 一节,再决定要不要读原书第 2、14 章。

数据源:site/content/books/data.ts(唯一事实源)。证据取自上游mattpocock/skills的 SKILL.md 与本站课件;英文短引仅作教学引用,版权归各作者。书目页链接仅供查证,本站不代售。