Recipes
模板库
20 个拿来就能用的模板：项目说明、提示词、Skill、工作流和配置。复制、改两行，就能用在你的项目里。
项目说明5
Python 数据与后端项目 CLAUDE.md 模板
适合 FastAPI、数据分析或脚本类 Python 项目的 CLAUDE.md，写清运行命令、分层约定、数据处理红线和数据库迁移规则，减少智能体乱改数据。
个人全局偏好 ~/.claude/CLAUDE.md
把语言、沟通风格、安全边界和 Git 习惯写进用户级 CLAUDE.md，让 Claude Code 在所有项目里都按你的方式工作，附 language 设置的补充用法。
前端项目 CLAUDE.md 模板
面向 React、Next.js、Astro 等前端项目的 CLAUDE.md，包含常用命令、组件约定、可访问性与输入法细节，以及按文件类型拆分规则的写法。
跨工具通用的 AGENTS.md
用一份 AGENTS.md 同时服务多个编码智能体，并说明 Claude Code 何时直接读取它、何时需要 CLAUDE.md 里的 @AGENTS.md 引用或软链接。
通用 CLAUDE.md 骨架
一份适用于任何项目的 CLAUDE.md 起步骨架，涵盖命令、目录、约定、禁区和已知坑，复制后替换占位符即可，建议控制在 200 行以内。
提示词8
提示词：为现有代码补测试
先让智能体读懂现有测试风格和未覆盖的分支，再按边界、异常、回归三类补测试，并用故意改坏代码的方式确认新测试真的有用。
提示词：代码评审
让智能体以评审者而非作者的身份审阅 diff，只报告影响正确性、安全和需求的问题，并附证据与复现场景，减少无意义的风格挑刺。
提示词：安全重构
重构前先用测试钉住现有行为，再分小步修改，每一步都运行测试并单独提交，让智能体在不改变外部行为的前提下整理结构，随时可回退。
提示词：把截图还原成页面
提供设计稿或网页截图，让智能体先拆解结构再实现，并通过截图对比逐项修正差异，适合快速还原落地页、卡片和后台界面。
提示词：排查 bug（复现、定位、修复、验证）
把排查拆成复现、定位、修复、验证四步，要求先写出会失败的测试再动手，并限制猜测次数，避免智能体靠压制报错来交差。
提示词：生成提交信息与 PR 描述
让智能体根据暂存区 diff 和近期提交风格写提交信息，再生成包含背景、改动、测试与风险的 PR 描述，写清楚没验证到的内容，不夸大。
提示词：陌生代码库导览
刚接手陌生项目时，让智能体按固定顺序读代码，并产出带文件位置的导览文档，帮你在一小时内搞清结构、主流程、测试方式和风险区。
提示词：需求澄清与写规格
让智能体先采访你、再把模糊想法整理成带验收标准的 SPEC.md，适用于动手前还没想清楚的中大型功能，避免做到一半发现方向错了。
工作流3
工作流：探索、计划、实现、提交
官方推荐的四阶段开发流程，用计划模式把读代码和改代码分开，配套每一阶段可直接发送的提示词，适合改动涉及多个文件或不熟悉的代码时使用。
工作流：测试驱动的智能体开发
先写失败测试、再提交测试、再让智能体实现并让它不得修改测试，最后由独立会话评审，用可执行的检查替代人盯人，适合需求明确的功能。
工作流：用 git worktree 并行开发
用 claude --worktree 为每个任务创建独立检出和分支，让多个会话同时开发互不覆盖，并说明依赖安装、环境文件、清理和基线分支的注意点。
配置3
.mcp.json 项目级 MCP 配置示例
用项目根目录的 .mcp.json 为团队共享 MCP 服务器，示例包含远程 HTTP、带令牌的请求头和本地 stdio 数据库，并说明环境变量、审批与优先级。
Hooks：编辑后自动格式化
用 PostToolUse hook 在 Claude 每次编辑或写入文件后自动运行 Prettier 或 ruff，保证格式稳定，附可处理空格路径与多语言的脚本版本。
settings.json 权限白名单示例
一份项目级 .claude/settings.json 示例，用 allow、ask、deny 三类规则减少权限弹窗，同时挡住密钥文件读取，并解释规则顺序与路径写法的坑。