直接答案
第一次会话选择可回退、可验证的小任务,不从范围模糊的大需求开始。
这篇内容解决什么问题
建立 Claude Code 首次任务的调查、实施、验证与审查流程。
选择边界明确的小任务
首次任务应限制在少量文件内,并具备可观察的完成条件,例如修复带复现步骤的缺陷、为现有函数添加测试或修改一个文档区块。避免使用“优化整个项目”等开放式要求。
在项目根目录启动会话,并先记录 Git 工作区状态。允许文件修改或命令执行前,保留所有既有未提交改动。
cd /path/to/project
git status --short
claude修改前调查项目
先定位入口、依赖、测试命令和与任务相关的现有实现模式。Claude Code 会按需读取文件,提示词无需包含整个仓库。
要求结果引用具体文件和函数,并明确列出不确定项。在修改前纠正理解偏差,并限制无关探索。
先不要修改文件。请定位这个项目的入口、测试命令和错误处理模式,
只阅读与用户登录流程有关的文件,并用文件路径说明结论。多文件或陌生模块使用 Plan 模式
任务涉及多个文件、需要选择 API 或影响陌生模块时,使用 Plan 模式分离调查与修改。计划应列出目标文件、数据流、风险、验证命令和明确排除项。
局部拼写修正或单行日志修改可直接实施。计划深度应与任务范围和风险相匹配。
- 01探索在 Plan 模式读取相关实现和测试,不写文件。
- 02计划列出改动点、边界和验收命令,请用户确认。
- 03实施退出 Plan 模式后按计划编辑。
- 04验证运行测试、构建或可视化检查,并报告证据。
在实施提示词中写明验收条件
实施要求应同时包含复现步骤、边界情况和验证命令,并要求在检查失败后继续修正。
验收条件必须可观察,例如测试通过、构建退出码为 0、接口返回预期状态,或指定的截图差异消失。
修复会话过期后登录失败的问题。先写一个能复现问题的测试,
再修改 token refresh 流程。只改 auth 模块,运行该模块测试,
最后列出修改文件、测试命令和结果;不要通过跳过断言掩盖失败。提交前审查差异
请求提交前检查 Git diff,确认没有覆盖既有未提交改动、引入无关格式化、泄露凭据或生成不应提交的构建产物。
先生成差异摘要,再使用独立上下文或子代理检查正确性、回归和遗漏。排除与需求无关的重构建议。
git status --short
git diff --check
git diff中断并重置错误方向
实施方向错误时按 Esc 中断,并补充缺失约束。多次纠正仍未解决时,使用 /clear 清理上下文,并以明确范围和验收条件重新开始。
每条提示都会创建检查点;/rewind 可恢复对话和 Claude 编辑工具产生的文件状态,但不覆盖 Bash 命令或外部进程造成的修改。持久恢复应使用 Git。
/rewind
/clear官方来源与核验范围
本文以公开官方文档为事实依据;命令和配置可能随客户端版本变化,执行前请同时核对对应来源。
查看文档适用范围