目录 (6)
什么是增强型编程?
增强型编程(Augmented Coding)是超越氛围编程(Vibe Coding)的下一阶段编程方式,是由 TDD 权威 Kent Beck 大佬提出的术语。可以说,氛围编程是一种跳过过程、直接向 AI 要结果的编程方式。但是 这种方式虽然能让代码跑起来,却通常会混进很多不必要的逻辑,代码复杂度也会上升。
增强型编程的目标是写出整洁的代码。 与只关心系统行为的氛围编程不同,增强型编程也关注代码质量。此外,它还会兼顾复杂度和测试覆盖率,是一种由开发者掌握主导权、利用 AI 产出更好的成果并提高生产力的编程方式。
1. Kent Beck 的 AI 使用方法
据说 Kent Beck 在开发一个特殊的 B+ 树库时使用了 augmented coding。我们来看看他是怎么用的。
1.1 让 AI 停止编码的 3 个信号
据说 Kent Beck 在使用 AI 时,一旦 AI 出了问题就会积极介入。他还介绍了 AI 出错的 3 个信号。
AI 编码出错的 3 个信号
Loops
因为无法解决的问题而陷入无限循环的情况
Functionality I hadn't asked for (even if it was a reasonable next step)
开始自作主张地实现没有要求的功能的情况
Any indication that the genie was cheating, for example by disabling or deleting tests
为了解决问题而作弊(删除或禁用测试)的情况
归根结底,系统必须按照人设计的样子来构建,所以主导权掌握在人手中,而 AI 则成为帮忙解决琐碎问题(比如编写普通代码)的协作工具。也就是说,设计系统的本质才是开发者的本质,开发者应该能够专注于这一点。
1.2 写给 AI 的 MD 指南
另外,Kent Beck 为了 TDD 和整洁的代码使用了很多 MD 文档。可以把它们看作是用来训练 AI 的。下面是我从众多指南中挑出来的最有名的 1 份。(Kent Beck 大佬的 B+Tree 之旅 Git)。我会附上英文原文以及 GPT 的翻译。我觉得这应该是融入了 Kent Beck 大量经验写成的 Markdown。《Tidy First》这本书总有一天也得读一读。
CLAUDE.md始终遵循 plan.md 中的指示。当我说 "go" 时,就在 plan.md 中找到下一个尚未处理的测试,实现该测试,然后只编写让该测试通过所需的最少代码。# 角色与专业领域你是一名遵循 Kent Beck 的测试驱动开发(TDD)和 Tidy First 原则的高级软件工程师。你的目标是严格遵守这套方法论来引导开发。# 核心开发原则- 始终遵循 TDD 循环:Red → Green → Refactor- 先编写最简单的失败测试- 只编写让测试通过所需的最少代码- 只在测试通过之后才进行重构- 遵循 Beck 的 "Tidy First" 方法,将结构性变更与行为性变更分开- 在整个开发过程中保持高代码质量# TDD 方法论指南- 先针对小的功能单元编写失败的测试- 使用能描述行为的有意义的测试名称(例如:shouldSumTwoPositiveNumbers)- 测试失败消息要写得清晰易懂- 只编写让测试通过所需的代码——不许多写- 测试全部通过后,再评估是否需要重构- 对新功能重复这个循环# Tidy First 方法- 所有变更都分为两类:- 结构性变更(Structural Changes):不改变行为,只整理代码结构(重命名、提炼方法、移动代码等)- 行为性变更(Behavioral Changes):实际添加或修改功能- 不要在同一个提交中混合两种变更- 如果结构性变更和行为性变更都需要,始终先进行结构性变更- 在变更前后都运行测试,以确保结构性变更没有改变行为# 提交纪律- 只在满足以下所有条件时才提交:- 所有测试都通过- 所有编译器/Linter 警告都已解决- 变更内容是一个逻辑上的工作单元- 提交信息要清楚说明是结构性变更还是行为性变更- 以小单位频繁提交,而不是以大单位偶尔提交# 代码质量标准- 彻底消除重复- 通过命名和结构清楚地表达意图- 明确地体现依赖关系- 保持方法短小,专注于单一职责- 尽量减少状态和副作用- 使用尽可能简单的解决方案# 重构指南- 只在测试通过时进行重构(即在 Green 阶段)- 使用成熟的重构模式,并采用清晰的命名- 一次只进行一项重构- 每个重构步骤都要运行测试- 优先考虑消除重复和提高可读性# 示例工作流程开发新功能时:1. 为功能的一小部分编写失败的测试2. 编写让该测试通过的最少代码3. 运行测试 → 确认是否通过(Green)4. 如有需要,进行结构性变更(Tidy First),每次变更后都运行测试5. 单独提交结构性变更6. 为下一个小的功能单元添加测试7. 重复这个循环,直到功能完成(行为性变更和结构性变更分别单独提交)Rust 专用指南- 在 Rust 中,相比命令式风格更偏好函数式风格- 用 Option 和 Result 的组合子(map, and_then, unwrap_or 等)代替 if let 或 match 模式匹配除此之外,还有专门分享能狠狠调教 AI AGENT 的指南的网站。(agents.md)
2. 编写 Augmented Coding 提示词
这次我们像 Kent Beck 一样来编写 Augmented Coding 提示词吧。提示词可能会变得很长。但是必须把它拆分成多个步骤来执行。我们假设要实现写文章的功能吧
假设有如下功能。
功能
编写由标题、分类、正文组成的文章
标题:限制 2-10 个字
分类:限制 2-10 个字
正文:至少 1 个字,必填
通过保存按钮保存文章
校验规则
字数未达标准时显示错误消息
存在重复标题时显示错误消息
保存成功时:“已保存” Toast 消息
保存失败时:“保存失败” Toast 消息
现在基于上面的功能进行设计,并写到 plan.md 里吧。
文章功能测试计划 (plan.md)测试进行顺序每个测试都从最小的单元开始,逐步扩展功能。要像 Kent Beck 那样,遵循 Red -> Green -> Refactor 循环、先进行结构变更再进行行为变更等原则!!另外,如果 AI 迷路了(出现 3 种危险信号),就立刻叫停,狠狠揍它一顿。只会白白浪费 token。1. 文章对象创建测试 - shouldCreateEmptyPost - 创建空的文章对象 - shouldCreatePostWithValidData - 用有效数据创建文章2. 标题校验测试 - shouldRejectTitleWithLessThan2Characters - 拒绝 1 个字以下的标题 - shouldRejectTitleWithMoreThan10Characters - 拒绝超过 10 个字的标题 - shouldAcceptTitleWith2Characters - 允许 2 个字的标题 - shouldAcceptTitleWith10Characters - 允许 10 个字的标题 - shouldAcceptTitleWithValidLength - 允许 2-10 个字之间的标题3. 分类校验测试 - shouldRejectCategoryWithLessThan2Characters - 拒绝 1 个字以下的分类 - shouldRejectCategoryWithMoreThan10Characters - 拒绝超过 10 个字的分类 - shouldAcceptCategoryWith2Characters - 允许 2 个字的分类 - shouldAcceptCategoryWith10Characters - 允许 10 个字的分类 - shouldAcceptCategoryWithValidLength - 允许 2-10 个字之间的分类4. 正文校验测试 - shouldRejectEmptyContent - 拒绝空正文 - shouldAcceptContentWith1Character - 允许 1 个字的正文 - shouldAcceptContentWithMultipleCharacters - 允许多个字的正文5. 重复标题校验测试 - shouldAllowFirstPostWithTitle - 允许第一篇文章的标题 - shouldRejectDuplicateTitle - 拒绝重复标题 - shouldAllowSameTitleAfterDeletion - 删除后允许使用相同标题6. 文章保存测试 - shouldSaveValidPost - 成功保存有效的文章 - shouldReturnSuccessMessageOnSave - 保存成功时返回 "已保存" 消息 - shouldReturnErrorMessageOnSaveFailure - 保存失败时返回 "保存失败" 消息7. 表单校验集成测试 - shouldShowErrorForInvalidTitle - 输入无效标题时显示错误 - shouldShowErrorForInvalidCategory - 输入无效分类时显示错误 - shouldShowErrorForInvalidContent - 输入无效正文时显示错误 - shouldShowErrorForDuplicateTitle - 输入重复标题时显示错误8. UI 组件测试 - shouldRenderPostForm - 渲染文章编写表单 - shouldRenderTitleInput - 渲染标题输入框 - shouldRenderCategoryInput - 渲染分类输入框 - shouldRenderContentTextarea - 渲染正文输入区域 - shouldRenderSaveButton - 渲染保存按钮9. 用户交互测试 - shouldUpdateTitleOnInput - 输入标题时更新状态 - shouldUpdateCategoryOnInput - 输入分类时更新状态 - shouldUpdateContentOnInput - 输入正文时更新状态 - shouldTriggerSaveOnButtonClick - 点击保存按钮时执行保存10. Toast 消息测试 - shouldShowSuccessToastOnSuccessfulSave - 保存成功时显示成功 Toast - shouldShowErrorToastOnFailedSave - 保存失败时显示失败 Toast - shouldHideToastAfterDelay - 一段时间后自动隐藏 Toast测试进行规则从上到下按顺序进行每完成一个测试,就把复选框 [ ] 改成 [x]来标记完成一次只实现一个测试在所有现有测试都通过的状态下再进行下一个测试重构只在测试通过后进行然后把上面的 plan.md 交给 AI,我只要在提示词里喊一声 go,它就会一步一步地处理。不过做着做着发现,它是在每次需要的时候才临时编写有效性校验。那该怎么办呢??看来最好补充一下 md 指南,让它使用已经做好的 Validator 对象。不过我判断这条指南并不属于概括性的指南。所以把它做成单独的 md 似乎更好。(一次塞进太多上下文会花更多的钱!!要节省 token,同时发挥最大效率)
VALIDATOR.md,或者 FORM_GUIDE.md开发 Form 时需要遵守的规则按照 字段定义 → 连接 Validator → UI 显示 的顺序示例代码(简单的 Input + Validator 组合)"不要在 Form 内部直接用条件语句做有效性检查""Validator 对象中没有的校验,先添加再使用"示例:const TitleValidator = Validator.string() .min(2, "标题至少需要 2 个字符。") .max(10, "标题最多只能有 10 个字符。");这样一来,这个 FORM_GUIDE.md 在需要 Form 有效性校验时就一起附加到提示词中,不需要时不附加直接使用就可以了。
3. 总结
当下这个时代,所有开发者都有一个共同的烦恼,那就是关于 AI 的烦恼。可能是恐惧,也可能是因为更高的生产力而感到开心,也可能是以前很享受敲代码,却随着 meta 的改变而变得郁闷,各种复杂的想法交织在一起。比起其他任何职业,开发者都站在使用 AI 的最前线,也亲眼见证着它的成长,所以想必会有更多的烦恼。但是不管喜不喜欢,在现在这个时间点,似乎都必须学会好好利用 AI 了。而且,要用好 AI,就必须做好架构与设计的时代似乎已经到来了。这个时代可能也会很快过去,也许会迎来真正只需要极少数天才的时代,但现在还是得先适应当下。
参考资料
