同一个项目连续做几轮后，最有价值的不是更长的对话，而是已经沉淀下来的规则、检查点和交接记录。
让工具“完整讲解整个项目”通常得到目录介绍，却没有回答当前功能从哪里开始、数据怎样变化、输出在哪里。
所以这篇文章只解决一件事：围绕具体问题建立项目入口、依赖、数据流和验证方式的最小理解。这套流程先控制一个小范围，确认有效后再扩大，避免把第一处错误复制到全部材料。
适合谁
适合接手不熟悉的项目，想让Claude Code先解释结构、再决定改动位置的人。
不适合的情况也很明确：任务没有边界、原件无法恢复、关键事实无人负责，或最终结果准备直接对外发布。先解决这些前提。
Claude Code进入项目后同样可能读取文件、修改内容和执行命令。开始前要限定权限、保留版本和回滚点，任何不可逆或对外操作都应由人工确认。
开始前准备
- 项目规则与目录
- 启动和测试方式
- 一个明确功能或故障问题
- 建立一个测试副本或新目录，不直接操作唯一原件。
- 写下一句验收标准：项目说明能回答相关入口、数据来源、输出、共享调用和验证方法，并有实际文件或命令证据
准备材料时，把“必须原样保留”“允许调整”“信息不足时禁止猜测”分开写。三类边界混在一句话里，执行时最容易被忽略。
完整步骤
第一步之前：先做一个最小样本
小样必须足够小，出现问题时能回到具体输入和步骤；也要足够真实，不能只用一个刻意简化、永远不会出错的示例。
第一步：先读规则和入口
找到项目说明、配置、启动脚本和主要入口，确认生成物与源码边界。
把“关键入口清单”作为本轮留存证据。后续合并或扩大范围时，都应能用它复盘。
第二步：沿问题追踪调用链
从页面、命令或请求进入，追到处理逻辑、数据来源和输出。
先停在这里检查一次。此时应已经形成“问题相关数据流”，并且能回到原始材料说明它从哪里来。
第三步：查找共享影响
确认目标模块还有哪些调用方，避免局部修改破坏其他流程。
这一阶段的完成标志不是工具有回复，而是“下游影响清单”已经可供人工检查。
第四步：用只读证据验证理解
运行搜索、现有测试或小样输入，对比实际行为与解释。
继续下一步之前，抽查“项目理解报告”中的边界项和异常项；发现前提不成立就先修正。
第五步：人工验收并沉淀流程
不要在第五步继续扩写内容，而是做对账：输入是否齐、步骤是否留证、结果是否可恢复、风险是否有人确认。
实际示例
排查文章搜索时，从页面输入框追到前端筛选脚本，再检查卡片隐藏和加载更多状态。无需先阅读所有SEO构建逻辑。
可以先这样描述任务：
我正在处理“围绕具体问题建立项目入口、依赖、数据流和验证方式的最小理解”。已有材料包括项目规则与目录、启动和测试方式、一个明确功能或故障问题。请先不要扩大任务范围，也不要补造缺失信息。先完成“先读规则和入口”，输出可以人工检查的中间结果；我确认后，再继续“沿问题追踪调用链”。最终请按照“项目说明能回答相关入口、数据来源、输出、共享调用和验证方法，并有实际文件或命令证据”列出验收结果和仍需人工确认的内容。
这个任务描述故意先要求中间结果，再允许继续。对高风险或范围较大的工作，可以在每一步都保留同样的确认点。
常见问题与报错
Claude Code引用了项目里不存在的文件
要求每个关键判断附真实路径并重新搜索；无法找到的内容标成假设，不能沿假设继续修改。
Claude Code理解了目标，却越做越大
在项目规则和当前任务中写明允许修改、禁止修改和停止条件，要求先提交计划；超出范围时立即停在检查点。
修改文件很多，但缺少可审查记录
让每个阶段列出读取文件、修改文件、执行命令和验证结果，并使用版本控制或副本保留可恢复状态。
先确认项目规则、权限和当前阶段，再比较实际文件与工具自述。没有落到文件或命令的“已完成”不能作为证据。
完成后的检查方法
- 项目说明能回答相关入口、数据来源、输出、共享调用和验证方法，并有实际文件或命令证据
- 关键结论能回到原始材料、文件、命令输出或当前控制台。
- 没有把缺失信息、推测内容或示例数字写成已经确认的事实。
- 重要文件保留原件、版本或可恢复副本，敏感信息没有进入公开内容。
- 结果已经由真正负责这项工作的人审阅，而不是只看页面是否生成。
最后再问自己一次：这份结果解决了最开始的问题，还是只生成了另一份需要重新整理的材料？只有前者才算完成。
资料来源
- Claude Code官方文档
用于核对Claude Code当前官方能力和基本使用边界。
- Claude Code记忆文档
用于核对项目规则与记忆文件的当前说明。
FAQ
可以一次把整个任务交给Claude Code完成吗？
不建议一次交付全部范围。先按本文步骤完成一个小样，用“项目说明能回答相关入口、数据来源、输出、共享调用和验证方法，并有实际文件或命令证据”验收，再决定是否扩大范围。
遇到“Claude Code引用了项目里不存在的文件”应该先检查什么？
要求每个关键判断附真实路径并重新搜索；无法找到的内容标成假设，不能沿假设继续修改
完成后还需要人工检查吗？
需要。AI或执行工具负责推进流程，最终仍要由你根据原始材料、任务规则和“项目说明能回答相关入口、数据来源、输出、共享调用和验证方法，并有实际文件或命令证据”完成验收。