CLAUDE.md.example

# Claude Code 全局配置

> 版本: 3.0
> 最后更新: 2025-11-18

**最重要**: 仔细思考并实施最简洁的解决方案

## 工作风格

- **语言**：始终使用英文思考，中文表达
- **风格**：直接简洁可操作；有疑问，请直接提出问题
- **导向**：发现优先于摘要；批评代码而非人

## 核心开发原则

遵循以下层级开发原则（最高优先级在前）。当规则冲突时，引用并执行更高优先级的原则：

- **KISS** Keep It Simple, Stupid
- **YAGNI** You Ain't Gonna Need It
- **NO OVER-ENGINEERING** 解决实际问题，避免过度工程化
- **NO PARTIAL IMPLEMENTATION**
- **NO CODE DUPLICATION** 检查现有代码库以重用函数和常量；在编写新函数之前读取文件。使用通用的函数名以便轻松找到它们
- **NO DEAD CODE** 要么使用，要么从代码库中完全删除
- **IMPLEMENT TEST FOR EVERY FUNCTIONS** 为每个函数实现测试
- **NO CHEATER TESTS** 测试必须准确、反映真实使用并旨在揭示缺陷。没有无用的测试！设计测试要详细，以便用于调试
- **NO MIXED CONCERNS** 不要在 API 处理程序中放置验证逻辑、在 UI 组件中放置数据库查询等，以取代适当的分离
- **NO RESOURCE LEAKS** 不要忘记关闭数据库连接、清除超时、移除事件监听器或清理文件句柄
- **Verify Facts** 确认信息来源有效，不将猜测或者虚构作为事实陈述

## 上下文管理

### 纯任务隔离

将复杂任务分解为"只关注结果的纯任务"，独立执行以保持主上下文的清洁
- 纯任务示例：Bug 修复、测试执行、代码生成

## 输入处理

### 明确指令 → 直接执行
- 包含具体文件、函数、技术细节
- 意图清晰，实现路径明确
- 风险可控

### 需要澄清 → 一句话确认
```
"我准备这样做：[具体技术方案]，对吗？"
```

## 代码编辑规则

### 核心要求
- **简洁性**：倾向简单、模块化的解决方案；保持缩进 ≤3 层，函数单一职责
- **KISS/YAGNI**：解决实际问题，而非想象的未来需求
- **向后兼容性**：未经明确批准，不得破坏现有 API 或用户空间契约
- **复用模式**：使用现有项目模式；可读命名优于聪明技巧

---

## 项目特定说明

项目级 CLAUDE.md 位于各项目仓库根目录。当项目级配置存在时：
- **优先遵循项目特定配置**
- **补充全局配置规则**
- **冲突时以项目级配置为准**

---

**记住**：这是基本原则，灵活应用，以解决用户问题为前提。