AI Agent / 系统课时
拆解开发任务
拆解开发任务
高质量拆解不是把需求改写成更长的待办清单,而是把它切成一组有依赖顺序、风险边界和验收证据的工作单元。这样 Claude Code 每完成一步都能验证方向,错误也能在影响扩大前被发现。
学习目标
- 把需求拆成单一目标、可独立验证的工作单元
- 为每一步标记依赖、风险、验证方式和完成条件
- 使用 Plan mode 先研究和评审方案,再允许 Claude 修改代码
先判断任务是否值得拆解
小改动不需要仪式化规划。若差异可以用一句话准确描述,例如改一个文案、补一个日志或重命名变量,直接执行通常更高效。跨多个文件、存在未知实现路径、涉及数据结构或外部接口时,先拆解能显著减少返工。
判断是否需要规划时,关注三个信号:范围是否跨边界、方案是否有不确定性、失败是否难回滚。任意一项明显存在,就先探索再制定步骤,而不是直接让 Claude“把需求做完”。
把需求切成可验证工作单元
每个工作单元至少回答五个问题:要得到什么结果、依赖什么、会改哪里、怎么验证、什么情况算完成。不要机械地按文件拆分,因为一个业务行为常常横跨实现、测试和配置;更好的边界是“一个可观察结果”。
以“登录连续失败 5 次后锁定 15 分钟”为例,可以这样拆:
| 工作单元 | 依赖 | 主要风险 | 验证方式 | 完成条件 |
|---|---|---|---|---|
| 确认现有登录与失败处理路径 | 无 | 找错入口 | 阅读实现与现有测试 | 能指出认证入口、失败分支和状态存储位置 |
| 定义锁定状态与时间规则 | 上一步 | 边界条件含糊 | 列出成功、失败、超时场景 | 失败计数、重置和解锁规则无歧义 |
| 实现锁定逻辑 | 规则已确定 | 破坏正常登录 | 运行针对性测试 | 核心场景通过且改动范围受控 |
| 补齐回归测试 | 实现完成 | 漏测旧行为 | 运行相关测试集 | 新旧行为都有自动化证据 |
这种拆法把“理解现状”和“修改代码”分开,也把高不确定性步骤提前。若第一步就发现系统已有通用限流组件,后续计划可以及时收缩,而不是在错误假设上继续编码。
用 Plan mode 先拆后改
Claude Code 的 Plan mode 适合复杂变更:它可以读取项目、搜索实现并提出计划,但不会直接编辑源文件。可以在启动时指定 --permission-mode plan,也可以在会话中通过 Shift+Tab 或 /plan 进入。
下面用一个带初始需求的命令,让 Claude 先调查再输出实施计划:
claude --permission-mode plan "阅读现有登录流程和相关测试,为“连续登录失败 5 次后锁定 15 分钟”制定实现计划。按依赖顺序拆分步骤;每步写明改动范围、风险、验证方式和完成条件;先不要修改源文件。"预期结果
Claude Code 进入 Plan mode,先读取和分析项目,再给出可评审的实施计划;在你批准计划前不直接编辑源文件。拿到计划后不要只看步骤数量,要检查是否存在循环依赖、是否把未知问题留到最后、是否缺少验证。若计划中某一步写成“完成认证模块改造”,但没有可观察结果或测试方法,这一步仍然太大,应继续拆分。
让验证决定执行顺序
依赖关系决定“什么必须先做”,风险决定“什么应该尽早做”。通常先确认接口与数据约束,再做实现;高风险兼容性、迁移或第三方行为应尽早验证,因为这些结论可能推翻后续方案。
每完成一个工作单元就执行与它最接近的验证,不要等所有代码写完才一次性跑全套测试。局部验证通过后再扩大范围,最后执行完整回归。这样失败时可以快速定位到最近一个工作单元,而不是在一大批同时发生的修改里猜根因。
什么时候应该重新拆解
执行中出现新依赖、原假设被证伪、单一步骤持续产生多个独立失败,都是重新拆解的信号。此时应停下当前实现,把新信息写回计划,再调整后续顺序,而不是为了“按原计划完成”继续扩大修改。
一个好的任务拆解最终会形成清晰闭环:先弄清现状,再按依赖与风险排序,每一步都有验证证据,最后用整体回归确认没有破坏既有行为。这样 Claude Code 才是在执行受控计划,而不是沿着一个模糊目标不断试错。