forrestchang

forrestchang / andrej-karpathy-skills

#1
34,9472,866+9,263 today

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

💡 Use Cases

最适合需要AI辅助但又要严格控制代码质量、避免过度设计的编程场景。

修复遗留代码bug

Problem: 让AI修复一个复杂函数中的bug时,它经常擅自重构周边代码,引入新的问题。

Solution: 使用CLAUDE.md的"精准修改"原则,强制AI只修改与bug直接相关的代码行,不改变无关的注释、格式或相邻函数。

Example: 修复一个数据库查询函数中的SQL注入漏洞时,AI不会重写整个函数的错误处理逻辑,只专注于添加参数化查询部分。

实现简单功能需求

Problem: AI经常过度设计,把简单的数据验证功能实现成复杂的验证框架。

Solution: 应用"简单性优先"原则,要求AI只实现明确请求的功能,禁止添加未要求的抽象层或配置选项。

Example: 要求实现邮箱格式验证时,AI会提供一个简单的正则表达式函数,而不是创建包含多种验证器的Validator类。

重构大型代码库

Problem: AI在重构时经常做出错误假设,不确认代码意图就进行修改,导致功能损坏。

Solution: 启用"先思考后编码"原则,强制AI先明确陈述对代码的理解和假设,发现歧义时主动询问澄清。

Example: 重构一个复杂的支付处理模块前,AI会先列出它理解的各个组件职责,并询问不确定的业务逻辑细节。

添加测试覆盖

Problem: AI编写的测试经常遗漏边界情况,或者测试本身过于复杂难以维护。

Solution: 采用"目标驱动执行"策略,要求AI先编写测试用例定义成功标准,然后实现代码让测试通过。

Example: 添加用户注册验证时,AI会先编写测试用例覆盖所有无效输入场景,然后实现刚好能让这些测试通过的最小代码。

📊 Project Info

Stars
34,947
Forks
2,866
Today
+9,263
Ranking
#1
Collection
Overall
Trending Date
April 14, 2026
Last Push
4/13/2026

🏷️ Topics

CLAUDE.md代码规范代码优化代码质量简洁实用开发者程序员