优秀的工程师在构建之前会先进行规划。我成长过程中所见的流程是:编写一份描述功能的 RFC,将其拆分为更小的任务,然后逐一构建,每个任务往往会阻塞下一个任务。在写下第一行代码之前,工作的结构就已经被锁定了。
这很合理。它使代码审查变得易于管理,并避免了大规模合并带来的风险。但它也要求你在对问题了解最少的时候,做出最关键的结构性决策。
在你构建任何东西之前,你都在猜测:哪些部分是可以分离的,每一部分的复杂程度如何,步骤 3 是否会迫使你重新思考步骤 1。有时你是对的。但往往并非如此,步骤 1 最终会被抛弃。你在构建过程中学到了一些东西,但如果先构建整个功能,你会学得更快。
我们付出这种代价是有充分理由的:另一种选择是构建所有东西,然后手动梳理,而梳理一周的工作量比提前规划要困难得多。提前确定边界从来不是为了让构建变得更容易,而是为了让审查成为可能,这是当时唯一负担得起的方案。而这一点已经发生了改变。
三件事的成本大幅降低了。构建:AI 助手可以在几小时甚至几分钟内将一个清晰的问题转化为可运行的代码。设计:你可以以对话的速度审视并重塑计划。而这里最重要的一点是,拆分已完成的分支:将一周纠缠在一起的工作拆分为一系列小的 PR,这曾经是工作中最为枯燥的部分,也正是因为如此,我们才极力避免它。现在,这只需要一个提示词(prompt)就能完成。
有两件事的成本没有降低。第一是代码审查中的判断部分。AI 代理让机械性的审查(一致性、细微问题、明显的 Bug)几乎变得零成本,但它们无法解决细微的正确性问题或相关的深层疑问:这个改动放在这里是否合适?这个端点设计在六个月后是否会带来隐患?机器人批准你的 PR 并不等同于你理解了代码,如果你不是代码的编写者,阅读代码就是你掌握它的方式。窄小的 PR 让这种阅读成为可能。
第二是产品验证。运行程序并确定它是否是正确的功能,这个过程依然缓慢。新的变化在于,你可以在任何人阅读代码之前,就足够早地让整个功能运行起来并展示给他人看。
所以,不要为了规避一个已经不存在的成本而预先确定边界。
我现在的工作流程如下:
需要明确的是:这并不是“跳过规划直接编码”。在触碰编辑器之前,我有一个计划,并且每个功能都始于一场审问。我运行 grill-me,这是一个通过对抗性轮次对你的想法进行质询的技能,直到它包含真正的决策。如果 API 调用失败,回退方案是什么?我会在所有事情上运行它,包括小的改动,它总能发现我未曾察觉的漏洞。
当设计具有创新性时,计划会变成在任何代码编写之前提交的规范。在另一个项目中,第一个 PR 是一份文档:功能是什么,它如何工作,信任边界在哪里。它在任何实现存在之前的几天就已合并,以便团队可以提前提出反对意见。
永远不会被提交的是拆分为 PR 的方案。在构建之前决定构建什么;在构建之后决定如何切分。

一旦设计确定,我就开始构建。我经常分步骤工作,但我不会在每一步都停下来开启一个 PR 并等待审查。一切都保留在一个分支上,直到它端到端运行正常,无论涉及多少文件。
提交(commit)会发生,但它们不是给别人看的里程碑。它们是保存点:一个概念得到了验证,或者我即将尝试一些有风险的操作,需要一条可以拉回的绳子。我最近完成的一次重构在一天之内跨越了几十个文件,产生了十几个提交,并带有操作性说明。这些是让我知道自己去过哪里的路标,而不是写给审查者的故事。
这部分会让一些工程师感到不适,我理解原因:Git 历史记录应该是记录。但这段历史永远不会成为最终记录。最后的 PR 是从 main 分支新鲜切出的,而构建分支只是你可以丢弃的草稿纸。两个受众在时间上是分开的——我和审查者——将它们分开可以让你同时优化两者。
一旦工作进展顺利,我就停下来展示它。不是以 PR 或代码审查的形式,而是在 Slack 上发一个短视频,或者如果改动需要点击交互,就提供一个预览部署。在任何代码审查开始之前,从将要使用它的人那里获得关于运行中软件的反馈。
既然机械性的审查部分已经自动化,审查本身就变得昂贵了。如果在审查时才发现你构建的东西不对(UI 模式令人困惑,端点形状不符合前端使用数据的方式),这会浪费审查者和你自己的时间。演示可以在改动成本较低时发现这些问题。如果它揭示了需要重新思考的地方,我会先针对反馈运行 grill-me,这样迭代就不只是凭感觉。

构建顺序只是拆分的草稿:步骤会被重新组合和切割。删除 PR 是最清晰的例子,这是一个只在最后才存在的单元,一旦新路径到位。
我运行一个提示词:
将当前工作拆分为最小的一组可独立审查的 PR,每个 PR 都可以安全地单独合并,并且在工作允许的情况下,每个 PR 都能为用户提供价值。为每个 PR 创建一个 git 工作树并从 main 分支切出。仅在存在真实依赖关系时进行堆叠;否则从 main 分支切出。任何被替换代码的移除都应放在其自己的最终 PR 中。在创建任何内容之前,先向我展示拟议的拆分方案。
所需时间取决于工作的纠缠程度,从几分钟到几轮来回沟通不等。无论哪种方式,都不需要手动挑选提交(cherry-picking)。
那次重构最终拆分为五个 PR:两个后端端点作为 main 的同级分支,两个前端视图分别位于其所需数据的后端 PR 之上,以及最后一个纯粹删除旧路径的 PR。删除的代码比整个功能增加的代码多出几百行。这就是按此顺序进行重构的结果。
通过反复实践,我总结出两条规则:
仅在依赖关系真实存在时进行堆叠。 前端视图 PR 依赖于其后端端点 PR,分支结构反映了这一点。其他所有内容都来自 main。为了方便而进行的堆叠会产生一个让你在底层 PR 收到反馈时感到后悔的变基(rebase)链。
清理工作最后交付。 旧代码在新路径上线后,在其自己的 PR 中被移除。将删除与创建混合在一起会困扰审查者,使回滚变得模糊不清,并将清理工作掩盖在功能的噪音中。
拆分过程也是我审视自己工作的时候。逐个 PR 地检查差异,保持在脑海中可以容纳的大小,这就是“交付 AI 编写的代码”与“理解代码”之间的区别。我宁愿在那里发现自己的问题。
一个实用的建议:管理堆栈会迅速消耗上下文,因此将拆分工作交给向主代理汇报的子代理。在 Cursor 中,split-to-prs 技能封装了这一点。
沉重的 PR 依然沉重,这是应该的。后端 PR 承载了真正的架构风险(新的数据模型、新的 API 表面、信任边界),这是审查者应该关注的地方。那些消费这些后端接口的前端 PR 几分钟就能读完。小而专注的 PR 流动迅速,而庞大的 PR 则会停滞。
代理审查循环在这种规模下也更快。在 Adapt,我们使用 Adapt 本身作为审查者,这是一个具有过往工作业务背景的代理。它在 PR 开启后的几分钟内就会发表评论,交流(问题、澄清、小修复)在十分钟内就能解决。这只有在 PR 小到可以快速阅读时才有效;一个混合了多个关注点的 2000 行 PR,根本得不到人类的这种对待。
增量合并也使部署更易于管理。如果出现问题,你可以回滚一个集中的改动,你的错误追踪会指向那个改动,而不是整个合并后的堆栈。
这就是收益。但随之而来有两个代价。
变基(Rebasing)。 当审查者要求对一个被其他 PR 依赖的 PR 进行修改时,其上的所有分支都需要变基。这种情况并不常发生,因为审查者通常会触及叶子 PR,但一旦发生,你就会感受到压力。保持生成拆分方案的聊天会话开启:它仍然保留着拆分逻辑,因此你可以重新提示它来更新上面的分支,而不是手动操作。
拆分不等于交付。 在我写这篇文章时,那次重构的五个 PR 仍然全部处于开启状态。一个好的拆分使每个 PR 都易于审查且值得单独合并。代理为我完成了前者;后者则由我在决定每个 PR 的内容时决定,并由我的团队在决定合并什么时决定。我的 PR 停滞是因为我只做了前者。即使这五个 PR 在同一天合并,我也保持了审查优势和每个改动清晰的回滚目标;我失去的是增量交付,因为没有东西提前到达用户手中,部署也是作为一批次落地的。
适用场景: 跨越后端和前端的多界面功能、在你完成之前不知道最终形态的重构、任何如果不这样做你就会在任务边界上瞎猜的工作。
较难适用场景: 必须在生产环境中按顺序进行的迁移和模式变更,此时顺序是真实的,你应该先规划它。有明显切分点的工作。步骤 1 永远无法单独交付的功能;如果所有东西都必须同时落地,那么后期拆分只会带来增量审查,别无他用。
启发式规则:如果你在构建任何东西之前就在编写 RFC 并猜测如何将其拆分为任务,那么这些时间可能花在构建上会更好。你会在最后得到更好的答案。我在几个项目中测试过这一点,它经受住了考验。
结构性决策并没有消失。只是当你面对已经写好的代码时,做出这些决策的成本会大大降低。