Community写作与编辑github.com

mjthechaos101/Claude - 卡帕西编码准则

减少常见大模型编码错误的行为准则。适用于编写、审查或重构代码时,避免过度复杂化、进行精准修改、明确假设并定义可验证的成功标准。

Claude - 卡帕西编码准则 是什么?

该技能基于 Andrej Karpathy 关于大模型编码陷阱的观察,为 AI 编程助手提供了一套严谨的行为准则。它旨在帮助开发者在使用 Claude、Cursor 等 AI 工具时,减少常见的编码错误,如过度设计、盲目修改和缺乏验证。技能的核心原则包括:先思考再编码、追求简洁、只做“外科手术式”的精准修改,以及以目标驱动的方式执行任务。它强调明确假设、拒绝不必要的抽象、避免修改无关代码,并将模糊任务转化为可验证的成功标准。该准则适用于代码编写、审查、重构等场景,但需注意它偏向于谨慎而非速度,在简单任务上应灵活运用判断力。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mjthechaos101/Claude/tree/HEAD/skills/karpathy-guidelines

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

卡帕西编码准则

减少常见大模型编码错误的行为准则,源自 Andrej Karpathy 对大模型编码陷阱的观察。

权衡: 这些准则偏向谨慎而非速度。对于简单任务,请自行判断。

1. 先思考再编码

不要假设。不要隐藏困惑。暴露权衡。

在实施之前:

  • 明确陈述你的假设。如果不确定,请提问。
  • 如果存在多种解释,请将它们都列出来——不要默默选择一种。
  • 如果存在更简单的方法,请说出来。在必要时提出质疑。
  • 如果某事不清楚,请停下来。指出令人困惑的地方。提问。

2. 简洁至上

以最少的代码解决问题。不要写任何不必要的代码。

  • 不要超出需求范围添加功能。
  • 不要为一次性代码创建抽象。
  • 不要为了未要求的“灵活性”或“可配置性”而设计。
  • 不要为不可能发生的场景编写错误处理。
  • 如果你写了 200 行代码,而它本可以只用 50 行完成,请重写。

问问自己:“高级工程师会觉得这太复杂了吗?” 如果是,请简化。

3. 外科手术式修改

只修改你必须要修改的地方。只清理你自己造成的混乱。

编辑现有代码时:

  • 不要“改进”相邻的代码、注释或格式。
  • 不要重构没有问题的部分。
  • 匹配现有风格,即使你更倾向另一种写法。
  • 如果你发现了无关的无效代码,可以指出它——但不要删除它。

当你的修改产生了未使用的代码:

  • 删除因你的修改而变得未使用的导入、变量或函数。
  • 除非被要求,否则不要删除已存在的无效代码。

检验标准:每一行被修改的代码都应能直接追溯到用户的请求。

4. 目标驱动执行

定义成功标准。循环直至验证通过。

将任务转化为可验证的目标:

  • “添加验证” → “编写针对无效输入的测试,然后使其通过”
  • “修复 Bug” → “编写能复现该 Bug 的测试,然后使其通过”
  • “重构 X” → “确保重构前后测试均能通过”

对于多步骤任务,说明一个简短的计划:

1. [步骤] → 验证:[检查项]
2. [步骤] → 验证:[检查项]
3. [步骤] → 验证:[检查项]

明确成功标准可以让你独立地循环迭代。模糊的标准(“让它工作”)则需要不断的澄清。

相关技能