一、项目级写好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用 /commitClaude 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模板
)
