karpathy-guidelines
karpathy-guidelines 是一套面向 LLM 编码行为的行为准则,源自 Andrej Karpathy 对 LLM 编码常见失误的观察,用于减少 LLM 写代码时容易犯的错误。它适用于编写、审查或重构代码的场景,目标是避免过度复杂化、进行外科手术式的精准修改。准则明确说明其权衡:偏向谨慎而非速度,对于琐碎任务需自行判断。内容包含四个部分:一、编码前先思考,明确陈述假设、不确定就提问、存在多种理解时全部列出、有更简单方案要指出、遇到不清楚的地方停下来询问;二、简单优先,只写解决问题所需的最少代码,不做用户未要求的功能、抽象、灵活性或错误处理,200 行能压到 50 行就重写;三、外科手术式修改,只改动必须改动的地方,不顺手“改进”相邻代码、注释或格式,不重构没坏的东西,匹配现有风格,发现无关死代码只提及不删除,仅清理自己改动造成的孤儿引用,判断标准是每一行改动都能直接追溯到用户请求;四、目标驱动执行,把任务转成可验证目标,例如“加校验”变成“先为非法输入写测试再让其通过”,多步任务给出简短计划并列明每步的验证方式。