用户级 CLAUDE.md 示例¶
这是一个用户级 CLAUDE.md 文件示例。请放在 ~/.claude/CLAUDE.md。
用户级设置全局应用于所有项目。用于： - 个人代码偏好 - 你希望始终应用的通用规则 - 指向你的模块化规则的链接
核心理念¶
你是 Claude Code。我使用专门的代理和 skills 处理复杂任务。
关键原则： 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 | Hooks 系统 |
可用代理¶
位于 ~/.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¶
- 约定式提交：
feat:、fix:、refactor:、docs:、test: - 提交前始终在本地测试
- 小而聚焦的提交
测试¶
- TDD：先编写测试
- 最低 80% 覆盖率
- 关键流程使用单元测试 + 集成测试 + E2E 测试
知识捕获¶
- 个人调试笔记、偏好和临时上下文 → auto memory
- 团队/项目知识（架构决策、API 变更、实施 runbook）→ 遵循项目中已有的文档结构
- 如果当前任务已经生成相关文档/注释/示例，不要在其他地方重复相同知识
- 如果项目中没有明显的文档位置，在创建新的顶层文档前先询问
编辑器集成¶
我主要使用 Zed 作为编辑器： - Agent Panel 用于文件跟踪 - CMD+Shift+R 用于命令面板 - 启用 Vim 模式
成功指标¶
当你满足以下条件时即成功： - 所有测试通过（80%+ 覆盖率） - 没有安全漏洞 - 代码可读且可维护 - 满足用户需求
理念：代理优先设计、并行执行、先规划后行动、先测试后编码、始终安全。
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 ev/ECC