企业官网建设流程全解析

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 把卡帕西对 LLM 编码陷阱的观察写进一个 CLAUDE.md，用四条原则压住模型瞎假设、过度设计的毛病。适合 AI 编码用户。

一句话说清项目

它不是代码模板，也不是 Agent 框架，而是一个 CLAUDE.md 指令文件：Claude Code 读到它之后，会按四条行为准则干活——先想后写、从简写、只碰该碰的、对着目标自我验证。

🔧 装好并跑起来

这一节给两条安装路径，装完即可用，"跑起来"就是让 Claude Code 在项目里加载它。

方法 A（推荐）：Claude Code 插件，一次安装，所有项目可用。在 Claude Code 里直接执行两条斜杠命令：

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

方法 B：CLAUDE.md，按项目配置。先 clone 仓库，把根目录的CLAUDE.md复制到你的项目根目录：

git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills

项目里已有CLAUDE.md就用追加而不是覆盖，避免冲掉你现有的规则。用 Cursor 的话注意它默认不读CLAUDE.md，要把.cursor/rules/karpathy-guidelines.mdc拷进项目的.cursor/rules/目录，再在 Settings → Rules 里确认规则已加载。

它到底在做什么

这一节讲文件的核心设计：四条原则各对治 Karpathy 指出的一个 LLM 坑。

1. Think Before Coding（编码前思考）：显式陈述假设，有歧义就列出多种解释去问，不许默默选一个。反例：模型默默假设全量导出、写成 JSON 文件，然后直接开写。正例：先问"导出全部用户还是筛选后的子集？"
2. Simplicity First（简洁优先）：用最小代码解决问题，不写任何投机成分。反例：一个折扣函数套上抽象类、策略模式和配置 dataclass。正例：amount * (percent / 100)一行写完。
3. Surgical Changes（精准修改）：只碰必须改的，自己改动产生的孤儿代码要清理，存量死代码只提一句、不删。反例：修 bug 时顺手改了引号风格、补了类型注解。正例：只改导致空邮箱崩溃的那几行。
4. Goal-Driven Execution（目标驱动执行）：把祈使式任务转成可验证的目标，循环到验证通过为止。反例："修一下认证系统"然后动手，标准不明。正例："写一个能复现问题的测试，让它通过，再确认存量测试没挂。"

场景推演

这一节用统一三步对比走两个高频场景，取自仓库的EXAMPLES.md。

场景一：添加用户数据导出功能。

• 用户怎么说："加一个导出用户数据的功能"
• 默认/错误做法：模型默默假设全量导出、写到 users.json、只含三个字段，交上来 30 行代码
• 正确做法：先列出四个问题——全量还是筛选、浏览器下载还是后台任务还是 API 端点、包含哪些字段（有的敏感）、用户量级多大，确认后再动手

场景二：添加计算折扣的函数。

• 用户怎么说："加一个计算折扣的函数"
• 默认/错误做法：抽象类 + 策略模式 + 配置 dataclass，30 多行，没人要求过其中任何一件
• 正确做法：一个函数，return amount * (percent / 100)；等真需要多种折扣类型时再重构

✅ 自检清单

这一节给 5 个可观察信号，拿它对照你最近的 diff 和 PR：

• 如果看到 diff 里只有请求的改动，没有顺手修改和格式重排，说明它在生效
• 如果看到代码第一次就是简单的，不需要为过度设计重写，说明它在生效
• 如果看到澄清问题出现在动手之前而不是出错之后，说明它在生效
• 如果看到多步任务带"步骤 → 验证"的计划，且每步可独立验证，说明它在生效
• 如果看到 PR 小而干净，没有顺手重构，说明它在生效

把指南融进你的项目

这一节讲如何把 andrej-karpathy-skills 与你现有配置合并，四条原则本身就是为合并设计的：放进项目根目录，或追加到现有CLAUDE.md尾部。

常见做法有三种：

1. 在CLAUDE.md后加一节项目规则，如"使用 TypeScript 严格模式""所有 API 端点必须有测试"
2. 指向既有约定，如"遵循src/utils/errors.ts中现有的错误处理模式"
3. 多工具并行的团队，保持CLAUDE.md和 Cursor 规则文件同步，避免行为漂移

⚠️ 什么时候别用

这一节讲代价：四条原则偏向谨慎而非速度，模型会多问、小任务会变慢。改错别字、显而易见的单行修复这类琐碎活，不必上全套严谨性，用判断力即可。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