用途
Karpathy Guidelines 是一套行为准则,旨在减少 LLM 常见的编码错误。其内容源自 Andrej Karpathy 对 LLM 编码陷阱的观察。它适用于在编写、审查或重构代码时,避免过度复杂化、进行最小化改动并保持目标导向。
主要能力
该准则包含四条核心原则。
1. 先思考再编码
不要假设,不要隐藏困惑,要显性呈现权衡。实现之前应明确陈述假设,不确定时提问;如果存在多种解释,应全部呈现,而不是默默选择一种;如果有更简单的方法,应指出,并在有理由时提出反对意见;如果某处不清楚,应停下,指出困惑所在并提问。
2. 简单优先
用解决问题所需的最小代码,不做任何推测。不要实现未被要求的功能;不要为一次性使用的代码做抽象;不要添加未被要求的“灵活性”或“可配置性”;不要为不可能发生的场景编写错误处理。如果写了 200 行而本可缩为 50 行,就重写。可以自问:“资深工程师会不会说这过度复杂?”如果会,就简化。
3. 外科手术式改动
只触碰必须触碰之处,只清理自己造成的混乱。编辑现有代码时:不要“改进”相邻代码、注释或格式;不要重构没有损坏的东西;匹配现有风格,即便自己会用不同写法;如果发现无关的死代码,只提及,不要删除。当自己的改动产生孤儿代码时:移除因自己改动而变为未使用的导入、变量和函数;不要移除预先存在的死代码,除非被要求。检验标准是:每一行被改动的代码都应能直接追溯到用户的请求。
4. 目标驱动执行
定义成功标准,循环直到验证通过。把任务转化为可验证的目标:例如把“添加验证”转化为“为无效输入写测试,然后让测试通过”;把“修复 bug”转化为“写一个能复现它的测试,然后让它通过”;把“重构 X”转化为“确保重构前后测试都通过”。对于多步任务,给出简短计划:1. [步骤] → 验证:[检查];2. [步骤] → 验证:[检查];3. [步骤] → 验证:[检查]。强的成功标准可以让执行者独立循环,弱的标准(如“让它能跑”)则需要不断澄清。
使用方式
该准则作为行为规范在编写、审查或重构代码时应用。原文未提供具体的安装命令或调用步骤,相关使用方式暂未提供。
适用场景
适用于需要减少 LLM 编码错误、避免过度复杂化、控制改动范围以及需要明确成功标准的代码编写、审查和重构任务。
限制
准则明确说明其在权衡上偏向谨慎而非速度;对于琐碎任务,需自行判断是否适用。其余限制信息暂未提供。