AI Agent / 系统课时

拆解开发任务

拆解开发任务

高质量拆解不是把需求改写成更长的待办清单,而是把它切成一组有依赖顺序、风险边界和验收证据的工作单元。这样 Claude Code 每完成一步都能验证方向,错误也能在影响扩大前被发现。

学习目标

  • 把需求拆成单一目标、可独立验证的工作单元
  • 为每一步标记依赖、风险、验证方式和完成条件
  • 使用 Plan mode 先研究和评审方案,再允许 Claude 修改代码

先判断任务是否值得拆解

小改动不需要仪式化规划。若差异可以用一句话准确描述,例如改一个文案、补一个日志或重命名变量,直接执行通常更高效。跨多个文件、存在未知实现路径、涉及数据结构或外部接口时,先拆解能显著减少返工。

判断是否需要规划时,关注三个信号:范围是否跨边界、方案是否有不确定性、失败是否难回滚。任意一项明显存在,就先探索再制定步骤,而不是直接让 Claude“把需求做完”。

把需求切成可验证工作单元

每个工作单元至少回答五个问题:要得到什么结果、依赖什么、会改哪里、怎么验证、什么情况算完成。不要机械地按文件拆分,因为一个业务行为常常横跨实现、测试和配置;更好的边界是“一个可观察结果”。

以“登录连续失败 5 次后锁定 15 分钟”为例,可以这样拆:

工作单元 依赖 主要风险 验证方式 完成条件
确认现有登录与失败处理路径 无 找错入口 阅读实现与现有测试 能指出认证入口、失败分支和状态存储位置
定义锁定状态与时间规则 上一步 边界条件含糊 列出成功、失败、超时场景 失败计数、重置和解锁规则无歧义
实现锁定逻辑 规则已确定 破坏正常登录 运行针对性测试 核心场景通过且改动范围受控
补齐回归测试 实现完成 漏测旧行为 运行相关测试集 新旧行为都有自动化证据

这种拆法把“理解现状”和“修改代码”分开,也把高不确定性步骤提前。若第一步就发现系统已有通用限流组件,后续计划可以及时收缩,而不是在错误假设上继续编码。

用 Plan mode 先拆后改

Claude Code 的 Plan mode 适合复杂变更:它可以读取项目、搜索实现并提出计划,但不会直接编辑源文件。可以在启动时指定 --permission-mode plan,也可以在会话中通过 Shift+Tab 或 /plan 进入。

下面用一个带初始需求的命令,让 Claude 先调查再输出实施计划:

bash
claude --permission-mode plan "阅读现有登录流程和相关测试,为“连续登录失败 5 次后锁定 15 分钟”制定实现计划。按依赖顺序拆分步骤;每步写明改动范围、风险、验证方式和完成条件;先不要修改源文件。"

预期结果

text
Claude Code 进入 Plan mode,先读取和分析项目,再给出可评审的实施计划;在你批准计划前不直接编辑源文件。

拿到计划后不要只看步骤数量,要检查是否存在循环依赖、是否把未知问题留到最后、是否缺少验证。若计划中某一步写成“完成认证模块改造”,但没有可观察结果或测试方法,这一步仍然太大,应继续拆分。

让验证决定执行顺序

依赖关系决定“什么必须先做”,风险决定“什么应该尽早做”。通常先确认接口与数据约束,再做实现;高风险兼容性、迁移或第三方行为应尽早验证,因为这些结论可能推翻后续方案。

每完成一个工作单元就执行与它最接近的验证,不要等所有代码写完才一次性跑全套测试。局部验证通过后再扩大范围,最后执行完整回归。这样失败时可以快速定位到最近一个工作单元,而不是在一大批同时发生的修改里猜根因。

什么时候应该重新拆解

执行中出现新依赖、原假设被证伪、单一步骤持续产生多个独立失败,都是重新拆解的信号。此时应停下当前实现,把新信息写回计划,再调整后续顺序,而不是为了“按原计划完成”继续扩大修改。

一个好的任务拆解最终会形成清晰闭环:先弄清现状,再按依赖与风险排序,每一步都有验证证据,最后用整体回归确认没有破坏既有行为。这样 Claude Code 才是在执行受控计划,而不是沿着一个模糊目标不断试错。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

拆解开发任务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通