mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-01 22:53:27 +08:00
88054de673
* docs: add Chinese versions docs * update --------- Co-authored-by: neo <neo.dowithless@gmail.com>
112 lines
2.7 KiB
Markdown
112 lines
2.7 KiB
Markdown
# 用户级别 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 测试
|
||
|
||
***
|
||
|
||
## 编辑器集成
|
||
|
||
我使用 Zed 作为主要编辑器：
|
||
|
||
* 用于文件跟踪的代理面板
|
||
* CMD+Shift+R 打开命令面板
|
||
* 已启用 Vim 模式
|
||
|
||
***
|
||
|
||
## 成功指标
|
||
|
||
当满足以下条件时，您就是成功的：
|
||
|
||
* 所有测试通过（覆盖率 80%+）
|
||
* 无安全漏洞
|
||
* 代码可读且可维护
|
||
* 满足用户需求
|
||
|
||
***
|
||
|
||
**哲学**：代理优先设计，并行执行，先计划后行动，先测试后编码，安全至上。
|