
10分钟跑通andrej-karpathy-skills用一个CLAUDE.md约束Claude Code行为【免费下载链接】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-skillsClaude Code干活快但它爱替你做假设、爱把简单问题写复杂、还顺手乱改无关代码这三类坑正是LLM辅助编码里最贵的成本。andrej-karpathy-skills用一份CLAUDE.md文件给模型装上行为约束专治这些毛病。读完本文你能在自己的项目上完成部署并在10分钟内判断这套指南是否真的生效。项目定位与适用边界这是一个纯配置型项目没有源码、没有运行时核心就是一个CLAUDE.md文件加几份说明文档。它属于AI编码助手行为准则不是框架也不是工具。如果你日常用Claude Code或Cursor写功能、修Bug、做重构且项目里有既有代码规范、不希望模型顺手改掉那就是它的目标场景。划个边界它不教你写代码也不提供任何运行时能力如果你的项目根本不接编码智能体这份文件帮不上忙——它唯一的工作是约束模型的行为。环境准备与部署路径前置依赖只有两条已安装可用的Claude Code或任何会读取项目根目录CLAUDE.md的编码智能体一个终端没有系统版本要求也不需要安装任何依赖。主路径走插件方式一次安装全局生效。在Claude Code会话里执行两条命令前者添加插件市场后者安装技能$ /plugin marketplace add forrestchang/andrej-karpathy-skills $ /plugin install andrej-karpathy-skillskarpathy-skills装完之后所有项目都会自动应用这份准则不用重复配置。替代路径把CLAUDE.md放进单个项目只想在单个项目启用或你用的智能体不支持插件市场时克隆仓库再拷贝文件即可$ git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills $ cp andrej-karpathy-skills/CLAUDE.md 你的项目根目录/最小验证步骤在项目里运行claude抛一句模糊需求比如加个导出功能。生效的预期输出不是刷出一堆代码而是模型先陈述自己的假设再反问一个澄清问题。核心能力拆解一个任务从需求输入到代码输出会被这份文件的四条规则当成四道关卡拦截每道关各拦一类典型错误。追问关把默默假设变成问出来它做了什么动手写码前模型必须把假设说出口列出多种理解不确定就停下来问。设计动机很简单最贵的错误不是写错而是不问就选了某一种解释继续跑。开始之前我需要确认两个假设 1. 导出全部用户还是筛选后的子集 2. 输出走分页JSON接口还是生成文件下载简洁关只给能解决问题的最小代码它做了什么不加要求外的功能、不为单次使用建抽象、不做投机性可配置200行能写成50行就重写。过度抽象本身没错只是时机太早代价在评审时支付。def calculate_discount(amount: float, percent: float) - float: 计算折扣金额percent取值0-100。 return amount * (percent / 100)手术刀关每行改动都能追溯到请求它做了什么不顺手改进相邻代码和注释匹配现有风格死代码只清理自己改动造成的。顺手改是diff膨胀的头号来源。- if not user_data.get(email): email user_data.get(email, ) if not email or not email.strip(): raise ValueError(Email required)验证关把去做变成做到可验证它做了什么把指令式任务转成可验证目标多步骤任务输出步骤 → 验证计划。强标准让模型能独立循环让它能跑这种弱标准则会逼你不停确认。1. 写重现该Bug的测试 → 验证测试失败 2. 修复空email处理 → 验证测试通过 3. 跑完整测试套件 → 验证无回归完整场景演练选最经典的一个验证器遇到空email就崩修掉它。需求一句话的事但有个坑——模型修空email时很容易顺手把整段校验逻辑升级一遍。操作对话体你验证器遇到空email会崩帮我修一下。 模型我只处理空/纯空格email不动其余校验规则。计划改3行确认范围后再动手 你就这3行。结果diff只动空值判断部分注释没改、没加类型注解、没塞进没人要的username校验。仓库里为这个场景专门配了一组正例反例对照可以直接翻着看。常见误区用代码能跑验收。格式重排、加注解、改注释都能通过这项验收却会让diff变脏。正确验收是打开diff确认每一行改动都能追溯到修空email。如果模型直接写出30行更完善的校验说明准则没被加载。生效信号与边界认知有三个信号能直接观察到它在工作。diff变安静了只出现你请求的改动顺手重排和无关重写基本消失。澄清问题前移了出现在写码之前而不是犯错之后。代码初版就简单因过度复杂而被要求重写的次数明显变少。边界要认清楚这套准则偏向谨慎而非速度改一个拼写错误时模型也可能先思考这时你明说直接改就行。另外没有测试基础的项目里验证关会退化成模型自我汇报结果仍要人工复核。当以上信号稳定出现下一步值得探索的是把你自己的项目规范合并进这份文件。进阶方向并入项目自有规则把TypeScript严格模式API端点必须有测试这类条目追加进指令文件与通用准则共存参考 CLAUDE.md 的结构。在Cursor里启用主工具是Cursor的话改用仓库内置的规则文件配置过程见 CURSOR.md。吃透正反例每条准则都有模型做错的样子 vs 正确做法的代码对照集中在 EXAMPLES.md。【免费下载链接】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),仅供参考