AI Agent / 系统课时

分析项目与确认需求

分析项目与确认需求

接手一个真实项目时,先让 Claude Code 建立项目上下文,再把“想加个功能”之类的模糊描述收敛成可检查的范围、约束和验收条件。这样后续实现不会因为误读目录、规范或边界而反复返工。

学习目标

  • 用只读方式识别项目入口、关键目录、规范文件和测试体系
  • 把需求中的歧义转化为需要确认的问题,而不是直接猜测
  • 产出可被开发和测试共同验证的验收标准

先建立只读的项目上下文

不要一上来就让 Claude Code 改文件。分析阶段的目标是回答“项目现在是什么样”,而不是“马上怎么改”。优先查看仓库根目录、README.md、CLAUDE.md、依赖清单、构建脚本、测试目录和与需求直接相关的模块;如果仓库存在嵌套的 CLAUDE.md,还要留意局部规则是否影响当前目录。

可以直接用 Plan 模式限制本轮工作为分析,并要求输出固定结构:

bash
claude -p --permission-mode plan "先不要修改任何文件。请阅读当前仓库中与项目结构、开发规范、构建测试方式有关的文件,并围绕‘给用户资料页增加头像删除能力’完成分析。输出:1)相关目录和入口;2)必须遵守的项目规范;3)可能受影响的模块;4)现有测试位置;5)仍需向需求方确认的问题。不要给实现代码。"

预期输出

text
相关目录和入口:<PATH>、<PATH> ...
项目规范:...
可能受影响的模块:...
现有测试位置:<PATH> ...
待确认问题:...

实际路径和文件名会随项目变化。验收重点不是文字是否完全一致,而是 Claude Code 能把结论落到仓库中的真实文件与约束上,并明确哪些信息仍然未知。

把模糊需求拆成可回答的问题

需求分析最常见的失败,是把缺失信息当成默认值。例如“删除头像”至少可能涉及默认头像、对象存储文件是否同步删除、缓存何时失效、历史记录是否保留,以及没有头像时按钮是否出现。Claude Code 可以帮助枚举问题,但不能代替产品或业务负责人决定规则。

把问题按三类收敛最有效:行为边界回答“用户能做什么”,数据边界回答“哪些状态会变化”,兼容边界回答“哪些现有行为不能被破坏”。每个问题都应指向一个决策;如果答案不会改变实现或验收,就不必进入确认清单。

把确认结果写成验收标准

验收标准要描述可观察结果,而不是实现手段。相比“新增一个删除头像 API”,更好的标准是“已登录用户删除头像后,资料页显示默认头像;刷新页面后状态保持一致;删除其他用户头像的请求被拒绝”。前者锁死了实现,后者才能真正用于验收。

一个完整标准通常同时包含前置条件、动作和结果,并补充关键异常路径。继续以上需求,可以整理为:

  • 已登录且已有自定义头像的用户可以触发删除操作,成功后立即显示默认头像
  • 页面刷新或重新登录后仍显示默认头像,说明服务端状态已持久化
  • 没有自定义头像时不出现误导性的删除动作,或按产品确认的交互处理
  • 非本人请求不能删除目标用户头像,并返回项目既有的授权错误
  • 相关单元测试或集成测试覆盖成功路径与至少一个权限失败路径

这些条目已经足够让实现者判断“做完没有”,同时没有提前指定控制器名称、存储 SDK 或数据库字段。

什么时候需求算确认完成

开始编码前,应能明确回答四件事:改动对象是谁、成功结果是什么、失败或边界情况如何处理、哪些现有约束不能破坏。若仍存在会改变接口、数据模型或权限规则的问题,就把它们保留为待确认项,不要让 Claude Code 自行补齐。

分析完成时,最有价值的产物不是一段长解释,而是一份有仓库证据的影响范围、一组真正需要人决策的问题,以及可以直接交给测试执行的验收标准。

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

目录与阅读设置

阅读设置

17

记录一个想法

分析项目与确认需求

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

登录哪都通