Claude Code 智能体重构模式

1. 从干净树开始并创建重构分支： git checkout -b refactor/migrate-zod 2. 显式限定任务范围以防止爆炸半径： "仅修改 src/api/ 和 src/middleware/ 下的文件。不碰 src/data/。" 3. 先要计划，不要代码： "列出每个导入 'validateBody' 的文件及所需变更。暂不编辑。" 审查计划。执行前拒绝或调整。 4. 在检查点中执行，每步一个 commit： "将 src/api/users.ts 迁移到 zod。运行 tsc。绿则提交。出错则停。" 5. 持续验证。每次提交后运行门禁： npm run check && npm test 若红，贴回错误："修复你刚在 src/api/users.ts 创建的 tsc 错误"。 6. 用 git 而非聊天检查结果： git log --oneline refactor/migrate-zod ^main git diff --stat main..refactor/migrate-zod 审查声明范围外的任何文件视为红旗。 7. 仅在完整门禁通过并人工审查 diff stat 后合并： npm run check && npm test && npm run build git checkout main && git merge --no-ff refactor/migrate-zod

将 40 个路由从手写验证器迁移到 zod： $ git checkout -b refactor/zod-migration $ claude > 范围：仅 src/api/**/*.ts。暂不碰 src/data/ 或测试。 > 步骤 1：列出每个使用 'assertValid(req.body)' 的路由及所需 zod schema。输出表格，不编辑。 [审查 40 行表格，确认 schema] > 步骤 2：对表中每个路由，用 zod schema + safeParse 替换 assertValid， 运行 tsc，每路由一 commit。首个错误即停。 结果：40 个 commit，全绿。检查： $ git diff --stat main..HEAD src/api/users.ts | 12 +- src/api/books.ts | 14 +- ...（40 文件，0 个在 src/api/ 之外） 干净范围、可二分查找的历史、声明范围外零文件。