前言¶
在使用 AI 编码助手时，容易陷入过度设计、添加无关改动，或在没有明确目标的情况下就开始写代码。这些习惯会增加维护成本，也让代码偏离初衷。Karpathy · CLAUDE 编码四原则基于 Andrej Karpathy 对 LLM 编程常见缺陷的观察，提供一套可在编码过程中遵循的规范，帮助减少上述问题。
是什么¶
Karpathy · CLAUDE 编码四原则是一套编码规范，核心是四项原则：先思考再编码、简单优先、精准修改、目标驱动。该规范由社区贡献，版本 1.0.0，分类为 dev-programming。它适用于 CodeBuddy、Claude Code、Cursor 等工具，帮助开发者在使用 AI 编码助手时更加聚焦。
核心功能¶
该规范聚焦于编码流程中的四个关键环节，通过明确步骤与原则，引导更合理的编码行为：
-
先思考再编码
- 在动手写代码前，先明确要解决的问题、输入与输出、边界条件与可能的异常。如果问题本身不清晰，不要开始写代码。 -
简单优先
- 优先采用最简单可解的方案，避免引入不必要的抽象或复杂设计。简单方案更容易理解、测试与维护，也更符合 Karpathy 对 LLM 编程缺陷的观察。 -
精准修改
- 修改代码时，只针对需要改变的部分，避免一次性改动过多。每一次修改都应明确目标，并确认其不会引入新的问题。 -
目标驱动
- 所有编码活动都应围绕一个明确的目标展开。在执行过程中，定期对照目标进行校验，确保偏离目标时及时纠正。
适用场景与注意¶
该规范适用于所有编程任务，尤其适合在以下场景中参考：
- 需要减少过度设计的重构或新功能开发
- 在 AI 编码助手协作中需要明确行为边界
- 对代码质量与可维护性有较高要求的场景
注意：该规范为通用编码原则，需结合具体项目需求与团队约定使用。规范本身不提供工具安装或配置字段，建议在编码流程中将其作为检查清单或辅助参考。
总结¶
Karpathy · CLAUDE 编码四原则通过四个明确原则，帮助开发者在使用 AI 编码助手时减少过度设计、无关改动和假设性错误。在实际编码过程中，将这四项原则作为检查点，可以更清晰地掌控代码走向。
官方地址：https://api.skillhub.cn/user_e3e7ac34/karpathy-claude-four-principles
