# 用户级别 CLAUDE.md 示例

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

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

* 个人编码偏好
* 您始终希望强制执行的全域规则
* 指向您模块化规则的链接

***

## 核心哲学

您是 Claude Code。我使用专门的代理和技能来处理复杂任务。

**关键原则：**

1. **代理优先**：将复杂工作委托给专门的代理
2. **并行执行**：尽可能使用具有多个代理的 Task 工具
3. **先计划后执行**：对复杂操作使用计划模式
4. **测试驱动**：在实现之前编写测试
5. **安全第一**：绝不妥协安全性

***

## 模块化规则

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

| 规则文件 | 内容 |
|-----------|----------|
| security.md | 安全检查，密钥管理 |
| coding-style.md | 不可变性，文件组织，错误处理 |
| testing.md | TDD 工作流，80% 覆盖率要求 |
| git-workflow.md | 提交格式，PR 工作流 |
| agents.md | 代理编排，何时使用哪个代理 |
| patterns.md | API 响应，仓库模式 |
| performance.md | 模型选择，上下文管理 |
| hooks.md | 钩子系统 |

***

## 可用代理

位于 `~/.claude/agents/`：

| 代理 | 目的 |
|-------|---------|
| planner | 功能实现规划 |
| architect | 系统设计和架构 |
| tdd-guide | 测试驱动开发 |
| code-reviewer | 代码审查以保障质量/安全 |
| security-reviewer | 安全漏洞分析 |
| build-error-resolver | 构建错误解决 |
| e2e-runner | Playwright E2E 测试 |
| refactor-cleaner | 死代码清理 |
| doc-updater | 文档更新 |

***

## 个人偏好

### 隐私

* 始终编辑日志；绝不粘贴密钥（API 密钥/令牌/密码/JWT）
* 分享前审查输出 - 移除任何敏感数据

### 代码风格

* 代码、注释或文档中不使用表情符号
* 偏好不可变性 - 永不改变对象或数组
* 许多小文件优于少数大文件
* 典型 200-400 行，每个文件最多 800 行

### Git

* 约定式提交：`feat:`，`fix:`，`refactor:`，`docs:`，`test:`
* 提交前始终在本地测试
* 小型的、专注的提交

### 测试

* TDD：先写测试
* 最低 80% 覆盖率
* 关键流程使用单元测试 + 集成测试 + E2E 测试

### 知识捕获

* 个人调试笔记、偏好和临时上下文 → 自动记忆
* 团队/项目知识（架构决策、API变更、实施操作手册） → 遵循项目现有的文档结构
* 如果当前任务已生成相关文档、注释或示例，请勿在其他地方重复记录相同知识
* 如果没有明显的项目文档位置，请在创建新的顶层文档前进行询问

***

## 编辑器集成

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

* 用于文件跟踪的代理面板
* CMD+Shift+R 打开命令面板
* 已启用 Vim 模式

***

## 成功指标

当满足以下条件时，您就是成功的：

* 所有测试通过（覆盖率 80%+）
* 无安全漏洞
* 代码可读且可维护
* 满足用户需求

***

**哲学**：代理优先设计，并行执行，先计划后行动，先测试后编码，安全至上。
