
四大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编程时代你是否经常遇到AI助手写出过度复杂的代码andrej-karpathy-skills项目正是为了解决这个问题而生。这个开源项目基于AI专家Andrej Karpathy的观察通过四大核心原则指导AI助手产出更简洁、更高效的代码让每位开发者都能享受到AI编程的真正价值。 为什么需要AI编程指南传统AI代码助手有一个致命问题它们倾向于过度工程化。当你只需要一个简单功能时它们可能会创建复杂的抽象层、设计模式和配置系统。andrej-karpathy-skills项目通过四大核心原则来约束AI的编程行为确保代码简洁高效。 四大AI编程原则对比表原则核心思想常见错误正确做法编码前思考不要假设不要隐藏困惑默默选择一种解释并继续明确列出假设询问澄清问题简单优先用最少的代码解决问题为单一用途添加抽象层只实现请求的功能精准修改只修改必要内容重构相邻代码改变格式风格只修改与任务直接相关的行目标驱动执行定义成功标准并验证我会改进代码的模糊方法编写测试重现bug → 修复 → 验证 简单优先原则避免过度工程化简单优先是四大原则中最关键的一条。它的核心理念是用最少的代码解决当前问题不要添加推测性功能。让我们通过实际例子看看这个原则如何工作错误示范过度工程化的折扣计算from abc import ABC, abstractmethod from enum import Enum from typing import Protocol, Union from dataclasses import dataclass class DiscountStrategy(ABC): abstractmethod def calculate(self, amount: float) - float: pass class PercentageDiscount(DiscountStrategy): def __init__(self, percentage: float): self.percentage percentage def calculate(self, amount: float) - float: return amount * (self.percentage / 100) # ... 30多行代码只为简单计算正确做法简单直接的实现def calculate_discount(amount: float, percent: float) - float: 计算折扣金额百分比应为0-100 return amount * (percent / 100) # 使用 discount calculate_discount(100.0, 10.0) # 10美元折扣关键洞察好的代码是简单解决今天的问题而不是过早解决明天的问题。只有当真正需要多种折扣类型时才应该引入抽象层。️ 快速集成指南方法一安装Claude Code插件推荐这是最简单的方法让指南在所有项目中生效/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skillskarpathy-skills方法二添加到现有项目对于现有项目只需将CLAUDE.md文件添加到项目根目录echo CLAUDE.md curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md CLAUDE.md方法三创建新项目时集成curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md 四大原则详细解析1. 编码前思考不要假设不要隐藏困惑LLM经常默默选择一种解释并继续执行。这个原则强制显式推理明确陈述假设- 如果不确定询问而不是猜测呈现多种解释- 存在歧义时不要默默选择必要时推回- 如果存在更简单的方法说出来困惑时停止- 明确指出不清楚的地方并请求澄清查看EXAMPLES.md中的详细对比示例学习如何避免顺带修改无关代码。2. 简单优先用最少代码解决问题对抗过度工程的倾向不添加未请求的功能不为单次使用的代码添加抽象不添加未请求的灵活性或可配置性不为不可能的场景添加错误处理如果200行代码可以写成50行重写它测试方法高级工程师会说这过于复杂吗如果是就简化。3. 精准修改只修改必要内容编辑现有代码时不要改进相邻的代码、注释或格式不要重构没有问题的东西匹配现有风格即使你会以不同方式处理如果注意到无关的死代码提及它 - 不要删除它当你的更改创建孤儿时移除你的更改导致未使用的导入/变量/函数除非被要求否则不要移除预先存在的死代码测试方法每一行更改都应该直接追溯到用户的请求。4. 目标驱动执行定义成功标准将命令式任务转换为可验证的目标而不是...转换为...添加验证为无效输入编写测试然后让它们通过修复bug编写重现bug的测试然后让它通过重构X确保测试在重构前后都通过对于多步骤任务陈述一个简要计划1. [步骤] → 验证: [检查] 2. [步骤] → 验证: [检查] 3. [步骤] → 验证: [检查]强大的成功标准让LLM可以独立循环。弱标准让它工作需要不断澄清。 实际应用场景场景一修复bug时的精准修改当需要修复空邮箱导致验证器崩溃的bug时错误做法重写整个验证函数添加额外验证逻辑改变注释风格正确做法只修改处理空邮箱的2-3行代码保持其他部分不变场景二添加新功能时的简单优先当需要添加用户偏好保存功能时错误做法创建包含缓存、验证、合并、通知的复杂管理器类正确做法创建一个简单的保存函数只在真正需要时才添加其他功能场景三性能优化时的目标驱动当需要让搜索更快时错误做法立即添加缓存、数据库索引、异步处理正确做法先问清楚更快指的是什么响应时间、吞吐量还是用户体验 AI编程原则流程图 如何判断指南是否生效当你看到以下迹象时说明andrej-karpathy-skills指南正在发挥作用更少的diff修改- 只有请求的更改出现没有顺便修改更少的重写- 代码第一次就是简单的不需要反复重构更早的澄清问题- 在实现之前就提出问题而不是在错误之后更干净的PR- 没有无关的代码重构或改进 学习更多实际案例项目中的EXAMPLES.md文件包含了丰富的实际案例展示了四大原则在真实场景中的应用隐藏假设的危险示例过度工程化的反模式精准修改的最佳实践目标驱动执行的验证方法 核心SEO关键词总结核心关键词AI编程指南、简洁代码、过度工程化、Karpathy原则、Claude代码优化长尾关键词如何让AI写出简洁代码、避免AI过度工程化、简单优先编程原则、精准代码修改技巧、目标驱动开发方法、AI编程最佳实践、代码简洁性原则 开始你的简洁编码之旅andrej-karpathy-skills不仅是一个工具更是一种编程哲学。它教会我们在AI辅助编程时代最重要的不是让AI写出最复杂的代码而是让AI写出最合适的代码。记住Andrej Karpathy的关键洞察LLMs非常擅长循环直到达到特定目标...不要告诉它做什么给它成功标准然后看着它行动。通过遵循这四大原则你将能够获得更干净、更易维护的代码减少不必要的重构和重写提高AI助手的效率专注于解决真正的问题而不是管理复杂性现在就开始在你的项目中集成CLAUDE.md体验简洁高效AI编程的魅力吧记住Andrej Karpathy的智慧好的代码是简单解决今天的问题而不是过早解决明天的问题。立即行动克隆项目https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills将CLAUDE.md文件添加到你的项目中开始享受简洁高效的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辅助生成(AIGC),仅供参考