暂无菜单项

用Claude Code完成一个真实功能:从需求到验收

发布于 更新于
13

想真正判断 Claude Code 值不值用,最好的方法不是问它几个 API 问题,而是让它完整做一个小功能。这里给你一套适合真实项目的实战流程:不是追求“完全自动开发”,而是让 Claude Code 在明确约束下承担分析、改动和验证的主力工作,你负责把方向、边界和验收握在手里。

先选一个合适的功能

第一次实战,建议选“中等复杂度、跨 2 到 5 个文件、能运行验证命令”的需求。比如:为用户列表加筛选条件、给设置页补一个表单校验、把旧的接口调用统一迁移到新 SDK。不要一上来就让它做支付重构、数据库迁移或全链路权限系统,那会把“模型能力问题”和“任务过大问题”混在一起。

第 1 步:把需求说清,不要只给一句话

你给 Claude Code 的输入,至少要包含目标、限制、验收标准三部分。一个实用模板如下:

目标:给用户列表新增按状态筛选
限制:不要改接口协议;不要动权限逻辑;继续使用现有组件
验收:页面能按状态切换;现有测试通过;新增文案保持中文一致

官方 common workflows 一直强调,Claude Code 适合在明确任务和验证方式的前提下工作;描述得越具体,它越容易少走弯路。

第 2 步:先用 Plan 或 Manual 做分析

不要刚进会话就让它直接改。更稳妥的顺序是先切到 Plan 模式,要求它读取仓库、解释涉及文件、列出实现方案、标出风险点。这样你能在真正动文件前确认方向,尤其适合老项目和多人协作仓库。

第 3 步:把长期规则交给 CLAUDE.md

如果项目里已经有 CLAUDE.md,Claude Code 会在会话开始读取它。没有的话,至少先写上构建命令、测试命令、目录职责、禁改区域和提交前检查项。这样在后续实现阶段,你就不用每次再重复“优先复用现有组件”“不要改公共接口”这类信息。

第 4 步:进入实现,但保留可审查节奏

当方案确认后,再切到 acceptEdits 或保持 Manual 模式逐步执行。你的提示词可以这样下:

按你刚才的方案先实现最小改动版本,只修改必要文件。改完后先不要提交,先告诉我变更点并运行相关测试。

这样做有两个好处:一是避免它范围失控;二是把“编码”和“验证”明确串起来,而不是改完就停。

第 5 步:要求它自己验证

Claude Code 的优势之一就是能跑命令,所以别只让它写代码,要让它执行验证命令。例如运行单测、构建、lint 或最小手工检查命令。官方工作流文档里多次把“run tests”作为标准步骤,这不是锦上添花,而是判断它是否真的完成需求的分界线。

第 6 步:人工审查 diff 和边界

即使测试通过,也别直接宣布完成。你至少要人工看三件事:改动文件是否超出预期、文案和交互是否符合产品约束、有没有把无关重构夹带进来。Claude Code 很擅长顺手“帮你优化”,但真实项目里,这种额外优化未必是好事。

一个真实可复用的对话节奏

  1. 给需求、限制、验收。
  2. 要求只读分析和方案。
  3. 确认方案后执行最小改动。
  4. 运行测试或构建。
  5. 解释变更点和风险点。
  6. 必要时再做第二轮微调。

这套节奏看上去比“直接帮我做完”慢一点,但结果通常更稳,也更适合团队内长期复用。

验收清单最好写到什么程度

一个经常被忽略的细节是,验收条件不能只写“功能正常”。更实用的写法是把页面行为、测试命令、构建结果、文案一致性和不能影响的旧逻辑都列出来。你甚至可以在需求里明确要求 Claude Code 输出“本次修改文件列表、运行过的命令、剩余风险点”。这样即使后面需要交给同事复查,也能快速看懂这次功能交付到底完成到哪一步。

最常见的失败原因

  • 需求太模糊,只说“帮我实现一个功能”。
  • 没有验收条件,导致做完无法判断真假完成。
  • 一开始就给过高权限,让它改了超出范围的内容。
  • 没有项目级长期上下文,导致每次风格和约束都不一致。
  • 测试失败后只看一句总结,不回头核对真实日志。

总结

Claude Code 最有价值的地方,是把需求分析、跨文件改动和命令验证连成一个闭环。但前提是你要给它明确目标、合适权限和可执行验收。把这套流程跑顺后,你再去扩展到 MCP 工具接入大型项目阅读 或团队共享 CLAUDE.md,收益会更大。

常见问题(FAQ)

第一次让 Claude Code 做真实功能,应该选多大的任务?
建议选中等复杂度、可验证、跨少量文件的任务,这样既能体现能力,又不会因为范围过大导致判断失真。
为什么一定要先让 Claude Code 列方案?
因为先分析再动文件,能提前暴露风险点和误解,尤其在老项目或多人协作仓库里更重要。
测试通过是不是就等于可以直接上线?
不是。测试通过只能证明一部分行为,仍然需要人工审查 diff、业务边界和是否夹带了不必要改动。
0 讨论
热门最新
总结
暂无总结
0 / 600
嗨,下午好!
所有的成功,都源自一个勇敢的开始