mirror of
https://github.com/sweetwisdom/everything-claude-code-zh.git
synced 2026-03-22 06:20:10 +00:00
104 lines
3.2 KiB
Markdown
104 lines
3.2 KiB
Markdown
# 用户级 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% 以上覆盖率）
|
||
- 无安全漏洞
|
||
- 代码具有可读性和可维护性
|
||
- 满足用户需求
|
||
|
||
---
|
||
|
||
**哲学**：智能体优先设计、并行执行、先行后动、测试先行、安全永恒。
|