MuseMVP

MuseMVP 是一个 AI-native 项目 —— 其目录结构和模块边界经过专门设计，帮助 Cursor、GitHub Copilot 等 AI 编程工具更准确地理解项目上下文，生成更贴合项目规范的代码建议。

必装扩展

开始编码前，请安装以下扩展。它们会强制执行项目代码风格并为整个技术栈提供准确的 IntelliSense。

ESLint

基于项目 eslint.config.ts 规则提供实时 lint 反馈。

Prettier

保存时自动格式化代码。运行 pnpm check 同时检查格式与 lint 一致性。

Tailwind CSS IntelliSense

为 Tailwind v4 工具类提供自动补全、悬停预览和 lint 提示。

Drizzle ORM

为 Drizzle ORM 提供基于 schema 的自动补全和迁移辅助。

AI 配置文件

MuseMVP 不依赖任何特定编辑器的私有规则文件，而是使用通用的 AI 上下文文件，兼容 Cursor、GitHub Copilot、Claude Code、CodeX 等主流工具。

AGENTS.md

claude.md

AGENTS.md — 项目主上下文文件，描述技术栈、目录结构、开发原则与命名约定，所有支持 agent 模式的 AI 工具均可读取。
claude.md — Claude 专属入口，声明以 AGENTS.md 为唯一真值来源，保持两者一致。
.agents/skills/ — 内置技能集，为常见开发场景（前端设计、Next.js 最佳实践、UI/UX 等）提供结构化提示词，AI 工具可按需引用。
.agents/workflows/ — 预定义工作流，描述部署、代码审查等可重复操作的步骤，支持 // turbo 注解实现一键自动执行。

无缝切换 AI 工具

由于配置基于通用文件而非编辑器私有格式，你可以在 Cursor、VS Code + Copilot、Claude Code、CodeX 之间自由切换，AI 上下文始终保持一致。

工作区设置

仓库已内置 VS Code 工作区设置 .vscode/settings.json，开箱即可使用保存时格式化和 ESLint 自动修复，无需手动配置。

{
  "editor.defaultFormatter": "biomejs.biome",
  "editor.formatOnSave": true,
  "editor.formatOnPaste": true,
  "emmet.showExpandedAbbreviation": "never",
  "tailwindCSS.experimental.classRegex": [
    ["cn\\(([^)]*)\\)", "[\"'`]([^\"'`]*).*?[\"'`]"]
  ],
  "editor.codeActionsOnSave": {
    "source.fixAll.biome": "explicit",
    "source.organizeImports.biome": "explicit"
  },
  "typescript.preferences.importModuleSpecifier": "non-relative",
  "typescript.tsdk": "node_modules/typescript/lib",
  "i18n-ally.localesPaths": ["./src/i18n/translations"],
  "i18n-ally.keystyle": "nested",
  "i18n-ally.namespace": false,
  "i18n-ally.enabledParsers": ["json"],
  "i18n-ally.sourceLanguage": "zh",
  "i18n-ally.displayLanguage": "zh",
  "i18n-ally.enabledFrameworks": ["next-intl"],
  "i18n-ally.extract.autoDetect": true,
  "i18n-ally.annotations": true,
  "i18n-ally.pathMatcher": "{locale}/{namespace}.json",
  "i18n-ally.sortKeys": true,
  "i18n-ally.keepFulfilled": true,
  "i18n-ally.usage.scanningIgnore": [
    "node_modules/**",
    "dist/**",
    ".next/**",
    "**/*.test.ts",
    "**/*.spec.ts"
  ],
  "i18n-ally.extract.keygenStyle": "camelCase",
  "i18n-ally.dirStructure": "dir",
  "i18n-ally.tabStyle": "space",
  "[typescript]": {
    "editor.defaultFormatter": "biomejs.biome"
  },
  "[typescriptreact]": {
    "editor.defaultFormatter": "biomejs.biome"
  },
  "[json]": {
    "editor.defaultFormatter": "biomejs.biome"
  },
  "[css]": {
    "editor.defaultFormatter": "biomejs.biome"
  }
}

首次打开项目时，VS Code 会弹出安装推荐扩展的提示。点击 全部安装 即可一键完成配置。

IDE 配置

推荐编辑器

Cursor

Claude Code

Codex

Antigravity

GitHub Copilot