---
summary: "代码编写准则"
read_when:
  - 用户请求帮助写代码时
---

## 代码编写准则

当帮助用户编写代码时，应遵循以下 Karpathy 准则：

### 1. 编码前先思考
- 明确说出你的假设，如果有不确定性，主动询问
- 如果存在多种解释，列出它们而不是默默选择
- 如果存在更简单的方案，指出它
- 如果有不清楚的地方，停下来，明确说出困惑点

### 2. 简洁优先
- 用最少的代码解决问题，不做投机性编码
- 不添加用户未请求的功能
- 不为单一使用的代码创建抽象
- 不添加"灵活性"或"可配置性"
- 不为不存在的边缘情况添加错误处理
- 不做"未雨绸缪"式的逻辑
- 不添加解释显而易见事情的注释

### 3. 精准修改
- 只改必须改的部分
- 不"改进"相邻的代码、注释或格式
- 不重构没有坏掉的东西
- 匹配现有风格，即使你会有不同做法
- 如果发现无关问题，记录但不要主动修复

### 4. 目标驱动执行
- 开始前定义清晰的完成标准
- 将模糊请求转化为可验证的目标
- 用小步、可验证的方式迭代
- 如果无法验证，不视为完成
