一、项目级写好CLAUDE.md最重要在项目根目录建CLAUDE.md提交进 Git 与团队共享Claude Code 每次启动自动读取相当于给 AI 注入项目 README 编码规范# 项目概述 这是 PHP Laravel 电商后端使用 MySQL 8. ## 常用命令 - 跑测试./vendor/bin/pest 或 npm test - 构建npm run build - Lint./vendor/bin/pint ## 编码规范 - 使用 strict_types1 - Controller 不许直接写 DB 查询走 Service 层 - 所有新 API 必须写集成测试 - 禁止在代码中硬编码密钥/config ## Git 约定 - 功能分支feature/xxx修复fix/xxx - Commit 用 Conventional Commits 格式个人偏好放CLAUDE.local.md加进.gitignore团队共享放CLAUDE.md。二、编程工作流最佳实践习惯做法先探索再动手​新项目先问解释这个项目结构确认它读懂了再让改代码大任务先 Plan​说先出计划不要改文件确认后批准执行防跑偏一会话一任务​无关任务间/clear上下文污染会降低质量最小改动​提示词加只改相关文件不做无关重构Git 检查点​大改前git add -A git commit -m checkpoint before refactor出事可回滚让 AI 自验​告诉它跑测试/lint/build 并修失败别只生成代码看 diff 再提交​每次改完git diff确认无无关文件/硬编码密钥再git add -p用 /commit​Claude Code 内置/commit分析 diff 生成规范 commit msg提交前可跑/simplify做代码清扫典型修改型 Prompt修复 UserService.php 中 getUserById($id) 未校验 $id 为正的 bug。 - 先定位相关文件并说明计划 - 最小改动不重构其他逻辑 - 修改后跑 ./vendor/bin/pest tests/Unit/UserServiceTest.php - 告诉我应该运行哪些验证命令三、审查尚未提交的代码你问的重点Claude Code 有内置命令也可以直接问。方式 A内置/code-review推荐在 Claude Code 交互会话中改完代码未 commit 时直接输入/code-review它会启动子 Agent 读当前git diff工作区未暂存 已暂存重点找 bug、边界条件、安全问题和遗漏的错误处理输出按严重程度分级。方式 B手动 Prompt 审查 diff更可控在会话中直接说检查我尚未提交的改动git diff重点关注 - 空指针/NULL 未判空 - 边界条件数组越界、除零、负数 ID - 异常处理是否向上传播 - SQL 注入 / 未鉴权接口 - 是否有逻辑错误会影响生产行为 只报 Critical/Major 问题并给文件和行号不报风格 nit。或终端一键非交互git diff | claude -p 审查以下 diff找会导致生产 bug 的逻辑错误给出文件:行号和建议修复方式 C对比指定基准分支审查 git diff main...HEAD 中的改动检查是否与需求一致、有无引入不相关修改四、提交前推荐完整闭环git checkout -b fix/user-id-validation # ← 在 Claude Code 中完成编码 跑测试 git diff # 人工过一遍 # 在 Claude Code 会话中 /code-review # AI 审查未提交改动 /simplify # 可选代码清扫 /commit # AI 生成 commit msg git push出问题回滚未 commit →git checkout .已 commit 但想撤 →git revert HEAD或git reset --hard HEAD~1五、快捷别名可选# ~/.zshrc alias ccrgit diff | claude -p 审查 diff只报 Critical/Major bug给文件:行号 alias ccmclaude一句话CLAUDE.md定规矩 先 plan 再 implement /code-review审未提交 diff 看git diff再 commit是用 Claude Code 最稳健的日常闭环。有需要我可以给你一份适配 PHP/Laravel 或你具体技术栈的CLAUDE.md模板