229K星开源项目：一个规则文件让AI编程更守规矩

一个文件，四万开发者追捧

一个 GitHub 仓库获得了超过 229,000 颗星，但它的核心文件不是代码，而是一份写给 AI 编程助手的规则清单。这份清单提炼了四条习惯，目标是减少 AI 编辑项目时带来的意外重写。

据视频介绍，这些习惯源自 Andrej Karpathy 对 AI 写代码方式的抱怨，而文件的实际作者是另一位开发者 Forrest Chang。这种“大咖观点 + 社区实践”的组合，让一个简单的文本文件成了现象级项目。

The habits come from Andre Karpathy's complaints about how AI writes code.

四条习惯：让 AI 编程助手更可控

规则文件的核心是四条行为准则，每一条都针对 AI 编程中的常见痛点。

习惯一：不清楚就停下来问

当用户请求不明确时，AI 应该停止猜测并主动询问。这避免了基于错误假设生成大量无用代码。

Habit 1. When the request is unclear, it stops and asks.

习惯二：用最少的代码完成任务

AI 倾向于过度工程化，而这条规则要求它选择能解决问题的最小实现。

过度工程化（Over-engineering）：在 AI 编程语境下，指模型倾向于引入不必要的抽象、设计模式、配置项或第三方库，导致代码量膨胀、可读性下降。例如，一个简单的排序需求可能被实现为包含策略模式和工厂类的复杂结构。这种倾向源于训练数据中大量“完整项目”的示范，以及模型对“通用性”的偏好。最小实现原则要求 AI 优先选择标准库、内置函数或直接逻辑，仅当明确需要扩展时才增加复杂度，从而降低维护成本和审查负担。

习惯三：不碰未要求的文件

AI 经常“顺手”修改无关文件，导致意外副作用。这条规则限制改动范围。

习惯四：明确定义“完成”并持续测试

AI 需要清楚什么才算任务完成，并不断测试直到通过。这减少了“看起来完成”但实际有问题的交付。

目标：减少意外重写

这些规则的共同目标是减少 AI 编辑项目时的意外重写。当 AI 更守规矩，开发者就能更放心地把任务交给它，而不是花大量时间审查和修复。

The goal? Fewer surprise rewrites when your agent edits your project.

如何用：两条命令或一个规则文件

该项目提供了便捷的使用方式：作为 Claude Code 插件，只需两条命令即可添加；对于 Cursor，也有独立的规则文件。本质上，它是一份可复用的 AI 行为指南。

这种轻量级方案之所以流行，是因为它不依赖复杂工具，而是通过自然语言规则直接约束 AI 行为。对于每天使用 AI 编程的开发者来说，这四条习惯提供了立即可用的改进方向。

Claude Code 插件机制：Claude Code 是 Anthropic 推出的命令行 AI 编程助手，支持通过插件（plugin）扩展行为。插件本质是一组预置的配置文件或脚本，安装后会自动注入到 Claude Code 的上下文中，影响其决策逻辑。用户只需执行类似 claude plugin add <仓库地址> 的两条命令，即可将规则文件挂载为常驻行为准则，无需手动复制提示词。这种方式降低了使用门槛，也让规则可以随项目独立更新。

Cursor 规则文件（.cursorrules）：Cursor 是一款基于 VS Code 的 AI 代码编辑器，其项目级规则文件通常命名为 .cursorrules，放置在仓库根目录。Cursor 在每次对话或代码生成时都会读取该文件内容，作为系统提示的一部分。因此，将四条习惯写入 .cursorrules 就能让 Cursor 在编辑项目时自动遵守，效果类似于为 AI 配备了一份“团队编码规范”。