Cursor 终于支持 Skills 了，一条命令从 Rules 迁移过去

# .cursor/rules/project-conventions.mdc
---
alwaysApply: true
---
# 项目规范
 
## 命令
- `bun run build` : 构建项目
- `bun run typecheck` : 类型检查
- `bun run test` : 运行测试
 
## 代码风格
- 使用 ES 模块(import/export)，而非 CommonJS(require)
- 参考 `components/Button.tsx` 了解标准组件结构
 
## 工作流
- 代码修改后始终运行类型检查
- API 路由放在 `app/api/` 目录

# .cursor/skills/deploy-app/SKILL.md
---
name: deploy-app
description: 将应用部署到预发布或生产环境。在部署代码、发布或切换环境时使用。
---
# 部署应用
 
使用以下脚本部署应用。
 
## 使用方式
 
运行部署脚本: `scripts/deploy.sh <environment>`
 
其中 `<environment>` 为 `staging` 或 `production`。
 
## 部署前验证
 
部署前先运行验证脚本: `python scripts/validate.py`

// .cursor/hooks.json
{
  "version": 1,
  "hooks": {
    "stop": [{
      "command": "bun run .cursor/hooks/verify-tests.ts"
    }]
  }
}

## 任务：智能分析并迁移 Cursor Rules 到 Skills
 
请分析项目中的所有 Cursor Rules，根据最佳实践决定哪些应该迁移为 Skills，哪些应该保留为 Rules。
 
### 分析范围
 
扫描以下位置的规则文件：
- 项目级：`{workspaceFolder}/**/.cursor/rules/*.mdc`
- 项目命令：`{workspaceFolder}/**/.cursor/commands/*.md`
- 用户命令：`~/.cursor/commands/*.md`
 
忽略：
- `~/.cursor/worktrees` 目录
- `~/.cursor/skills-cursor` 目录（系统内置）
 
### 分类标准
 
**保留为 Rules**：项目命令清单、代码风格规范、规范文件引用、简短工作流指令（< 30 行）、高频内容、已设置 `alwaysApply: true` 的规则、指定了 `globs` 模式的规则。
 
**迁移为 Skills**：详细的多步骤流程、特定场景指令、可复用工作流、包含脚本的流程、内容较长（> 50 行）的指南、斜杠命令。
 
### 执行步骤
 
1. **扫描阶段**：列出并读取所有规则和命令文件
 
2. **分析阶段**：对每个文件分类并输出表格
 
   | 文件 | 当前类型 | 建议 | 原因 |
   |------|----------|------|------|
   | xxx.mdc | Rule | 保留 | 包含项目命令清单，高频使用 |
   | yyy.mdc | Rule | 迁移 | 详细的部署流程，特定场景使用 |
 
3. **确认阶段**：展示分析结果，等待用户确认
 
4. **执行阶段**（用户确认后）：
   - 迁移的文件：在 `.cursor/skills/{name}/` 创建 `SKILL.md`，保留原始内容，添加正确的 frontmatter（斜杠命令添加 `disable-model-invocation: true`），删除原文件
   - 保留的文件：不做修改，如适合则建议添加 `alwaysApply: true`
 
5. **报告阶段**：输出迁移摘要、新创建的 Skills、保留的 Rules 和撤销说明
 
### SKILL.md 格式
 
```markdown
---
name: skill-name
description: 描述此技能的功能及使用时机
disable-model-invocation: true  # 仅斜杠命令添加此行
---
# 标题
 
原始内容（保持不变）...
```
 
### 注意事项
 
- `name` 字段必须是小写字母和连字符
- `description` 是 Agent 发现技能的关键，务必准确描述
- **严格保留原始内容**，不要修改、重排或"改进"
- 如果用户要求撤销，执行反向操作恢复原文件

.cursor/rules/
├── project-commands.mdc      # 项目命令清单
├── code-style.mdc            # 代码风格规范
├── deployment-guide.mdc      # 详细的部署流程
├── api-conventions.mdc       # API 约定（针对 *.api.ts）
└── pr-workflow.mdc           # PR 创建工作流

.cursor/
├── rules/
│   ├── project-commands.mdc  # 保留 - 高频使用的命令
│   ├── code-style.mdc        # 保留 - 代码风格规范
│   └── api-conventions.mdc   # 保留 - 有 globs 限定
└── skills/
    ├── deployment-guide/
    │   └── SKILL.md          # 迁移 - 详细流程，特定场景
    └── pr-workflow/
        └── SKILL.md          # 迁移 - 可复用工作流

## 任务：扫描代码库，自动提取 Rules 和 Skills
 
请全面分析当前项目的代码库，自动生成合适的 Cursor Rules 和 Agent Skills。
 
### 第一步：项目分析
 
扫描并分析以下内容：
 
**项目配置**：`package.json`、`tsconfig.json`、`.eslintrc`、`Dockerfile`、CI/CD 配置文件等
 
**项目结构**：目录组织、文件命名约定、模块划分模式
 
**代码模式**：导入/导出风格、组件结构、状态管理、API 调用模式、错误处理、测试组织方式
 
**常用命令**：从 package.json scripts、Makefile、README 提取
 
**现有规范文档**：README.md、CONTRIBUTING.md、docs/ 目录、已有的 .cursor/rules/
 
### 第二步：生成 Rules
 
根据分析结果，生成以下 Rules（放在 `.cursor/rules/` 目录）：
 
**project-overview.mdc**（始终应用）
```markdown
---
alwaysApply: true
---
# 项目概述
 
## 技术栈
[从分析中提取]
 
## 项目结构
[从分析中提取目录说明]
 
## 常用命令
[从 package.json scripts 等提取]
```
 
**code-style.mdc**（始终应用）
```markdown
---
alwaysApply: true
---
# 代码风格
 
[从分析中提取的代码风格规范]
[引用项目中的规范示例文件]
```
 
**针对特定文件类型的 Rules**（使用 globs）
```markdown
---
globs: ["*.tsx", "*.jsx"]
---
# React 组件规范
 
[针对该文件类型的具体规范]
```
 
### 第三步：生成 Skills
 
根据分析结果，生成以下 Skills（放在 `.cursor/skills/` 目录）：
 
**根据项目类型生成对应的工作流 Skills**
 
如果是 Web 项目：`create-component/SKILL.md`、`create-api-route/SKILL.md`、`add-feature/SKILL.md`
 
如果有 CI/CD：`deploy/SKILL.md`、`release/SKILL.md`
 
如果有测试：`add-tests/SKILL.md`、`tdd/SKILL.md`
 
**Git 工作流 Skills**：`pr/SKILL.md`、`fix-issue/SKILL.md`
 
### 第四步：输出报告
 
完成后输出：
 
1. **分析摘要**：识别到的技术栈、代码模式、项目规范
 
2. **生成的文件列表**
 
   | 类型 | 文件路径 | 说明 |
   |------|----------|------|
   | Rule | .cursor/rules/xxx.mdc | 描述 |
   | Skill | .cursor/skills/xxx/SKILL.md | 描述 |
 
3. **建议**：可能需要手动补充的内容、推荐添加的额外 Rules 或 Skills
 
### 注意事项
 
- **不要复制整份文档**：Rules 应该引用文件，而不是复制内容
- **保持简洁**：Rules 聚焦要点，详细内容放到 Skills
- **使用规范示例**：在 Rules 中引用项目中的规范文件作为示例
- **遵循命名规范**：文件名使用 kebab-case，Skill name 使用小写字母和连字符
- **提供准确的 description**：这是 Agent 发现 Skill 的关键

.cursor/
├── rules/
│   ├── project-overview.mdc     # 项目概述、技术栈、常用命令
│   ├── code-style.mdc           # 代码风格规范
│   ├── react-components.mdc     # React 组件规范 (globs: *.tsx)
│   └── api-routes.mdc           # API 路由规范 (globs: */api/*)
└── skills/
    ├── create-component/SKILL.md    # 创建组件的标准流程
    ├── create-api-route/SKILL.md    # 创建 API 路由的流程
    ├── pr/SKILL.md                  # 创建 PR 的流程
    └── deploy/SKILL.md              # 部署流程