结论
“用一个 CLAUDE.md 文件改变 AI 编码助手的行为”——这个看起来简单的想法,正在 GitHub 上引发一场开发者工具范式转变。2026 年 4 月底,GitHub trending 几乎被”技能文件”项目占据,这不是偶然的流量聚集,而是一种新工作方式的集体确认。
数据说话
本周 GitHub trending 上,技能文件相关项目占据半壁江山:
| 项目 | Star 数 | 本周增长 | 核心定位 |
|---|---|---|---|
| andrej-karpathy-skills | 105,200 | +21,896 | LLM 编码避坑指南 |
| mattpocock/skills | 53,226 | +33,628 | 实战工程师技能包 |
| free-claude-code | 19,805 | +12,928 | 免费终端版 Claude Code |
| awesome-codex-skills | 已有覆盖 | - | Codex 技能集合 |
增长速度分析
mattpocock/skills 本周增长 33,628 颗星——这意味着平均每分钟有 33 个人在 star 这个项目。andrej-karpathy-skills 的累计 star 数已超过 105K,成为 2026 年增长最快的开发者工具项目之一。
什么是”技能文件”模式?
核心逻辑极其简单:用一个 Markdown 文件定义 AI 编码助手的行为规则,放在项目的 .claude/ 或根目录下。
project/
├── .claude/
│ └── CLAUDE.md ← 告诉 AI 怎么写这个项目的代码
├── src/
└── package.json
这个文件不包含代码,而是包含规则、约定和偏好——比如:
- “不要过度抽象,简单脚本不需要工厂模式”
- “优先使用 TypeScript,不要写任何 .js 文件”
- “测试文件放在 tests 目录下,使用 vitest”
- “遇到不确定的 API,先查阅官方文档再写代码”
为什么这种模式会爆火?
1. 零依赖
不需要安装任何包、配置任何环境、注册任何服务。一个 Markdown 文件,复制粘贴到你的项目里就能生效。
2. 即时效果
把 CLAUDE.md 放进项目后,下一次 AI 编码助手的输出质量会有立竿见影的提升。这是因为 AI 终于”了解”了你的项目风格。
3. 可组合性
你可以同时使用 Karpathy 的通用编码规则 + Matt Pocock 的 TypeScript 最佳实践 + 你自己项目的特定约定。多个技能文件可以叠加使用。
4. 平台无关
虽然叫 CLAUDE.md,但这种模式不仅适用于 Claude Code。OpenClaw、Cursor、GitHub Copilot 等工具都开始支持类似的项目级配置文件。
从单个文件到生态
技能文件的爆火催生了一个新生态:
| 层级 | 代表 | 说明 |
|---|---|---|
| 通用技能 | Karpathy Skills | 适用于任何项目的编码规则 |
| 语言/框架技能 | Matt Pocock Skills | 针对特定技术栈的最佳实践 |
| 项目技能 | 自定义 CLAUDE.md | 每个项目独有的约定 |
| 技能市场 | ClawHub 等 | 技能文件的分享和分发平台 |
横向对比:技能文件 vs 传统工具
| 维度 | 传统 Lint/Format | ESLint/Prettier 配置 | CLAUDE.md 技能文件 |
|---|---|---|---|
| 作用对象 | 人类写的代码 | 人类写的代码 | AI 写的代码 |
| 检查时机 | 保存/提交时 | 保存/提交时 | 生成代码前 |
| 修复方式 | 自动修复 | 自动修复 | 预防性指导 |
| 覆盖范围 | 语法/格式 | 语法/格式/风格 | 架构决策/最佳实践 |
关键区别:传统工具在代码写完后检查和修复,技能文件在代码生成前就预防问题。
行动建议
- 所有使用 AI 编码工具的开发者:在你的项目根目录放一个 CLAUDE.md 文件,定义 5-10 条你的项目规则。投入 10 分钟,长期回报巨大。
- 团队负责人:将团队的编码规范写成 CLAUDE.md,新成员(和 AI)加入时自动遵循。
- 技能作者:如果你有某个领域的专业知识,把它封装成技能文件分享到 GitHub。社区对高质量技能的需求远未被满足。