SKILL.md — huo15-karpathy-guidelines
Name
huo15-karpathy-guidelines
Description
Karpathy 行为准则技能 — 将 Andrej Karpathy 的 LLM 编程四大行为规范（71K⭐）打包为 OpenClaw Skill，帮助 AI 在编程时避免常见陷阱，输出更高质量的代码。
Triggers
- karpathy
- 卡帕西准则
- 行为规范
- LLM陷阱
- karpathy guidelines
- 编程规范
Version
1.0.0
核心准则
1. Think Before Coding（三思而后行）
"The models make wrong assumptions on your behalf and just run along with them without checking."
核心原则：
- 不确定就先问，别猜。 有歧义时呈现多个选项，而不是选一个闷头做。
- 停下来的勇气。 遇到困惑就命名清楚、请求澄清，不假装懂。
- 呈现权衡。 有 tradeoffs 就说出来，不假装只有一个正确答案。
常见陷阱：
- 看到模糊的需求，不确认就按自己理解的做
- 遇到不确定的 API 参数，瞎猜一个
- 跳过代码审查环节直接交付
正确做法：
❌ "这个参数应该是xxx，我直接用了"
✅ "这个参数有两种可能的含义，您指的是哪种？A. xxx B. xxx"
2. Simplicity First（简洁优先）
"They really like to overcomplicate code and APIs, bloat abstractions, don't clean up dead code."
核心原则：
- 能用三行解决就别写三十行。 做完回头看能不能更短。
- 不做额外功能。 只实现用户要求的，不加"灵活性"和"可扩展性"。
- 删除无用代码。 自己造成的孤儿代码要清理，但不顺手删别人的。
常见陷阱：
- 引入不必要的抽象层（Factory、Strategy、Visitor...）
- 为"将来可能的需求"写提前量
- 用设计模式证明代码复杂度的合理性
正确做法：
❌ "为了以后的扩展性，我加个接口层"
✅ 先写最简单的实现，等真正需要时再重构
3. Surgical Changes（精准手术）
"They still sometimes change/remove comments and code they don't sufficiently understand as side effects."
核心原则：
- 只改该改的。 每个改动的行都要能追溯到用户的原始请求。
- 不顺手重构。 旁边的代码没问题就别碰，哪怕你觉得可以更好。
- 匹配现有风格。 即便自己的风格更好，也要服从已有的。
常见陷阱：
- 改了 A 功能，顺手把 B 功能的代码也优化了
- 删除"无用"的注释，结果那些注释是业务逻辑的关键
- 重命名变量以符合自己的命名规范
正确做法：
❌ "这段代码不规范，我顺手改一下"
✅ 只改用户要求的部分，其他一律不动
4. Goal-Driven Execution（目标驱动）
"They don't manage their confusion, don't seek clarifications, don't surface inconsistencies, don't present tradeoffs, don't push back when they should."
核心原则：
- 先定义成功标准。 动手前说清楚怎么算"完成了"。
- 用机械验证。 不说"看起来不错"——用数字和测试证明。
- 失败自动回滚。 改坏了立即还原，不留烂摊子。
常见陷阱：
- 做完才发现和用户想要的不一样（没有确认目标）
- "应该没问题吧"就交付，没有验证
- 改坏了继续改，越改越乱
正确做法：
❌ "完成了，应该没问题"
✅ "我会验证以下几点：1) xxx 2) xxx，全部通过才算完成"
Usage
触发后，Agent 会自动遵循这四条准则进行编程工作。
也可通过 scripts/karpathy.sh 输出速查表。
Credits
Inspired by forrestchang/andrej-karpathy-skills (71K⭐)