从0到1搭建你的第一个自定义规则插件andrej-karpathy-skills 完全指南【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skillsandrej-karpathy-skills 是一个 Claude Code 插件把 Andrej Karpathy 观察到的 LLM 编码毛病写成了四套行为准则用来约束 AI 写代码。读完这篇完全指南你能照着搭出属于自己的第一个自定义规则插件让代码质量提升变成一件可重复的事。一、为什么需要规则插件先回忆两个熟悉的翻车现场。你让 AI加个用户数据导出功能它默认导出全体用户、文件塞进项目根目录、字段自己挑一套写完才告诉你做完了——每一处决定都没问过你。换个场景更糟你只让它修一行空邮箱崩溃提交的 diff 里却混着引号风格变更、类型标注、顺手优化的相邻函数2 行修复变 50 行噪音。问题不在模型变笨而在 AI 默认闷头执行、自己脑补。规则插件就是解法它相当于一份资深工程师留在团队里的代码审查清单挂在 AI 动手之前把该问的先问、该动的只动变成硬性约束。andrej-karpathy-skills 正是这样一份清单而且它支持你继续往里加自己的条目。二、2分钟快速上手安装与环境准备在 Claude Code 里执行两条命令先添加插件市场再安装插件/plugin marketplace add forrestchang/andrej-karpathy-skills/plugin install andrej-karpathy-skillskarpathy-skills装完这套准则就作为 Claude Code 插件在你所有项目中生效不用逐个仓库配置。如果只想在单个项目里用也可以把仓库里的 CLAUDE.md 复制过去效果一样。三、读懂四大核心原则这四条原则全部写在 skills/karpathy-guidelines/ 的 SKILL.md 里。理解它们的表达方式你后面写自己的规则才有模板可依。Think Before Coding一句话定义动手前先摊牌——假设说出口多种解释摆上桌不确定就停下来问。举例你说让搜索变快AI 不该直接闷头写 200 行缓存和索引而该先问你要的是响应时间、并发吞吐还是加载体验并给出各方案的预估工作量。Goal-Driven Execution一句话定义把去做 X翻译成做到 Y 就算赢然后循环直到验证通过。举例任务修复登录 bug被改写成先写一个能复现该 bug 的测试再让它变绿。标准够强AI 就能自己一轮轮试标准含糊让它能跑你就得全程陪着追问。Simplicity First一句话定义只写解决问题的最少代码一行投机性的都不许有。举例需求是加个折扣计算函数AI 却搭出策略模式、配置类、校验器一整套三十行脚手架——其实一个两行的函数就够。判据很直接资深工程师看到会不会说这也太复杂了。Surgical Changes一句话定义只动必须动的行只清理自己制造的垃圾。举例修空邮箱崩溃时AI 不该顺手改引号风格、加没人要的 docstring、重构没坏的东西。检验标准diff 里每一处改动都能直接追溯到你的那条需求。四、实战从零搭建你的第一个自定义规则下面跟着走一遍完整流程假设你想堵住AI 提交里总混着无关重构这个洞。先定目标。别一上来就写规则先用一句话描述要防住的行为比如diff 里只出现需求相关的改动。目标越具体规则越好验收。接着找模板。把仓库拉到本地看看别人怎么写git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills打开 skills/karpathy-guidelines/SKILL.md结构很清晰头部 frontmatter 写 name 和 descriptiondescription 决定了 AI 什么时候会想起这条技能正文是加粗一句话原则 几条可执行行为要点。照这个骨架抄即可。然后动手写。规则要短5 行以内足够## Diff Discipline - 只修改与需求直接相关的行 - 不改相邻代码的格式、引号、注释 - 发现无关死代码只提及不删除 - 每处改动必须能对应到某条具体需求注意全程克制这就是 Simplicity First 的元应用——别给自己的规则加可配置开关那是投机性功能。再进入测试环节。把规则放进一个真实项目合进 CLAUDE.md 或 skill 目录都行给 AI 一个小 bug 修复任务专门盯 diff出现无关改动说明规则没被触发或措辞太软换更硬的表述、补一条反例再喂一个重构旧模块任务确认它不会过度热情。来回两轮规则基本就稳了。最后做集成。Claude Code 走 skill 目录加 /plugin 安装一次配置全局可用Cursor 用户则把规则放进 .cursor/rules/。上线后观察一两周的 PR发现漏网的模式就补条目发现失效的条目就删掉——规则清单也是活的。五、避坑指南坑一规则写成长篇论文。篇幅一长AI 读不完约束力直接归零。对策每条原则一行加粗定义加几条要点整个文件控制在手机一屏以内。坑二小任务也套全流程。改个错别字也要列计划、写测试开发节奏会崩盘。对策像原项目那样在文件开头就写明简单任务自行判断、不必全套走流程给它留一个豁免出口。坑三规则只放在一份文件里。Claude Code 读 CLAUDE.md 和 skillCursor 读 .cursor/rules/只改一处另一个工具就失忆。对策多端使用时保持 CLAUDE.md、Cursor 规则文件和 skill 文件三处同步。坑四装完就扔永不回测。模型升级、代码库演进之后旧规则可能失效甚至与新行为打架。对策定期拿最近几轮真实 diff 回测规则无效即删有效即留。结语规则模板就在 skills/karpathy-guidelines/ 里照着它现在就把你的第一条规则写进项目的 CLAUDE.md——下一次的 diff会让你立刻看出差别。【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考