如果你正在使用 AI 编程助手（比如 Cursor、GitHub Copilot、Claude Code），却总觉得它“不够聪明”——要么生成的代码离题万里，要么在一些简单逻辑上反复出错，那你可能陷入了一个普遍的误区：把 AI 当成一个需要“鼓励”和“鞭策”的学生，而不是一个需要“精确指令”和“清晰约束”的协作者。

最近，AI 编程圈被一份仅 65 行的文本文件彻底搅动。它的作者是前 OpenAI 联合创始人、被誉为“AI 编程教父”的 Andrej Karpathy。这份名为claude.md（或被称为“Karpathy 准则”）的提示词文件，没有复杂的技巧，却直指当前 AI 辅助编程效率低下的核心痛点：我们给了 AI 太多模糊的“期望”，却给了太少明确的“规则”。

与网络上泛滥的、动辄数千字的“万能提示词”不同，Karpathy 的这份指南极其精简。它不教 AI 如何写出更“优雅”的代码，而是反过来，严格约束 AI 的行为边界和输出格式。其核心理念是一种“反向工程”：不是提升 AI 的“上限”，而是通过规则消除其“下限”的不确定性，从而让协作变得极度可靠和高效。

这篇文章将为你彻底拆解这份“Karpathy 准则”。我们不止步于翻译和罗列它的条款，而是要深入理解其背后的设计哲学，并将其转化为可立即在 Cursor、Claude 或任何代码大模型中实践的“工程化”方法。你会发现，掌握这套方法后，AI 生成的代码将第一次变得高度可预测、可集成，真正成为你思维和键盘的自然延伸。

1. 这篇文章真正要解决的问题：为什么你的 AI 编程助手总在“帮倒忙”？

在深入代码之前，我们必须先诊断问题。许多开发者在初次接触 AI 编程工具时，都会经历一个从惊喜到失望的曲线。一开始，AI 能快速生成样板代码，令人惊叹。但随着任务复杂度的提升，问题接踵而至：

• 上下文丢失：AI 经常“忘记”几分钟前你定义的变量名或函数接口。
• 过度设计：一个简单的功能，AI 可能给你生成一个附带五种设计模式、三个抽象层的“企业级”解决方案。
• 格式混乱：生成的代码缩进不一，注释风格随意，与项目现有风格格格不入。
• 自作主张：未经询问就擅自引入新的第三方库，或改变你预设的架构决策。
• 无效沟通：你需要花费大量时间在聊天窗口里纠正 AI 的理解，而不是在编辑器中写代码。

问题的根源在于，我们和 AI 的协作建立在一种模糊的、基于自然语言的“默契”上。这种沟通方式充满了歧义。当你对 AI 说“写一个函数处理用户输入”时，你心中的“处理”和 AI 理解的“处理”可能天差地别。

Karpathy 准则的颠覆性在于，它彻底放弃了这种“默契”，转而建立一套机器可读、明确无歧义的协作协议。它不关心 AI 的“创造力”有多强，只关心它的“服从性”有多高。这听起来似乎限制了 AI 的能力，但实际效果恰恰相反——当 AI 的行为被严格框定后，它释放出的生产力才是稳定且巨大的。

本文将解决的核心问题是：如何将 Karpathy 准则中抽象的原则，落地为你日常开发中可复制、可迭代的提示词工程实践，从而将 AI 编程助手从一个“时灵时不灵”的玩具，转变为一个“指哪打哪”的可靠生产工具。

2. 基础概念：提示词工程、Skill 与 Karpathy 准则的核心差异

在理解 Karpathy 准则之前，我们需要厘清几个容易混淆的概念。

2.1 什么是提示词工程？

提示词工程是一门通过精心设计输入文本来引导大语言模型产生高质量、高相关性输出的技术和艺术。在编程领域，它意味着你如何“提问”或“下达指令”，才能让 AI 生成你想要的代码。

• 传统思路：追求更详细、更富有鼓励性的描述，试图激发 AI 的“潜能”。例如：“你是一个顶尖的 Python 专家，请用最优雅、最高效的方式实现一个快速排序算法，要考虑到各种边界条件，并附上详细的注释。”
• 问题：描述依然主观（“优雅”、“高效”），且没有定义输出格式和约束条件。

2.2 什么是 Skill / Agent 工作流？

这是提示词工程的一个高级应用。一个 Skill 或 Agent 通常是一个更复杂的提示词模板，它定义了 AI 在特定领域（如代码审查、数据库设计、API 生成）中的角色、知识库和操作步骤。它可能包含多轮对话的逻辑和工具调用的指令。

• 特点：更具针对性，能处理更复杂的任务流。
• 与 Karpathy 准则的关系：Karpathy 准则可以被看作是一个元 Skill——它不是针对某个具体任务，而是定义了 AI 在所有编程协作任务中都必须遵守的基础行为规范。它是构建其他具体 Skill 的基石。

2.3 Karpathy 准则的本质：一套“人机协作协议”

Karpathy 准则不是一份“如何让 AI 变得更聪明”的指南，而是一份“如何让 AI 的表现变得极度可预测”的规范。它的核心思想是“约束优于鼓励”。

我们可以用一个类比来理解：传统的提示词像是在指挥一个才华横溢但性格随意的爵士乐手，“请即兴发挥一段优美的旋律”。结果可能惊艳，也可能一团糟。而 Karpathy 准则像是在指挥一支交响乐团，它提供了精确的乐谱（输出格式）、节拍器（推理步骤）和指挥手势（行为规则），确保每一次演奏都稳定在极高的水准之上。

这份准则主要包含以下几个维度的约束：

1. 输出格式标准化：严格规定代码块、文件路径、修改标识的标记方式。
2. 行为模式化：明确 AI 何时应该提问、何时应该直接执行、如何引用上下文。