你有没有遇到过这种情况让 AI 帮你修一个 bug结果它顺手改了三个变量名、调整了缩进、还加了一堆你根本没要的注释这不是 AI 不好用是你没给它定规矩。今天要介绍的项目来自 OpenAI 创始成员、前特斯拉 AI 总监 Andrej Karpathy 的编程哲学提炼。整个项目只有一个文件却能让你手头的 AI 编程工具从乱写变成靠谱。一、项目是什么Andrej Karpathy Skills 是一个极简主义的 AI 编程行为准则项目。项目地址 https://github.com/forrestchang/andrej-karpathy-skills整个项目本质上就是一个CLAUDE.md文件定义了 AI 编码助手应当遵守的 4 条核心原则。作者 Forrest Chang 把 Karpathy 长期在社交媒体和演讲中表达的编程理念提炼成了可落地的规则让 Claude Code、Cursor 等工具在生成代码时自动遵循。没有复杂的配置没有花哨的框架就是一个文件解决问题。一句话总结给 AI 编程助手立规矩一个文件就够了。二、四大原则详解原则 1Think Before Coding — 先思考再动手核心要义先理解需求再动手别上来就写代码。AI 最容易犯的错误就是没搞清需求就开始输出。你让它优化一下登录模块它可能直接给你重写了一套 OAuth 流程——而你只是想让超时时间从 30 秒改成 60 秒。对比示例场景无准则时 AI 的行为启用准则后 AI 的行为修改超时时间直接重写整个登录模块先列出变更点确认后再改添加新接口顺手重构了三个旧接口只新增接口不动已有逻辑修复空指针改了调用方、被调用方、还加了日志定位根因最小化修复原则 2Simplicity First — 简洁是终极的复杂核心要义能一行解决的不写十行能用标准库的不引入第三方包。Karpathy 的原话是Simplicity is the ultimate sophistication. 这条原则在 AI 编程中尤其重要——AI 天然倾向于过度设计因为它见过太多复杂方案。实战案例# ❌ AI 无准则时的写法 from typing import List, Optional import pandas as pd def get_user_names(user_ids: List[int]) - Optional[List[str]]: df pd.DataFrame({id: user_ids}) # ... 20 行代码 # ✅ 启用 Simplicity First 后的写法 def get_user_names(user_ids: list[int]) - list[str]: return [db.get_name(uid) for uid in user_ids]原则很简单能用列表推导式就别上 Pandas能用标准库就别装第三方包。原则 3Surgical Changes — 像外科手术一样精准核心要义只改需要改的地方不要顺手优化无关代码。这是 AI 生成代码最大的毛病——改一个 bug 顺便改了 20 个无关文件。你 review 的时候会发现变量名被改了、缩进被调了、注释被删了、连没报错的代码也被优化了。实际效果根据项目 issue 区的用户反馈启用这套规则后无关联修改noise diff减少了 50% 以上代码审查通过率明显提升。对于 API 中转站开发者来说这意味着 AI 生成代码的可预测性大幅增强——你知道 AI 只会动它该动的地方。原则 4Goal-Driven — 目标驱动不做无意义重构核心要义所有改动都要服务于明确目标不做无目的重构。这条原则是前三条的总开关。每次 AI 生成代码前先问自己三个问题这次改动的目标是什么修复 bug / 新增功能 / 性能优化改动范围是否最小只改目标相关的文件改动是否可验证有测试覆盖吗如果 AI 想顺便重构一下这条原则会直接拦住它。三、实际效果数据说话根据项目社区的用户反馈数据指标启用前启用后改善幅度无关联修改noise diff高频低频减少 50%代码审查通过率一般明显提升显著改善AI 生成代码的可预测性低高大幅提升Review 耗时长短减少 30%复制表格数据来源项目 GitHub issue 区用户反馈汇总。四、怎么安装使用方式一Claude Code 插件推荐Bash# 在 Claude Code 中直接安装 /plugin marketplace add forrestchang/andrej-karpathy-skills安装后CLAUDE.md会自动加载到每次对话的上下文中无需手动操作。这是最省心的方式。方式二Cursor Rules将项目中的CLAUDE.md内容复制到你的.cursor/rules/目录下Cursor 会自动读取。# 下载文件 curl -o .cursor/rules/karpathy-skills.mdc \ https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md方式三手动复制通用方案curl -o CLAUDE.md \ https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md把这个文件放到项目根目录大部分 AI 编程工具Claude Code、Cursor、GitHub Copilot 等都会自动识别。五、推荐搭配如果你想让 AI 编程能力再上一个台阶可以搭配以下项目一起使用| 项目 | 作用 | 搭配效果 ||------|---------|| addyosmani/agent-skills | 6 阶段工程化 SOP | 从不乱改升级到改得好 || mattpocock/skills | TypeScript TDD 技能 | 代码质量双重保障 || davila7/claude-code-templates | 组件模板商店 | 按需选模板配合准则使用 |组合拳效果Karpathy 准则不乱改 Agent Skills改得好 TDD质量高 模板效率快tips:大模型能力接入claude code上可以接挺多家模型的不一定只接Claude模型Gpt5.5、Glm5.1、Deepseekv4、Kimi K2.6等等都可以的。目前使用国外官方模型API越来越复杂而我有切换多种模型使用的情况选择一个稳定高效价优的API聚合平台就颇为重要了这里大家可以选择适合自己的平台这里以我使用的平台作为举例我接入Claude code就是按照魔芋平台进行。通过对比价格稳定性速度三方面后我决定选择的第三方魔芋api平台来获取API key。点击链接前往api平台https://www.moyu.info/register?affg2d7使用手机号进行注册注册成功后登录进入【令牌管理】配置完成后可以使用新配置的令牌或者初始平台生成的令牌。这样就可以获得APi keyURL地址是https://www.moyu.info然后去Claude code配置即可具体可以参考我Claude code 配置帖子。