法不净空,觉无性也。

统一术语表

2026.07.26

本术语表适用于三册书,确保术语在全书中保持一致。英文术语首次出现时,在中文后以括号标注。

重要说明

术语表按拼音首字母排序。读者在阅读过程中遇到不理解的术语,可随时翻阅本表。


A

AI 编码工具(AI Coding Assistant) 基于大语言模型的编码辅助工具,能够理解自然语言指令并生成代码。本教程中的示例以 Claude Code 为运行环境,但所述方法论适用于所有同类工具。

架构偏移(Architecture Drift) AI 生成的代码偏离了最初设计的架构蓝图。表现为三种信号:篡改地基(修改了不应修改的核心代码)、过度设计(增加了不必要的复杂性)、体积失控(单个文件或模块无节制膨胀)。


B

蓝图(Blueprint)CONTEXT.md 文件,是项目开始前的架构设计文档。包含系统全景、技术栈、数据模型、API 契约、里程碑依赖树等内容。"没有蓝图不开工"是第一条纪律。

包工头模式 指 engineer-orchestrator 的角色——安排施工进度、协调各环节、检查质量,但不直接编写代码。


C

CONTEXT.md 项目蓝图的标准文件名。充当 AI 编码工具的工作上下文,包含所有需要了解的架构决策和领域术语。


D

代码腐化(Code Decay) 代码在持续修改中逐渐失去结构清晰性的过程。典型表现包括:一个函数从 20 行膨胀到 200 行,职责边界模糊,测试覆盖率下降。


G

工作流(Workflow) 对一个完整功能从需求到交付的自动化执行流程。包含拆解、编码、验收、分支判断、固化等步骤。


J

监理模式 指 engineer-inspector 的角色——验收 AI 生成的代码是否符合蓝图,在架构腐化扩散之前将其阻断。

建筑师模式 指 engineer-architect 的角色——在编写第一行代码之前,将需求转化为可执行的架构蓝图。


L

六步工作法 AI 编码的核心流程,包含六个步骤:拆解、下发指令、编码、验收、分支判断、更新图纸。


M

里程碑(Milestone) 一个可独立验收的功能单元。每个里程碑应有明确的验收标准,通过后方可进入下一个里程碑。


S

施工队长模式 指 engineer-workflow 的角色——完成一个完整功能,每一步都经过验收才固化。


Y

验收(Inspection) 对 AI 生成的代码进行系统性检查,判断是否符合蓝图预期。验收标准不是"代码能否跑通",而是"是否符合当初定下的蓝图"。

验收决策树(Inspection Decision Tree) 验收后的三种结论:

  • PASS:符合蓝图,可以固化。
  • NEEDS_FIX:存在小问题,需要修复后重新验收。
  • REBUILD:偏离蓝图严重,回滚后重建。

三大纪律 + 一条补充原则

  1. 无图纸不开工——没有蓝图就不开始编码。
  2. 无验证不固化——没有验收就不提交代码。
  3. 逢混乱必重建——发现架构偏移就回滚重来,不在错误基础上修修补补。

补充原则:无术语不讨论——在讨论技术方案之前,先对齐核心领域术语。这不是纪律(违反后不会导致项目失控),但能显著提升沟通效率。


六步工作法

  1. 拆解——将功能需求拆解为可独立执行的里程碑。
  2. 下发指令——向 AI 明确描述当前里程碑的目标和验收标准。
  3. 编码——AI 执行编码。
  4. 验收——检查代码是否符合蓝图和验收标准。
  5. 分支判断——根据验收结论决定下一步:PASS 则固化,NEEDS_FIX 则修复,REBUILD 则重建。
  6. 更新图纸——在实现过程中如有新的发现,及时更新蓝图。