andrej-karpathy-skills

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

# Andrej Karpathy Skills 仓库分析报告 ## 1. 仓库的主要功能和用途 该仓库的核心功能是提供一份标准化的 **`CLAUDE.md` 配置文件**，旨在优化 Anthropic 旗下 AI 编程助手 **Claude Code** 的行为模式。它并非包含具体的业务代码库，而是一套“元指令”集合。 其主要用途是将著名人工智能专家 **Andrej Karpathy** 关于大语言模型（LLM） coding pitfalls（陷阱）的观察，转化为 AI 可理解的系统指令。通过将该文件放置在项目根目录，开发者可以引导 AI 在编写代码时更加谨慎、简洁和准确，从而减少幻觉、过度设计和意外副作用。 ## 2. 技术栈和核心特点 * **技术栈**： * **核心格式**：Markdown (`.md`)。 * **规范标准**：遵循 Claude Code 的 `CLAUDE.md` 上下文规范（一种用于定义 AI 代理行为的项目级配置文件）。 * **语言无关性**：由于是指导 AI 行为的指令集，该仓库不依赖特定编程语言，适用于任何软件开发场景。 * **核心特点**： * **极简主义**：整个项目的核心仅由一个文件构成，易于部署和维护。 * **原则驱动**：不依赖复杂的提示词工程技巧，而是基于四条核心工程原则构建。 * **问题导向**：每一条指令都直接对应 Karpathy 指出的具体 LLM 缺陷（如盲目假设、代码膨胀等）。 ## 3. 项目的价值和优势 * **权威背书与社区验证**：基于 Andrej Karpathy 的行业洞察，且拥有超过 12,000 颗星标，证明了社区对优化 AI 编程质量的强烈需求和对该方案的认可。 * **显著提升代码质量**：通过强制 AI“三思而后行”，有效降低了因 AI 盲目自信导致的逻辑错误和技术债务。 * **降低沟通成本**：减少了开发者反复纠正 AI 错误假设和过度设计的时间，让 AI 更像一名“资深工程师”而非“初级实习生”。 * **即插即用**：无需安装任何依赖，只需将文件复制到项目根目录即可生效，集成成本极低。 ## 4. 适合的用户群体 * **高频 AI 编程使用者**：重度依赖 Claude Code 或类似 AI 编程代理进行日常开发的软件工程师。 * **追求代码质量的团队**：希望统一团队内 AI 输出标准，避免生成臃肿或难以维护代码的技术团队。 * **受困于 AI 幻觉的开发者**：经常遇到 AI 自作主张、误解需求或产生副作用代码的用户。 * **Prompt Engineering 研究者**：希望研究如何将人类工程哲学转化为 AI 系统指令的研究人员。 ## 5. 关键功能和亮点 该仓库将复杂的 AI 行为控制浓缩为 **四大核心原则**，这也是其最大的亮点： 1. **编码前思考 (Think Before Coding)**： * 强制 AI 显式陈述假设，遇到歧义时主动询问而非猜测。 * 要求展示多种解释方案，并在必要时提出反对意见。 2. **简洁优先 (Simplicity First)**： * 严禁过度工程化，只编写解决问题所需的最小代码量。 * 拒绝投机性功能和不必要的抽象层。 3. **手术式修改 (Surgical Changes)**： * 确保修改仅针对目标任务，避免改动无关的正交代码或注释。 * 防止因理解不足而意外删除现有逻辑。 4. **目标驱动执行 (Goal-Driven Execution)**： * 提倡测试驱动（Tests-first），确保成功标准可验证。 * 以最终目标的达成作为执行完毕的标志，而非仅仅生成代码。 ## 6. 一句话总结 **这是一个基于 Andrej Karpathy 工程智慧打造的单文件配置方案，旨在通过四大核心原则将 Claude Code 塑造成更谨慎、简洁且可靠的编程伙伴。**

访问 GitHub 项目