Karpathy Guidelines 是一套行为指南,用于减少常见的大语言模型(LLM)编码错误,内容源自 Andrej Karpathy 对 LLM 编码陷阱的观察。
用途
这套指南用于在编写、审查或重构代码时约束 LLM 的编码行为,帮助避免过度复杂化、减少不必要的改动,并让执行过程更可验证。它明确给出的权衡是:这些指南偏向谨慎而非速度;对于琐碎任务,可使用判断力自行决定。
主要能力(四条原则)
- 编码前先思考(Think Before Coding)
不要假设,不要隐藏困惑,要暴露权衡。在实现之前:明确陈述假设,如果不确定就提问;如果存在多种解释,把它们都呈现出来,不要默默选择其一;如果有更简单的方案,就说出来,在合理时提出反对意见;如果有不清楚的地方,停下来,指出困惑点并提问。
- 简洁优先(Simplicity First)
用解决问题所需的最少代码,不做任何投机性设计。不添加超出需求的功能;不为一次性代码创建抽象;不添加未被要求的“灵活性”或“可配置性”;不为不可能发生的情况编写错误处理。如果写了 200 行而其实 50 行就够,就重写。可以自问:资深工程师会不会说这过于复杂?如果会,就简化。
- 外科手术式改动(Surgical Changes)
只改必须改的地方,只清理自己造成的混乱。编辑现有代码时:不要“改进”相邻的代码、注释或格式;不要重构没有坏掉的东西;匹配现有风格,即使自己会写得不同;如果注意到无关的死代码,只提及,不要删除。当自己的改动产生孤立项时:移除因自己改动而变得未使用的导入、变量或函数;除非被要求,否则不要移除先前就存在的死代码。检验标准是:每一行被改动的代码都应能直接追溯到用户的请求。
- 目标驱动执行(Goal-Driven Execution)
定义成功标准,循环直到验证通过。把任务转化为可验证的目标:“添加校验” → “为无效输入编写测试,然后让它们通过”;“修复 bug” → “编写能复现它的测试,然后让它通过”;“重构 X” → “确保重构前后测试都通过”。对于多步任务,陈述简要计划,例如:1. [步骤] → 验证:[检查];2. [步骤] → 验证:[检查];3. [步骤] → 验证:[检查]。
使用方式
将上述四条原则作为行为约束应用于编码、审查或重构过程中:在动手前先陈述假设并暴露权衡;实现时保持最小代码量;改动时严格限定范围并匹配现有风格;执行时把任务拆成带验证步骤的目标。对于琐碎任务,可以依据自身判断决定是否严格套用。
适用场景
适用于 LLM 参与编写、审查或重构代码的场合,尤其是需要避免过度设计、控制改动范围、以及让结果可验证的任务。
限制
资料明确指出其权衡是偏向谨慎而非速度,因此对需要快速产出、或本身非常琐碎的任务可能不完全适用;对于琐碎任务需使用判断力。此外,资料未提供具体的安装方式、集成步骤、收费或价格信息、支持平台及具体效果数据,这些内容暂未提供。