multica-ai / andrej-karpathy-skills

multica-ai/andrej-karpathy-skills

open_in_new前往仓库

一个基于Andrej Karpathy对LLM编码陷阱观察的CLAUDE.md文件，用于改进Claude Code行为。

项目概览

项目概述

andrej-karpathy-skills 是一个面向 Claude Code 的行为准则/技能仓库，核心内容是一个 CLAUDE.md 文件。它根据 Andrej Karpathy 对 LLM 编程常见问题的观察，将改进 Claude Code 行为的原则整理为可安装、可复用的规则。仓库同时包含 Cursor 项目规则文件（.cursor/rules/karpathy-guidelines.mdc），并提供了 README 中文版。

核心功能

仓库用四个原则应对 LLM 编程中的典型问题：

原则解决的问题
Think Before Coding（先思考再编码）错误假设、隐藏困惑、缺少权衡
Simplicity First（简洁优先）过度复杂化、抽象膨胀
Surgical Changes（外科手术式修改）无关改动、修改不该碰的代码
Goal-Driven Execution（目标驱动执行）通过测试优先、可验证的成功标准来驱动

具体包括：明确陈述假设、遇到歧义时询问、拒绝过度设计、只修改与任务直接相关的行、清理由自己改动产生的孤儿代码、用测试定义成功标准并循环验证等。

适用与不适用场景

根据仓库内容，适用场景包括：

  • 使用 Claude Code 或 Cursor 进行非平凡编码任务时，希望减少不必要的 diff 和返工。
  • 已有一定复杂度的项目，需要约束 AI 不要“顺手”改动无关代码。
  • 需要将命令式任务转化为可验证目标的中长期开发任务。

不适用/需慎用场景：

  • 简单拼写修正、明显的一行修改等琐碎任务（仓库明确提示不需要完整严谨流程）。
  • 对速度要求极高、且错误成本很低的场景。
  • 不读取 CLAUDE.md 或该插件规则的 AI 工具。

技术架构与依赖

仓库资料未提供完整技术架构或依赖清单。从现有内容看：

  • 核心交付物为单个 CLAUDE.md 文本文件。
  • 插件安装方式依赖 Claude Code 的 plugin marketplace 机制。
  • 另含一个 Cursor 规则文件 .cursor/rules/karpathy-guidelines.mdc。
  • 未提供语言、构建工具、运行时依赖等信息。

安装与快速开始

仓库 README 提供两种安装方式。

方式 A：Claude Code 插件（推荐）

在 Claude Code 中添加 marketplace：

/plugin marketplace add forrestchang/andrej-karpathy-skills

然后安装插件：

/plugin install andrej-karpathy-skills@karpathy-skills

方式 B：CLAUDE.md（按项目）

新项目：

curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md

已有项目追加：

echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md

在 Cursor 中使用时，仓库已提交 .cursor/rules/karpathy-guidelines.mdc，可按 CURSOR.md 中的说明将其用于其他项目。

典型使用方法

将四原则以可执行的方式嵌入工作流：

  • 编码前先明确假设，遇到歧义时列出多种解释并请用户确认。
  • 尽量用最少代码解决问题；不添加未被要求的特性、抽象、灵活性或错误处理。
  • 修改现有代码时，不“顺手”重构、不改善相邻代码、不删除预先存在的死代码；只清理自己改动产生的未使用引用。
  • 把“添加校验”改为“为无效输入写测试并让测试通过”；把“修复 Bug”改为“先写复现测试再修复”。

多步骤任务可先列计划：

1. [步骤] → 验证: [检查项]
2. [步骤] → 验证: [检查项]
3. [步骤] → 验证: [检查项]

配置与部署要点

  • 这些规则适合与项目专属规则合并，可写入已有 CLAUDE.md 或新建一个。
  • 可在 CLAUDE.md 中追加“Project-Specific Guidelines”小节，加入 TypeScript strict、API 测试要求等具体约定。
  • 插件方式安装后，技能可在所有项目中生效；CLAUDE.md 方式则只影响单个项目。
  • Cursor 用户可参考 CURSOR.md 和 .cursor/rules/karpathy-guidelines.mdc 配置文件。
  • 仓库提示这些准则偏向“谨慎优先于速度”，琐碎任务可自行判断是否完整执行。

限制、风险与许可证

  • 许可证：README 声明为 MIT。仓库元数据未提供 license 字段，但 README 明确写出 MIT。
  • 适用范围有限：它不能替代调试或项目架构决策，只约束代码生成行为。
  • 过度谨慎可能降低简单任务的速度；仓库已给出权衡说明。
  • 安装命令中的 marketplace 地址为 forrestchang/andrej-karpathy-skills，与当前仓库地址 multica-ai/andrej-karpathy-skills 不一致，使用前请确认实际可用的 marketplace 路径。
  • 仓库未提供 release、changelog、issue 模板或贡献指南。

官方链接

信息来源和分析时间

信息来源：GitHub 仓库元数据（owner、url、description）及 README.md；仓库未包含 documents 或 latestRelease 内容。分析时间：2026-04-27。