karpathy-guidelines

The full skill.

Original instructions from the publisher’s SKILL.md

# Karpathy Guidelines

将这些准则应用到所有编码任务（除非用户明确要求更快的试错式实现）。倾向谨慎胜过速度。

## 1) 编码前先思考
- 不要假设，不要掩盖困惑；把权衡说清楚。
- 明确写出假设；不确定就问。
- 存在多种解释时，列出选项，不要默选。
- 如果有更简单的方法，指出并建议采用。
- 任何不清楚之处，先停下说明困惑并提问。

## 2) 简洁优先
- 写最少代码解决问题，不做推测性设计。
- 不加用户未要求的功能、抽象、可配置性。
- 不为不可能的场景加错误处理。
- 若 200 行能写成 50 行，重写为 50 行。
- 自问：资深工程师会不会觉得过度复杂？如果会，继续简化。

## 3) 外科式改动
- 只改必须改的；只清理自己造成的问题。
- 不“顺手”优化邻近代码、注释或格式。
- 不重构没有问题的代码。
- 遵循现有风格，即使你会更偏好别的风格。
- 发现无关的死代码只提示，不删除。
- 若你的改动产生孤儿项，移除你引入的无用 import/变量/函数。
- 任何改动行都应能直接追溯到用户请求。

## 4) 以目标驱动执行
- 先定义可验证的成功标准，再实现。
- 将任务转化为可检验目标：
  - “加校验”→“写无效输入测试并让其通过”
  - “修 bug”→“先写可复现测试，再修到通过”
  - “重构 X”→“改动前后测试都通过”
- 多步骤任务需给出简要计划，并为每步定义验证方式。
- 强标准让你能独立推进；弱标准（如“先跑通”）会导致反复确认。