AI Agent / 系统课时

制定功能实施计划

制定功能实施计划

需求已经确认后,下一步不是立刻让 Claude Code 批量改代码,而是把影响范围、依赖顺序、风险、测试和文档一起纳入实施计划。好的计划能让每一步都有输入、产物和验证方式,并在高风险点设置停止条件。

学习目标

  • 从已确认的验收标准反推代码与测试的影响范围
  • 按依赖关系拆分实现、测试、迁移和文档任务
  • 在执行前识别高风险改动并定义验证与回退条件

先定位真正的影响范围

功能计划不应只列“改哪些文件”,还要说明为什么这些位置受影响。让 Claude Code 先追踪入口、调用链、数据模型、权限校验、测试夹具和对外文档,再区分“必须修改”“可能修改”“只需验证”三类范围。

例如头像删除功能可能经过页面组件、前端请求封装、HTTP 路由、服务层、对象存储和用户数据读取逻辑。若项目已经有统一的资源删除服务,就应复用现有边界;若已有权限中间件,则不应在新功能中重复造一套鉴权。

可以用 Plan 模式让 Claude Code 只形成计划,不执行编辑:

bash
claude -p --permission-mode plan "基于当前仓库,为‘用户删除自己的自定义头像’制定实施计划。先读取相关代码和 CLAUDE.md,不修改文件。计划必须包含:受影响模块及依据、任务依赖顺序、每项任务的完成条件、需要新增或更新的测试、文档或配置变更、主要风险、验证命令、出现高风险异常时的停止条件。对不确定项明确标记,不要猜测。"

预期输出

text
影响范围:
- <PATH>:<原因>

实施顺序:
1. <任务> -> 完成条件:<可验证结果>
2. <任务> -> 完成条件:<可验证结果>

测试与验证:
- <测试范围>
- <验证命令>

风险与停止条件:
- <风险> -> <停止条件>

实际文件、命令和任务数量取决于仓库。计划中若只有抽象动词,没有文件依据、依赖关系或验证方式,仍然不够可执行。

按依赖关系拆任务

拆分顺序应跟系统依赖走,而不是按“前端、后端、测试、文档”机械分组。先处理会改变契约或数据形态的基础任务,再处理依赖它们的调用方,最后补齐端到端验证和文档。这样每一步都能单独检查,也更容易发现某个前置假设是否错误。

一项合格任务通常包含三个元素:修改目标、完成条件、验证方式。例如“在头像服务增加删除能力”不够具体;应进一步写清复用哪个存储抽象、删除成功后用户读取结果应是什么,以及由哪条单元测试或集成测试证明它成立。

任务不必拆到“改第几行”的粒度。过细会让计划很快因代码变化失效;过粗则无法判断完成状态。通常以一次可以独立实现并验证的逻辑改动为单位最合适。

把风险放进计划而不是备注

风险必须改变执行方式,否则只是装饰。涉及数据库迁移、公共 API、权限、并发、缓存、对象存储或大范围重构时,应在对应任务旁写明验证和停止条件。例如删除对象存储文件前,先确认数据库状态与存储 key 的映射;如果现有数据中出现无法解析的 key,就应停止批量删除,而不是继续猜测。

还要把“无需修改但必须回归”的区域列出来。头像删除没有改登录逻辑,不代表认证回归可以省略;如果新接口依赖当前用户身份,现有认证链就是关键验证对象。

让测试和文档成为任务的一部分

测试不是实施结束后的附加项。每条验收标准都应至少映射到一个验证方式:单元测试验证局部规则,集成测试验证模块协作,端到端测试验证用户可见行为。若项目已有固定命令,应直接写进计划,例如 npm test、pytest 或仓库自己的脚本,而不是笼统写“运行测试”。

文档也只在行为或使用方式发生变化时更新。公共接口变化要更新 API 文档,新增环境变量要更新配置说明,用户可见行为变化要更新使用文档;纯内部重构且契约未变时,不应为了“计划完整”强行添加文档任务。

什么时候计划可以进入执行

执行前逐项检查:影响范围是否有代码证据,任务是否按依赖排序,每项是否有完成条件,验收标准是否都映射到测试,风险是否有停止或回退策略。任何会改变数据、权限或公共契约的未知项都应先解决。

当计划已经能回答“先改什么、为什么、怎么证明完成、出问题在哪里停”时,再让 Claude Code 进入编辑阶段。这样计划不是形式化清单,而是控制实现范围和风险的实际执行地图。

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

目录与阅读设置

阅读设置

17

记录一个想法

制定功能实施计划

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

登录哪都通