企业官网建设流程全解析

如何 5 步搭建自己的 Claude Code 自定义规则插件：andrej-karpathy-skills 完整指南

【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills

用 andrej-karpathy-skills 这类 Claude Code 插件给模型立规矩，能减少不少常见的 LLM 编码错误。装完官方技能你多半会想：它只有 4 条原则，我自己项目里的规范怎么写进去？这篇文章带你从零走通构建自定义规则插件的完整流程，从安装、读懂规则结构，到写出第一条能生效的自定义规则。

为什么 Claude Code 总爱"自由发挥"

你肯定遇到过这种场景：让它写个参数校验函数，结果返回 200 行代码，捎带一个配置项、一层抽象，还把旁边文件里不相关的注释"顺手"改了。这不是模型笨，是 LLM 的典型毛病——默默做错误假设、喜欢过度设计、顺手"完善"不该碰的代码。

andrej-karpathy-skills 就是针对这些毛病做的：它把四大原则浓缩进一个规则文件（仓库里的 SKILL.md，根目录的 CLAUDE.md 是它的对应版本），让 Claude Code 的行为从"实习生"变成"资深工程师"。读懂它的写法，你就能照着写自己的规则插件。

🚀 3 分钟装好 andrej-karpathy-skills

在 Claude Code 里执行两条命令：

/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skills@karpathy-skills

第一条添加插件市场，第二条安装技能，装完在你所有项目里全局生效。

怎么确认它生效了？新开一个任务，观察两点：模型动手前会不会先澄清需求；diff 里是不是只有你要求的改动。都成立，说明规则在起作用。

拆解四大原则：规则是"写"出来的

自己写插件前，先看懂官方规则长什么样。打开 skills/karpathy-guidelines/SKILL.md，结构一目了然：

• Frontmatter：name 加 description，其中 description 是关键，它决定技能什么时候被触发
• 原则正文：每条一句话定调，然后给"要/不要"的短句列表，最后附一个可验证的检验标准

四大原则分别对应四类典型翻车：

注意文件开头那句 tradeoff：这套规则偏向"谨慎优先于速度"，改个错别字这种小事不用上全套。写自定义规则时请记住这一点——规则别把简单任务拖慢。

自定义规则插件怎么写：5 步流程

以 SKILL.md 为参照模板，流程可以压缩成 5 步：

1. 定一个可验证的目标——别写"代码要干净"，写"新增 API 必须有对应测试"。模糊需求先转成可检查的标准，这正是 Goal-Driven Execution。
2. 照搬官方结构——复用 frontmatter 加短句列表的格式。规则必须是模型能直接执行的短句，不是散文。
3. 写最小规则——从 1~2 条开始，比如一条命名规范：

## 命名规范 - 导出的函数一律用 camelCase - 常量一律用 UPPER_SNAKE_CASE

Simplicity First 在这里同样适用：50 字能说清的事，别写 200 字。

4. 在测试项目里验证——把规则放进测试项目的 CLAUDE.md，喂一个会触发规则的场景（比如让模型写个没测试的接口），看它是否遵守。
5. 集成进真实项目——验证通过后，合并进项目 CLAUDE.md，或打包成技能在多项目复用。

⚠️ 避坑：规则不生效的三种典型情况

• 规则太长，模型注意力被稀释：一条规则控制在 10 行以内，超过 3 条就拆文件
• description 写得太泛：frontmatter 里的 description 是触发条件，写"编码规范"没用，要学官方写成"在编写、审查或重构代码时使用"
• 规则和现有风格打架：Surgical Changes 要求匹配现有风格，自定义规则如果跟项目实际习惯相反，模型会表现得很怪

还有一个隐藏 tradeoff：官方规则刻意让谨慎优先于速度。如果你觉得 Claude 问的问题太多，可以在规则里补一句"改动少于 10 行时直接执行，不要提问"。

今天就能做的第一件事：翻出仓库里的 SKILL.md，挑一条你项目里最常被违反的约定（比如"别删别人留下的死代码"），照格式写成一条最小规则，丢进测试项目验证一次。跑通一条，再谈扩到下一条。

【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills