在已有项目里做小步重构并提交验证,这条 AI 编程助手流程支持 AI 代码生成、AI 代码审查、AI 辅助开发,从读懂仓库到可提交结果,拆成理解、拆解、修改和验证几步推进。
面对一个已经跑起来的项目,要做的不是从零写新功能,而是在现有代码里改结构、修交互、对齐接口、抽离重复逻辑——这类"在已有基础上做小步重构"的任务。直接让 AI 一口气改完通常会失控,这条链路把改动拆成可控的小步来推进。
cd /path/to/your/project
claude
进入后先不要让它改任何东西。先问几个问题:
Claude Code 会自动读取项目根目录的 CLAUDE.md 文件。如果没有,建议先创建一个,写清楚技术栈、命名规范和目录约定。5 分钟的投入会让后续所有交互质量明显提升。
确认 AI 对项目结构、关键模块和技术栈的理解是准确的。
把改动需求描述清楚,然后让它拆解:
"我需要在这个项目里做以下改动:[描述改动需求]。请帮我拆成 3-5 个独立的小任务,每个任务要满足:1) 只涉及 1-3 个文件 2) 改完后可以单独验证 3) 不依赖其他未完成的任务"
原始需求:"把工具列表页的卡片组件重构一下"
拆解后:
一份有序的任务清单,每个任务有明确的范围、涉及文件和验证方式。
代码已经按任务清单逐步修改完毕,每一步都有独立的 commit。
npm run build # 确保无编译错误
npm run lint # 确保无 lint 警告
npm test # 跑测试(如果有的话)
如果有报错,让 Claude Code 或 Cursor 看报错信息来修。通常是 import 路径没更新或类型定义不匹配。
让 AI 基于 git diff 帮你写一份变更说明:
这份说明是给 reviewer(或者未来的你)看的。直接贴在 PR description 里。
npm run build 无错误如果只是修一个小 bug 或改几行文案,不需要这么完整的流程。直接:定位文件 → Claude Code 或 Cursor 修改 → 跑构建验证 → 提交。只有涉及多文件、共享逻辑或结构性变化的改动,才需要走完整的理解 → 拆解 → 执行 → 验证链路。
执行步骤
先用 Claude Code 或 Cursor 解释目录结构、关键模块、依赖关系和当前问题,不要一开始就让工具直接改。
让 ChatGPT 或 Claude 把问题拆成更小的改动单元,例如文案整理、组件抽离、接口对齐或交互修正,保证每一步都能单独验证。
用 Cursor 或 Claude Code 处理跨文件改动、重复逻辑抽离和结构性修正,但每一轮都只推进边界明确的一小段。
最后让工具协助运行构建、测试、整理改动说明和待确认风险,确保结果不是“能改”,而是“能提交”。