CLAUDE.md 优化指南

编写能最大限度提升Claude遵循度和性能的CLAUDE.md文件。

核心原则：少即是多

冗长的CLAUDE.md = Claude会忽略其中一半内容。关键规则淹没在噪音中。

针对每一行内容，请自问："删除这条内容是否会导致Claude犯错？"

• 如果不会 → 删除它
• 如果Claude已经能正确处理 → 删除它或转为钩子提示

应包含的内容

基本要素（高价值）

仅当非标准时包含

• 分支命名（如果不是feature/、fix/）
• 提交格式（如果不是约定式提交）
• 文件边界（需避免的敏感文件）

请勿包含

• Claude已了解的内容（通用编码实践）
• 显而易见的模式（可从现有代码中检测到）
• 冗长的解释（请简洁）
• 理想化规则（仅包含您遇到的实际问题）

结构

# Project Name

One-line description.

## Commands
- Test: `npm test`
- Build: `npm run build`
- Lint: `npm run lint`

## Code Style
- [Only non-obvious conventions]

## Architecture
- [Brief, only if complex]

## IMPORTANT
- [Critical warnings - use sparingly]

格式化规则

• 要点列表优于段落
• Markdown标题分隔模块（防止指令渗透）
• 具体明确优于模糊表述：用"2空格缩进"而非"正确格式化"
• 重要/必须遵守用于关键规则（谨慎使用否则会失效）

文件放置

优化检查清单

最终确定前：

• 是否少于50行？（理想目标）
• 每一行是否都解决了你实际遇到的问题？
• 与其他CLAUDE.md位置无冗余？
• Claude默认不遵循任何指令吗？
• 通过观察Claude的行为是否改变来测试？

维护

• 运行/init以此为起点，然后积极删减
• 每隔几周："审查此CLAUDE.md并建议删除内容"
• 当Claude行为不当时：添加特定规则
• 当Claude忽略规则时：文件过长，删减其他内容

反模式

示例：最小有效 CLAUDE.md

# MyApp

React Native app with Expo. Backend is Supabase.

## Commands
- `pnpm test` - run tests
- `pnpm ios` - run iOS simulator

## Style
- Prefer Zustand over Context
- Use `clsx` for conditional classes

## IMPORTANT
- NEVER commit .env files
- Auth logic lives in src/lib/auth.ts only

约15行。涵盖Claude无法推断的内容。仅此而已。