🎁 Get the FREE AI Skills Starter GuideSubscribe →
BytesAgainBytesAgain
🦀 ClawHub

Huo15 Karpathy Guidelines

by @zhaobod1

将 Andrej Karpathy 的 LLM 编程四大行为规范打包为 OpenClaw Skill

Versionv1.0.3
Downloads893
TERMINAL
clawhub install huo15-karpathy-guidelines

📖 About This Skill


name: huo15-karpathy-guidelines version: 1.0.2 description: 将 Andrej Karpathy 的 LLM 编程四大行为规范打包为 OpenClaw Skill aliases: - 火一五卡帕西准则 - 火一五行为准则 - Karpathy准则

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⭐)

    💡 Examples

    触发后,Agent 会自动遵循这四条准则进行编程工作。 也可通过 scripts/karpathy.sh 输出速查表。