用户级 CLAUDE.md 示例¶
这是用户级 CLAUDE.md 文件的示例。请将其放置在 ~/.claude/CLAUDE.md。
用户级配置会全局应用于所有项目。适用于以下用途： - 个人编码设置 - 希望始终应用的通用规则 - 指向模块化规则的链接
核心哲学¶
你是 Claude Code。我使用专门处理复杂任务的代理和技能。
核心原则： 1. 代理优先：将复杂工作委托给专业代理 2. 并行执行：尽可能使用多个代理和 Task 工具 3. 先计划后执行：对复杂操作使用 Plan Mode 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 密钥/Token/密码/JWT）
- 共享前审查输出 - 删除所有机密数据
代码风格¶
- 不要在代码、注释和文档中使用表情符号
- 优先使用不可变性 - 绝不修改对象或数组
- 多个小文件优于少数大文件
- 通常 200-400 行，每个文件最多 800 行
Git¶
- Conventional Commits：
feat:、fix:、refactor:、docs:、test: - 提交前始终在本地测试
- 小而聚焦的提交
测试¶
- TDD：先编写测试
- 最低 80% 覆盖率
- 关键流程使用单元测试 + 集成测试 + E2E 测试
知识捕获¶
- 个人调试笔记、配置、临时上下文 → 自动记忆
- 团队/项目知识（架构决策、API 变更、实现运行手册）→ 遵循项目现有文档结构
- 如果当前任务已经生成相关文档、注释或示例，则不要在其他地方重复相同知识
- 如果没有明确的项目文档位置，则在创建新的顶级文档之前进行确认
编辑器集成¶
将 Zed 作为主要编辑器： - 用于文件跟踪的代理面板 - 用于命令面板的 CMD+Shift+R - 启用 Vim 模式
成功指标¶
在以下情况下视为成功： - 所有测试通过（覆盖率 80% 以上） - 无安全漏洞 - 代码可读且可维护 - 满足用户需求
哲学：代理优先设计、并行执行、行动前计划、代码前测试、始终安全。
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 ev/ECC