AI 编程指南：4 条准则让 AI 助手少犯常见错误

AI 编程指南4 条准则让 AI 助手少犯常见错误【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills如果你让 AI 助手修两行的 bug它却交回三百行抽象类或把没人要的改动画进改动文件里问题通常不在模型而在缺少一份行为准则。这份开源 AI 编程指南把四个高频坑整理成可勾选的规则读完十分钟即可落地。AI 助手最容易翻车的四种场景先对照检查看你是否命中过以下情况只让它导出接口加个字段它却交回一套含策略模式、配置类和缓存的完整方案。修 bug 本身修对了但顺手重排了引号、加了类型标注、改写了相邻注释。它对格式和范围默默做了假设直到你 review 时发现它一直在猜。你只说修一下它修完你也不确定是真修好了还是只是不崩了。这些不是偶发事故而是会重复出现的固定模式。堵法也是固定的。四条可勾选的 AI 编程准则下面四条全部来自这份 AI 编程指南可逐条当作清单使用。写代码前先确认范围现象需求有歧义时AI 默默挑一种解释直接开工。原因大语言模型LLM没有主动停下确认的动力猜一个解释比发问更快。做法实现前列出假设清单存在多种解释就全部摆出来再问不确定就停直接提问。验证信号它的第一条回复是假设与问题清单而不是一堆代码。只写最短实现现象一个简单的计算被包上抽象基类、配置类和策略模式。原因模型见过太多最佳实践样例倾向为未来的需求提前设计。做法只解决当前请求不加未要求的功能不做单次使用的抽象200 行能写成 50 行就重写。验证信号一位资深工程师不会评价这写复杂了。改动只限于问题本身现象修一个 bug却动了无关注释、引号风格、格式还加了没人要的校验。原因模型倾向于顺手改进它没有完全理解的部分。做法只改与请求直接相关的行沿用现有风格哪怕你不喜欢只清理自己改动产生的无用引用发现无关死代码只指出、不删除。验证信号每一行变更都能追溯到这次请求。把任务变成可验证目标现象你说加个校验它回复已完成你却无从判断是否真的完成。原因模糊任务没有停止条件模型只能猜差不多就行。做法把任务改写成可运行验证的目标如加校验→先写无效输入的测试再让它通过多步任务每步都写清验证方式例如第 1 步单端点内存限流→验证100 个请求前 10 个成功其余 429。验证信号任务做完后跑一次测试或命令就能判断成败不靠人肉判断。空值崩溃的最小修复一个完整示例以验证器在空电子邮件时崩溃为例。错误示范常见错法是顺手重写整个函数——加文档字符串、强化邮箱规则、再补上用户名的长度和字符校验全都与崩溃本身无关。修正后的处理只改读取邮箱的那几行用户名校验和原有风格保持不动def validate_user(user_data): # 检查电子邮件格式 email user_data.get(email, ) if not email or not email.strip(): raise ValueError(Email required) # 基本电子邮件验证 if not in email: raise ValueError(Invalid email) # 检查用户名保持不变 if not user_data.get(username): raise ValueError(Username required) return True为什么这样更稳改动面只在空值分支上评审者一眼能看完用户名逻辑没被碰不引入新故障面发现的其他问题写进回复由人来定夺下一次任务不会被上一次污染。两条安装路线新项目和已有项目这份 AI 编程指南提供两条安装路线按你的情况选命令在目标项目目录执行。用 Claude Code在命令行运行的 AI 编程工具且希望规则在所有项目生效装插件。/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skillskarpathy-skills不想装插件或只在单个项目用先克隆仓库。git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills新项目把规则文件复制到项目根目录。cp andrej-karpathy-skills/CLAUDE.md CLAUDE.md已有项目已有 CLAUDE.md追加到文件末尾保留原内容。cat andrej-karpathy-skills/CLAUDE.md CLAUDE.mdCLAUDE.md 是 Claude Code 启动会话时自动加载的 markdown 文件写进其中的规则会约束该项目里 AI 的行为。通用规则之后可以追加自己的项目小节例如 TypeScript 严格模式、测试约定。新手和进阶两级上手新手本周就做三件事把 CLAUDE.md 放进手头项目挑一个小任务观察 AI 是否先问再做。通读 EXAMPLES.md对照每组错误对照修正的示例建立什么算过多的手感。每次任务先写出一句完成标准再交给 AI。进阶把规则变成团队习惯在 CLAUDE.md 里追加项目特定规则命名、错误处理模式、测试约定并像维护代码一样维护它。把每行变更可追溯到请求写进代码审查检查清单。若你用 Cursor仓库自带对应的规则文件与技能定义文件配置方法见 CURSOR.md。判断方法是否生效的四个信号使用约两周后逐条核对命中三条以上即算生效✅ 变更文件里只有被要求的改动没有顺手重构。✅ 第一版实现就是简单的没有因过度复杂而返工。✅ 澄清性问题出现在实现之前而不是出错之后。✅ PR 小而聚焦评审能快速通过。适用边界修拼写错误、明显的一行改动这类简单任务不必走完整流程凭判断即可这套规则的目的是减少非平凡工作上的高代价错误而不是拖慢简单任务。完整内容见仓库中的 CLAUDE.md规则正文、EXAMPLES.md案例对照、CURSOR.mdCursor 配置说明技能定义文件位于 skills/karpathy-guidelines/SKILL.md。【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考