everything-claude-code-zh/examples/user-CLAUDE.md

用户级 CLAUDE.md 示例

这是一个用户级 CLAUDE.md 文件示例。请放置在 ~/.claude/CLAUDE.md。

用户级配置全局适用于所有项目。用于：

• 个人编码偏好
• 你希望始终强制执行的通用规则
• 指向你的模块化规则的链接

---

核心哲学（Core Philosophy）

你是 Claude Code。我使用专门的智能体（Agents）和技能（Skills）处理复杂任务。

核心原则：

1. 智能体优先（Agent-First）：将复杂工作委托给专门的智能体
2. 并行执行（Parallel Execution）：尽可能使用 Task 工具配合多个智能体
3. 先计划后执行（Plan Before Execute）：对复杂操作使用计划模式（Plan Mode）
4. 测试驱动（Test-Driven）：在实现前编写测试
5. 安全第一（Security-First）：绝不妥协安全性

---

模块化规则（Modular Rules）

详细指南位于 ~/.claude/rules/：

规则文件	内容
security.md	安全检查、密钥管理
coding-style.md	不可变性、文件组织、错误处理
testing.md	测试驱动开发（TDD）工作流、80% 覆盖率要求
git-workflow.md	提交格式、PR 工作流
agents.md	智能体编排（Agent Orchestration）、何时使用哪个智能体
patterns.md	API 响应、仓库模式（Repository Patterns）
performance.md	模型选择、上下文管理
hooks.md	钩子系统（Hooks System）

---

可用智能体（Available Agents）

位于 ~/.claude/agents/：

智能体	用途
planner	功能实现计划
architect	系统设计与架构
tdd-guide	测试驱动开发指南
code-reviewer	质量/安全代码审查
security-reviewer	安全漏洞分析
build-error-resolver	构建错误解决
e2e-runner	Playwright 端到端（E2E）测试
refactor-cleaner	死代码清理
doc-updater	文档更新

---

个人偏好

隐私（Privacy）

• 始终脱敏日志；绝不粘贴密钥（API key/Token/密码/JWT）
• 分享前检查输出 - 移除任何敏感数据

代码风格（Code Style）

• 代码、注释或文档中不使用表情符号（Emoji）
• 偏好不可变性（Immutability） - 绝不修改对象或数组
• 倾向于多个小文件而非少数大文件
• 通常为 200-400 行，单文件最大 800 行

Git

• 规范提交（Conventional Commits）：feat:、fix:、refactor:、docs:、test:
• 提交前始终在本地进行测试
• 小型、专注的提交

测试（Testing）

• 测试驱动开发（TDD）：先编写测试
• 最低 80% 覆盖率
• 关键流程需具备 单元 + 集成 + E2E 测试

---

编辑器集成（Editor Integration）

我使用 Zed 作为我的主要编辑器：

• 智能体面板（Agent Panel）用于文件追踪
• CMD+Shift+R 用于命令面板（Command Palette）
• 启用 Vim 模式

---

成功指标（Success Metrics）

当满足以下条件时，你即是成功的：

• 所有测试通过（80% 以上覆盖率）
• 无安全漏洞
• 代码具有可读性和可维护性
• 满足用户需求

---

哲学：智能体优先设计、并行执行、先行后动、测试先行、安全永恒。