在 Cursor 中启用 Karpathy 编码指南：.mdc 项目规则的设计、自动生效与跨工具复用-北京尧图网络

AI 技能提示工程【免费下载链接】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点击查看免费下载本指南围绕 andrej-karpathy-skills 仓库中已提交的 Cursor 项目规则.cursor/rules/karpathy-guidelines.mdc完整讲解如何在 Cursor 中让「Karpathy 式 AI 编码行为准则」自动生效、如何在其他项目复用同一套规则、如何将规则以个人 Skill 形式安装以及与 Claude Code 插件方案的差异。读完你将掌握Cursor 项目规则Project Rules的声明与验证方法、.mdc文件的迁移姿势、多工具Cursor / Claude Code / 其他 CLI Agent之间如何共享同一份行为约束。一、背景一份用于约束 LLM 编码行为的行为准则Karpathy 在公开观察中指出了 LLM 编程时的典型问题模型会替你做出错误假设并直接执行、不管理自身的困惑、不寻求澄清、不呈现权衡、在应当反驳时不反驳喜欢把代码和 API 过度复杂化、堆砌抽象、不清理死代码还会在任务无关的情况下擅自改动或删除自己理解不足的代码与注释。本仓库的核心产物是一份统一的四条行为准则详见 CLAUDE.md 与 .cursor/rules/karpathy-guidelines.mdc它不绑定任何特定 IDE而是以不同载体分发给不同工具Claude Code 通过插件.claude-plugin/加载、Cursor 通过项目规则.cursor/rules/加载、其他工具通过根指令文件CLAUDE.md加载。四条准则与它们要解决的问题对应如下原则解决的问题Think Before Coding编码前思考错误假设、隐藏困惑、缺少权衡呈现Simplicity First简洁优先过度复杂化、臃肿抽象Surgical Changes精准修改无关编辑、触碰不该碰的代码Goal-Driven Execution目标驱动执行用测试优先、可验证的成功标准驱动循环二、仓库已提交的 Cursor 项目规则karpathy-guidelines.mdc仓库根目录下存在.cursor/rules/karpathy-guidelines.mdc这一已提交的 Cursor 项目规则文件。Cursor 会自动扫描项目中的.cursor/rules/目录并读取其中带有 frontmatter 的.mdc文件无需额外安装步骤。该文件的 frontmatter 是理解自动生效机制的关键--- description: Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes, surface assumptions, and define verifiable success criteria. alwaysApply: true ---descriptionCursor 用它在规则管理界面中展示这条规则的用途并在 Agent 匹配规则时作为语义摘要使用alwaysApply: true表示该规则对项目中的每次交互无条件生效不需要通过文件路径或关键词匹配来触发——这正是打开文件夹即可用、无需额外安装步骤CURSOR.md的技术前提。frontmatter 之后是完整的四条准则正文与 CLAUDE.md 保持一致1. Think Before CodingDont assume. Dont hide confusion. Surface tradeoffs.实现之前必须显式陈述假设不确定就提问存在多种解释时全部呈现不要默默选一种存在更简单的方案时说出来在必要时提出异议遇到不清楚的地方就停下来点名困惑之处并提问。2. Simplicity FirstMinimum code that solves the problem. Nothing speculative.不加需求之外的功能不为一次性使用的代码创建抽象不加未被要求的灵活性或可配置性不为不可能发生的场景写错误处理如果写了 200 行而 50 行就能完成重写。检验标准问自己资深工程师会不会觉得这过度复杂如果会就简化。3. Surgical ChangesTouch only what you must. Clean up only your own mess.编辑已有代码时不要顺手改进相邻代码、注释或格式不要重构没坏的东西匹配现有风格即使你更倾向另一种写法发现无关的死代码提出来即可——不要删除。当你的改动产生孤儿orphan时删除因你的改动而变得无用的 import/变量/函数不要删除改动之前就存在的死代码除非被要求。检验标准每一处改动都应能直接追溯到用户的请求。4. Goal-Driven ExecutionDefine success criteria. Loop until verified.把指令式任务改写成可验证的目标加校验 → 为非法输入写测试然后让它们通过修 bug → 先写一个能复现它的测试再让它通过重构 X → 确保重构前后测试都通过。多步骤任务给出简短的验证计划模板1. [Step] → verify: [check] 2. [Step] → verify: [check] 3. [Step] → verify: [check]强成功标准能让 Agent 独立循环迭代弱标准让它跑起来则会迫使你不断澄清。文件的末尾还给出了准则生效的判据diff 中不必要的改动更少、因过度复杂导致的重写更少、澄清问题发生在实现之前而非犯错之后。这是你后续判断规则是否起作用的对照清单。三、在本仓库中使用三步即用按照 CURSOR.md 的说明本仓库内的启用流程只有三步在 Cursor 中打开本仓库文件夹规则已随仓库提交commit到.cursor/rules/karpathy-guidelines.mdc且 frontmatter 中声明了alwaysApply: true因此不需要任何额外安装步骤如需确认可打开 Cursor 的Settings → Rules或项目规则 UI此时列表中应出现名为karpathy-guidelines的规则条目。值得注意的是第 2 步与.claude-plugin/目录的机制完全不同Cursor 不会读取CLAUDE.md也不会读取.claude-plugin/目录下的插件清单见 .claude-plugin/marketplace.json 与 .claude-plugin/plugin.json。也就是说同一份准则在 Cursor 中必须以.cursor/rules/下的.mdc文件为载体这是 Cursor 官方约定的读取位置。四、把同一套准则复用到其他项目方式一Cursor 项目推荐将.cursor/rules/karpathy-guidelines.mdc复制到目标项目的.cursor/rules/目录下目录不存在则先创建即可让该规则在目标项目中自动生效。复制后你可以按需调整或与目标项目已有的规则合并。方式二其他仅支持根指令文件的工具如果某个工具/栈只支持单一的根指令文件root instruction file则把仓库根目录的 CLAUDE.md 复制到目标项目或将其内容合并进你现有的指令文件即可。这也是 README 中 Option B: CLAUDE.md (per-project) 的安装路径新建项目用curl -o CLAUDE.md CLAUDE.md 原始地址已有项目用echo CLAUDE.md后追加内容。方式三个人 Agent Skills可选若你希望把同一份内容作为可复用的 Skill 安装到~/.cursor/skills可以使用 skills/karpathy-guidelines/SKILL.md。将其复制或符号链接到你的个人 skills 目录即可布局方式与其他 skill 一致。该文件采用了标准 skill frontmatter--- name: karpathy-guidelines description: Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code... license: MIT ---name是 skill 的调用标识description用于 Agent 判断何时启用该 skill正文则是与.mdc、CLAUDE.md完全一致的四条准则。五、Claude Code 与 Cursor 的差异对照同一套准则在两个主流 Agent 工具中的加载方式截然不同CURSOR.md 对此有明确说明维度Claude CodeCursor加载载体插件市场plugin marketplace skill.cursor/rules/目录下的.mdc项目规则安装方式/plugin marketplace add后/plugin install详见 README.md提交在仓库中的.mdc文件alwaysApply: true自动生效是否读取CLAUDE.md可按项目使用默认不读取是否读取.claude-plugin/是插件机制默认不读取因此在 Cursor 场景下提交在仓库里的.mdc文件是唯一可靠的生效途径Claude Code 场景下则依赖README.md中描述的插件市场安装流程。如果你在两个工具间切换需要分别按各自的载体分发而不是期望某一份文件被两个工具同时识别。六、贡献者须知三份文件必须保持同步由于同一份准则存在三个载体仓库对贡献者提出了同步要求CURSOR.md当你修改四条准则时必须同步更新CLAUDE.md与.cursor/rules/karpathy-guidelines.mdc如果对外发布的 skill/插件文本也应一致则还需同步更新skills/karpathy-guidelines/SKILL.md。从仓库文件对比可以确认三份文件的正文目前完全一致均以 Tradeoff 声明开头——即这套准则偏向谨慎而非速度琐碎任务简单拼写修复、显而易见的一行改动应自行判断不必套用全部流程。这一点是使用任何一份副本前都应先理解的前提。七、效果的验证与项目级定制判断准则是否生效依据准则文件末尾与 README.md 的 How to Know Its Working 一节可以从四个信号观察diff 中不必要的改动变少——只出现被请求的改动因过度复杂导致的重写变少——代码第一次就足够简洁澄清问题发生在实现之前——而不是在犯错之后PR 干净、最小化——没有顺带重构或顺手改进。与项目特定指令合并这套准则被设计为可与其他项目指令合并使用。在规则文件或项目指令中追加项目特定指南小节即可例如## 项目特定指南 - 使用 TypeScript 严格模式 - 所有 API 端点必须有测试 - 遵循 src/utils/errors.ts 中现有的错误处理模式实战对照四条准则的具体行为差异EXAMPLES.md 提供了每条准则的错误示范 vs 正确示范对照例如 Think Before Coding 中导出用户数据前应澄清范围、格式、字段与数据量Simplicity First 中一个折扣计算函数不应引入 Strategy 模式与 30 行配置Surgical Changes 中修一个空邮箱崩溃 bug 不应顺手重排注释、加 docstring 或扩展用户名校验Goal-Driven Execution 中修复认证系统应转化为写测试复现 → 让测试通过 → 验证无回归的闭环。这些例子可以作为你在 Cursor 中检验.mdc规则实际约束效果的参考用例。八、小结把 Andrej Karpathy 的观察沉淀为可执行的行为准则关键在于选择正确的载体在 Cursor 中是.cursor/rules/karpathy-guidelines.mdc配合alwaysApply: true自动生效在 Claude Code 中是插件 skill在其他工具中则是根指令文件CLAUDE.md。仓库通过 CURSOR.md 把这套分发逻辑完整文档化——按本文步骤操作即可让同一份编码前思考、简洁优先、精准修改、目标驱动的行为准则在你的 Cursor 工作流中零安装地落地并随时迁移到任意项目与任意 Agent 工具。赞分享AI 技能提示工程【免费下载链接】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点击查看免费下载相关推荐【亲测免费】 awesome-cursor-rules-mdc自动生成Markdown Cursor规则文件的利器awesome cursor rules mdc自动生成Markdown Cursor规则文件的利器在现代软件开发中代码的可读性和维护性至关重要。Mark开发工具代码生成AI 应用agent-skills 在 Cursor 中的接入实战skills 目录同步与 .mdc 项目规则配置agent skills 在 Cursor 中的接入实战skills 目录同步与 .mdc 项目规则配置本文以 agent skills 仓库的 docs/AI 技能开发工具AI 评测BenchmarkApache Thrift 编码规范完全指南通用原则、语言细则与自动化工具链Apache Thrift 编码规范完全指南通用原则、语言细则与自动化工具链本文基于仓库根目录下的 doc/coding_standards.md http后端微服务API设计创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

在 Cursor 中启用 Karpathy 编码指南：.mdc 项目规则的设计、自动生效与跨工具复用

相关推荐

C#实现Modbus TCP客户端：协议解析、报文封装与实战避坑

TensorFlow工程价值：从模型训练到生产部署的全链路解析

Jev模型详解：从密钥接入到Codex实战的AI编程工具

更多资讯

Xberg Elixir 绑定实战：用 extract_async 与 ExtractInput 实现 PDF 文本提取

老电脑指南：可以装Win7系统CPU盘点

Adobe Dreamweaver 完整安装步骤_保姆级

Ultimate Vocal Remover 快速指南：三步完成 AI 人声伴奏分离

TypeScript 函数完全指南：类型、参数、this 与重载实战

init add_pages

今日更新

开源模型端侧落地实战：量化、推理加速与Agent上下文管理

AI Evals实战指南：从零搭建LLM应用评估体系与CI/CD集成

Java采购管理系统实战：从数据库设计到事务一致性

本周精选

如何彻底离线使用 Laya-CoreML：Hugging Face 下载、缓存机制与 local_files_only 详解

基于1Panel 部署MySQL MCP 服务：TaoToken 统一 Key 接入与 config.toml 配置实战

崇州园区营销网站建设避坑指南：5大注意事项保备案安全

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？