Rule Miner:让AI写出“像你团队”的代码
背景
AI 编码助手越来越强,但你有没有发现:
- Copilot、Claude、Cursor 生成的代码,虽然能跑,但总有点“AI味儿”——风格、命名、结构都很标准,却和你们团队的习惯差一截。
- 项目里那些“约定俗成”的写法,AI 根本学不会。比如:service 和 types 文件总是成对出现,某些命名前缀/后缀,某些反模式(比如绝不允许用 any),还有一些隐藏的耦合关系。
- 你想让 AI 生成的代码真正“融入”项目,但靠 prompt 反复强调,效果有限。
解决方案:Rule Miner
Rule Miner 是一个 VS Code/Claude/Copilot/Cursor/Trae 通用的 skill,专门为“让 AI 学会你项目的开发习惯”而生。
它会:
- 全量阅读你的项目源码(跳过 node_modules、dist、build 等)
- 提取 8 类模式:命名、组织、导入、错误处理、注释、测试、隐藏关联、反模式
- 只保留“偏离语言默认”的规则,比如团队独有的命名、结构、耦合、排斥项
- 生成 ≤1000 字的规则,写入 Copilot、Claude、Cursor、Trae 四种 IDE 的配置文件
- 规则语气毒舌刻薄,让 AI 不敢越雷池一步
为什么要“毒舌”风格?
事实证明,AI 对“建议”类 prompt 很容易软处理,但对“强制、刻薄、零容忍”的规则会更认真遵守。
比如:
- “建议不要用 any” → AI 可能还是会用
- “用 any 我会直接回滚你整个 PR” → AI 基本不会再用
安装方法
推荐一键安装:
npx skills add xiwen-haochi/agent-rule-miner
或手动复制 rule-miner/ 文件夹到项目根目录。
使用方法
安装后,在 AI 聊天框输入:
- “分析这个项目的编码风格,生成项目规则”
- “Mine the coding conventions of this project”
- “Generate .cursorrules for this project”
- “学习项目规范,帮 AI 理解这个项目”
AI 会自动触发 Rule Miner skill,流程如下:
- 侦察:识别语言/框架/目录结构/已有 linter 配置
- 全量读取:按优先级读所有源文件
- 模式提取:统计 8 类编码模式
- 规则蒸馏:筛选高价值规则,≤1000 字
- 预览确认:先展示规则草稿,等你确认
- 写入文件:写入 4 种 IDE 配置文件(已有内容不会被覆盖)
示例输出
# Project Rules
> Stack: TypeScript · Express · PostgreSQL. REST API service.
## Naming
- Service files end with `Service.ts`, interfaces with `IService.ts`。别自作聪明乱起名,创意留在业务逻辑里。
- Route handlers 必须是 `handle[Verb][Resource]`。再看到 `processData` 或 `doStuff`,直接回滚 PR。
## Code Organization
- 每个 service 必须有同名 types 文件。没有 types = 这个 service 不存在。
- 直接在 service 里 import `pg`,你就是单点故障源。所有 DB 操作必须走 `db/` 层。
## Anti-Patterns
- 用 `any`,整个 PR 都别想过。`unknown` 不会用就去学。
- 在 `config/env.ts` 之外碰 `process.env`,你就是弱智。
总结
Rule Miner 让 AI 真正“入乡随俗”,写出和你团队一样风格的代码。再也不用担心 AI 生成的代码“格格不入”!