一、痛点AI 工具写出来的代码永远跟你项目格格不入你有没有过这种经历——团队花了几个月时间封装了一套组件库、约定了接口调用方式、确定了页面结构。然后你引入 Claude Code 或 Cursor 开始用 AI 写代码。结果呢AI 把这些规范全部忽略了。AI 不知道你把el-table封装成了AppTable直接用原始组件AI 不知道接口必须走src/api/下的封装自己造了个 axios 调用AI 不知道列表页有固定的结构模板每次都重新发明结构AI 不知道某个工具函数已经存在反复创建重复的逻辑最终的代码能跑但跟项目格格不入。你花在纠正 AI 上的时间比它帮你省下的还多。更糟的是你维护多个项目时每个项目规范不同每次 AI 对话都从零开始。你得不停地告诉 AI “用我们项目的封装”、“按已有页面的写法来”、“别造新轮子”。二、根本原因AI 没有项目上下文为什么会这样因为 AI 工具默认不读你的项目代码。Claude Code 启动时会读CLAUDE.mdCursor 会读.cursorrules但这些文件得你自己写。问题是手写费时—— 把项目里所有封装、规范、命名约定整理成 Markdown是个枯燥的活容易过期—— 项目演进后你忘了同步更新规则文件多工具维护—— 团队里有人用 Claude Code、有人用 Cursor、有人用 Copilot每个工具要单独写一份覆盖不全—— 你写的规则只覆盖显性约定隐性约定比如某种页面的标准结构AI 还是不知道所以痛点的本质是AI 工具缺少一个项目自动分析 规则生成的环节。三、mirrorai让 AI 镜像你的项目而不是创造它自己的风格mirrorai 是一个开源 npm 工具专门解决这个问题。它的核心动作很简单分析你的存量代码 → 提取项目高频模式 → 自动生成多 AI 工具的规范文件一行命令安装npx mirroraiinstall然后在 AI 工具里跑/mirror-init它会扫描你的项目package.json、go.mod、pyproject.toml 等任意清单文件识别技术栈分析目录结构、核心抽象、基础设施扫描所有业务文件按业务单元类型聚类评分筛选出真正高频的模式出现 ≥ 3 次、单文件 ≥ 50 行、相似度 ≥ 80%生成你选择的 AI 工具规范文件可选生成 plopfile.js 和模板用于零 token 本地生成骨架代码支持的 AI 工具AI 工具生成的规范文件Claude CodeCLAUDE.md.claude/commands/*.mdCursor.cursorrulesWindsurf.windsurfrulesGitHub Copilot.github/copilot-instructions.mdCline.clinerules运行时可按需勾选——团队只用 Cursor 就只生成.cursorrules不会污染目录。支持的项目类型不限语言、不限框架、不限业务领域前端Vue 2/3、React、Svelte、Angular、Next.js、Nuxt、Astro后端Express、NestJS、FastAPI、Django、Flask、Spring Boot、Gin、Laravel、Rails 等移动React Native、Flutter、SwiftUI、Jetpack ComposeCLI / 库clap、cobra、commander、click 等数据ETL pipeline、消息消费者、定时任务、报表导出只要你的项目里有可识别的重复模式mirrorai 就能帮你。四、mirrorai 解决的四个核心痛点1. AI 不认识你封装的抽象层团队封装的AppTable、useFetch、BaseRepository这些抽象层AI 一概不知。mirrorai 怎么做生成的规范文件会列出每一个封装组件/工具/服务的名称、位置、用法。明确告诉 AI 什么已经存在、必须用什么。2. AI 总在浪费你的 token让 AI 写一个标准的 CRUD 列表页它会从头生成表格结构、分页、加载状态、搜索栏、错误处理。这些80% 在你项目里都是固定模板纯粹是 token 浪费。mirrorai 怎么做从项目实际代码中提取骨架模板本地零 token 生成模板部分AI 只补充业务字段。token 消耗降低 60-80%。3. AI 不知道什么场景该用哪个模式即便有了CLAUDE.mdAI 还是需要用户明确说用列表页模板或按订单管理那个写法。手动指挥太麻烦。mirrorai 怎么做生成的CLAUDE.md里有个Auto-Execute Rules段AI 会根据用户描述自动识别场景你帮我做个请假申请功能 AI自动识别为审批流模式 → 按项目规范生成端点 测试 路由无需手动触发任何命令。4. 团队同时用多个 AI 工具规则文件维护成本爆炸有人用 Claude Code有人用 Cursor有人用 Copilot——五个工具五份规则同步是噩梦。mirrorai 怎么做一次分析按需生成所有选中工具的规范文件内容核心一致仅格式适配。再次运行可重新生成、增量更新或合并。五、快速上手3 分钟用上第一步安装# 在项目根目录执行npx mirroraiinstall这会把一个mirror-init.md文件复制到.claude/commands/目录。整个工具就这么大——后续所有规则都由 AI 分析项目动态生成。第二步在 AI 工具里初始化/mirror-initAI 会问你两个问题Which AI coding tools do you use? (multi-select, comma-separated) 1. Claude Code → CLAUDE.md .claude/commands/ 2. Cursor → .cursorrules 3. Windsurf → .windsurfrules 4. GitHub Copilot → .github/copilot-instructions.md 5. Cline → .clinerules Also generate a plopfile and skeleton templates for zero-token local scaffolding? (y/n)选完之后等几分钟AI 会自动完成分析、生成规则、模板提取、语法验证、语义验证、最终报告全套流程。第三步日常开发由于规则文件里有Auto-Execute Rules绝大多数场景下你不需要手动触发命令直接描述需求即可你帮我做一个订单管理页面 AI识别为列表页模式 表单弹窗模式 → 按规范创建列表页 表单组件 API 文件 路由配置可选零 token 生成骨架如果开启了 plop 模板npx plop--help# 查看可用模式npx mirrorai new模式名模块名# 本地生成骨架AI 再填业务六、工作原理为什么不会跑偏很多人会问mirrorai 怎么保证生成的规则不瞎写核心机制是“绝不预设、全部基于真实代码”你的项目代码 ↓ 扫描清单文件 → 识别语言、框架、技术栈 ↓ 扫描业务代码 → 按业务单元类型聚类 ↓ 评分筛选出现 ≥ 3 次 单文件 ≥ 50 行 相似度 ≥ 80% ↓ 生成 4 类产物 ├─ 规范文件CLAUDE.md / .cursorrules / .windsurfrules / ... ├─ Slash Commands只为高频模式生成3–6 个命名贴合业务 ├─ plopfile与命令一一对应的骨架生成器 └─ 模板从项目实际代码提取的 .hbs 文件任意语言特别值得说的几点没有固定命令集不像别的脚手架工具固定生成new-list/new-formmirrorai完全根据项目实际情况决定生成哪些命令。OA 系统会生成new-approval审批流数据大屏会生成new-chart、new-dashboardETL 工具会生成new-pipeline、new-task后台管理可能是new-list、new-form命名贴合你的业务而不是套用通用名。重新运行不会覆盖你的内容每个 mirrorai 生成的文件都会带一个 marker!-- mirrorai:generated --。再次运行时如果发现某个规则文件没有这个 marker会单独询问你合并、覆盖、还是跳过。绝不静默破坏你的自定义内容。生成结果有完整的验证流程生成 plopfile 和模板后会自动执行语法检查——node --check加载检查——npx plop --helpTrial-run—— 用临时模块名跑每个 generator产物语法检查—— 按项目语言验证语义对比—— 与提取来源样本对比 import、核心抽象引用、结构段落清理临时文件失败分级处理—— 单个 generator 失败会被移除不影响整体流程七、与其他方案的对比方案是否分析项目多工具支持维护成本token 消耗手写 CLAUDE.md❌单工具高中GitHub 模板仓库❌单工具中高Cursor Rules 市场模板❌仅 Cursor低高mirrorai✅ 完整分析✅ 5 个工具✅ 极低✅ 极低mirrorai 的独特价值在于它不是模板库而是项目分析器。模板库给你通用 React 项目的规则mirrorai 给你你这个项目的规则。八、技术栈与开源信息GitHubgithub.com/joygqz/mirrorainpmnpx mirrorai installLicenseMIT环境要求Node.js 18依赖仅picocolors彩色输出用什么 AI 工具订阅mirrorai 本身不调用 Anthropic API整个分析过程跑在你的 AI 工具内用你已有的订阅Claude Code 订阅Cursor ProWindsurfGitHub CopilotCline任意一个都行。整个流程无需 API Key。九、总结问题AI 工具写代码总跑偏因为它不知道你项目的真实规范。根因项目规范信息没有传递给 AI手写又费时、易过期、难跨工具。方案mirrorai 自动分析项目代码 → 生成 CLAUDE.md、.cursorrules、.windsurfrules、Copilot instructions、Cline rules 一站式规则文件。收益✅ AI 严格遵守项目规范停止跑偏✅ token 消耗降低 60-80%✅ 多 AI 工具统一管理✅ 无需额外 API Key走现有订阅✅ 重新运行不破坏你的自定义内容 立即试用# 在你的项目根目录执行npx mirroraiinstall然后在 Claude Code / Cursor / Windsurf 等任意 AI 工具里输入/mirror-init剩下的交给 AI。GitHub 仓库https://github.com/joygqz/mirrorai欢迎 Star、Issue、PR。 文章配套标签Claude Code、CLAUDE.md、Cursor、cursorrules、Windsurf、GitHub Copilot、Cline、AI 编程助手、AI 代码规范、前端工程化、开源工具
