andrej-karpathy-skills

English | 中文

仓库概要

这个仓库把一组受 Karpathy 启发的紧凑编码准则，打包成了可复用的 Claude Code 资产。

它通过三种表面暴露同一套核心指导：

• 用 CLAUDE.md 作为仓库级行为层
• 用 skills/karpathy-guidelines/SKILL.md 作为 Claude Code skill
• 用 .claude-plugin/ 元数据作为可安装的 Claude plugin

它的中心判断是：一套小而锋利的行为契约，可以对冲一类反复出现的 LLM 编码失误，包括静默假设、过度工程、波及无关代码的宽泛修改，以及模糊的成功标准。

核心准则

这个仓库把指导整理成四条原则：

1. 编码前先思考

   • 显式写出假设
   • 遇到歧义时先暴露，而不是偷偷选一个
   • 如果有更简单的路径，就应该顶一下
   • 搞不清时就停下来问

2. 简单优先

   • 只解决被要求的问题
   • 不要预埋投机性抽象
   • 不要添加没人要求的可配置性
   • 如果臃肿方案能缩到更小，就应该重写

3. 外科手术式修改

   • 只改和请求直接相关的行
   • 不顺手清理旁边无关代码
   • 优先贴合局部风格，而不是强行换风格
   • 只清理由本次改动制造出来的死代码

4. 目标驱动执行

   • 把请求翻译成可验证结果
   • 优先用测试或显式检查定义成功标准
   • 用短计划并给每一步配验证动作

重要仓库表面

• README.md：面向人的解释、安装方式与动机
• CLAUDE.md：可复用的紧凑行为层
• skills/karpathy-guidelines/SKILL.md：同一套准则的 skill 形态
• .claude-plugin/plugin.json：Claude Code 分发所需 plugin 元数据
• .claude-plugin/marketplace.json：市场元数据
• EXAMPLES.md：示例用法或提示样式

为什么这个来源值得收录

这个仓库不是 Karpathy 那条线程本身，而是一个下游打包动作。

它展示了 X 上的操作者观察如何很快被封装成可复用的 coding-agent 分发资产，跨越了：

• 项目内说明文件
• 可复用 skills
• plugin 安装表面

因此，它可以作为 agent-first repository 设计，以及“可复用 agent 操作模型如何分发”这件事的一个证据来源。

README 原始观点摘录

README 对底层问题的表述大意是：

模型会替你做错误假设，然后不检查就一路跑下去。它们不会管理自己的困惑，不会主动求澄清，不会暴露不一致，不会展示权衡，也不会在该反驳的时候反驳。

仓库把四条原则定位成对这类反复失误的直接行为回应。

本地备注

• 这个 raw 文件是基于 2026-04-16 仓库快照整理的编辑型来源笔记。
• 仓库里还包含一个更紧凑的 skills/karpathy-guidelines/SKILL.md 版本，表达的是同一套准则。
• 如果以后这类 Karpathy 衍生打包仓库变多，可能值得单独拆一个更细的 source family。