@waoooo/claude-skills 1.0.0

package/skills/mdx-to-openspec/SKILL.md

@@ -0,0 +1,827 @@
+# Skill: mdx-to-openspec
+
+## 功能
+
+从 MDX 需求文档生成 OpenSpec 提案（proposal.md, tasks.md, design.md）。
+
+**重要**：OpenSpec 没有 `create` 命令，需要手动创建目录和文件。
+
+## 何时调用
+
+- 用户提供了 MDX 文档
+- 需要生成结构化的 OpenSpec
+- 在创建 Job 之后，解析需求之前
+
+## 输入
+
+- `mdxPath` - MDX 文档路径
+- `changeName` - OpenSpec change 名称（kebab-case, verb-led，例如：refactor-pricing-frontend）
+- `openspecRoot` - OpenSpec 根目录（默认：`../../../../waoooo/openspec`）
+
+## 输出
+
+- `openspec/changes/<change-name>/` - OpenSpec 目录
+  - `proposal.md` - 提案文档（必须）
+  - `tasks.md` - 任务列表（必须）
+  - `design.md` - 设计文档（可选）
+  - `specs/` - 规范变更目录（可选）
+
+## 执行步骤
+
+### 0. 检查现有 OpenSpec（必须先执行）
+
+**在创建之前，必须先检查是否有类似的 OpenSpec！**
+
+**步骤**：
+
+1. **读取配置获取路径**
+   ```typescript
+   // 从 project.config.json 读取
+   const config = getProjectConfig();
+   const openspecRoot = config.openspec.root;           // OpenSpec 数据目录
+   const workspaceRoot = config.openspec.workspaceRoot; // OpenSpec CLI 工作目录
+   ```
+
+2. **尝试使用 openspec CLI**
+   ```bash
+   bash(
+     command="openspec list",
+     workdir=workspaceRoot  // 从配置读取
+   )
+   ```
+
+3. **如果失败（未初始化），直接读取目录**
+   ```bash
+   bash(
+     command="ls -la changes/",
+     workdir=openspecRoot  // 从配置读取
+   )
+   ```
+
+**重要说明**：
+- **所有路径都从 `project.config.json` 读取**，不要硬编码
+- `openspec` CLI 需要在 `workspaceRoot` 运行（有 `.openspec/` 配置）
+- OpenSpec 数据在 `openspecRoot`（`changes/` 和 `specs/` 目录）
+- 如果 `openspec list` 失败，fallback 到直接读取目录
+
+**检查内容**：
+- 是否有相同或类似的 change-name？
+- 是否有相同的功能或目标？
+- 是否有冲突的变更？
+
+**如果发现类似的 OpenSpec**：
+
+1. **读取现有 OpenSpec 详情**
+   ```bash
+   # 读取所有相关 OpenSpec 的 proposal.md
+   Read(filePath="<openspecRoot>/changes/<change-name>/proposal.md")
+   ```
+
+2. **智能相似度检测**
+   
+   **检测维度**：
+   - **关键词匹配**：比较 MDX keywords 和 OpenSpec keywords 的重合度
+   - **目标相似度**：比较 MDX 的目标和 OpenSpec 的 Why/What Changes
+   - **任务重叠度**：比较 MDX 的任务列表和 OpenSpec 的 tasks.md
+   
+   **相似度判断**：
+   ```
+   关键词重合度 > 70% 
+   AND 
+   (目标描述相似 OR 任务列表重叠 > 50%)
+   → 判定为相同任务
+   ```
+
+3. **自动决策（基于相似度）**
+   
+   **场景 1：高度相似（相似度 > 80%）**
+   ```
+   ✅ 发现高度相似的 OpenSpec: pricing-frontend-refactor
+   
+   📊 相似度分析:
+   - 关键词重合: 85% (pricing, frontend, refactor, membership)
+   - 目标相似度: 90% (都是重构前端架构)
+   - 任务重叠: 75% (重命名包、三层架构)
+   
+   📋 自动决策: 使用现有 OpenSpec
+   
+   原因: 内容高度相似，很可能是同一个任务
+   
+   📂 路径: openspec/changes/pricing-frontend-refactor/
+   
+   ⏭️  跳过创建步骤，直接解析 OpenSpec
+   ```
+   
+   **场景 2：中度相似（50% < 相似度 < 80%）**
+   ```
+   ⚠️  发现中度相似的 OpenSpec: pricing-frontend-refactor
+   
+   📊 相似度分析:
+   - 关键词重合: 60% (pricing, frontend)
+   - 目标相似度: 50% (都涉及前端，但目标不完全相同)
+   - 任务重叠: 40%
+   
+   📋 自动决策: 创建新的 OpenSpec
+   
+   原因: 相似度不够高，可能是不同的任务
+   
+   💡 建议: 使用更具体的 change-name 以区分
+   - 当前: pricing-phase-1.5-refactor
+   - 现有: pricing-frontend-refactor
+   
+   ✅ 继续创建新的 OpenSpec
+   ```
+   
+   **场景 3：低度相似（相似度 < 50%）**
+   ```
+   ℹ️  发现相关的 OpenSpec: pricing-backend-api
+   
+   📊 相似度分析:
+   - 关键词重合: 30% (pricing)
+   - 目标相似度: 20%
+   - 任务重叠: 10%
+   
+   📋 自动决策: 创建新的 OpenSpec
+   
+   原因: 相似度低，明显是不同的任务
+   
+   ✅ 继续创建新的 OpenSpec
+   ```
+
+4. **相似度计算方法**
+   
+   ```typescript
+   // 伪代码
+   function calculateSimilarity(mdx, openspec) {
+     // 1. 关键词重合度
+     const keywordOverlap = 
+       intersection(mdx.keywords, openspec.keywords).length / 
+       union(mdx.keywords, openspec.keywords).length;
+     
+     // 2. 目标相似度（文本相似度）
+     const goalSimilarity = 
+       cosineSimilarity(mdx.goal, openspec.why + openspec.whatChanges);
+     
+     // 3. 任务重叠度
+     const taskOverlap = 
+       intersection(mdx.tasks, openspec.tasks).length / 
+       union(mdx.tasks, openspec.tasks).length;
+     
+     // 加权平均
+     return keywordOverlap * 0.4 + goalSimilarity * 0.3 + taskOverlap * 0.3;
+   }
+   ```
+
+**重要**：
+- **基于内容相似度判断**，而不是只看名字
+- **自动决策**，避免阻塞流程
+- **透明化决策过程**，显示相似度分析结果
+- **阈值可调**，根据实际情况优化
+   - 是否使用不同的 change-name？
+
+**如果没有类似的 OpenSpec**：
+- 继续执行步骤 1
+
+### 1. 读取 MDX 文档
+
+```bash
+# 使用 Read 工具读取 MDX 内容
+Read(filePath=<mdx-path>)
+```
+
+**提取信息**：
+- **keywords**（必须）：
+  - 优先从 frontmatter 的 `keywords` 字段提取
+  - 如果没有，从标题和内容中自动提取关键词
+  - 提取规则：功能名称、模块名称、技术栈、操作类型（如 refactor, add, update）
+- 文档标题
+- Phase 描述
+- 任务列表
+- 背景和目标
+
+### 2. 创建 OpenSpec 目录
+
+```bash
+# 使用 Bash 工具创建目录
+cd <openspec-root>
+mkdir -p changes/<change-name>/specs
+```
+
+**目录结构**（参考 `openspec/AGENTS.md` 第 159 行）：
+```
+changes/<change-name>/
+├── proposal.md    # 必须
+├── tasks.md       # 必须
+├── design.md      # 可选
+└── specs/         # 可选
+```
+
+### 3. 创建 proposal.md
+
+```bash
+# 使用 Write 工具创建 proposal.md
+Write(
+  filePath="<openspec-root>/changes/<change-name>/proposal.md",
+  content="<从 MDX 提取的内容>"
+)
+```
+
+**格式**（参考 `openspec/AGENTS.md` 第 161-175 行）：
+```markdown
+---
+keywords: [从 MDX frontmatter 提取的 keywords]
+---
+
+# Change: [简短描述]
+
+## Why
+[1-2 句话说明问题/机会]
+
+## What Changes
+- [变更列表]
+- [标记破坏性变更为 **BREAKING**]
+
+## Impact
+- Affected specs: [影响的能力]
+- Affected code: [关键文件/系统]
+```
+
+**从 MDX 提取**：
+- **keywords**: 
+  - 优先从 MDX frontmatter 的 `keywords` 字段提取
+  - 如果 MDX 没有 keywords，从标题、描述、内容中自动提取
+  - 提取规则：功能名称、模块名称、技术栈、操作类型
+  - 示例：[pricing, 定价, membership, 会员, refactor, 重构, frontend, 前端]
+- **Why**: 从 MDX 的背景部分提取
+- **What Changes**: 从 Phase 描述提取
+- **Impact**: 从任务列表推断
+
+**重要**：
+- frontmatter 中的 keywords 是必须的，用于后续的能力匹配
+- 如果 MDX 没有 keywords，必须自动提取，不能留空
+- keywords 应该包含：功能名称、相关模块、技术栈等
+
+### 4. 创建 tasks.md
+
+```bash
+# 使用 Write 工具创建 tasks.md
+Write(
+  filePath="<openspec-root>/changes/<change-name>/tasks.md",
+  content="<从 MDX 提取的任务列表>"
+)
+```
+
+**格式**（参考 `openspec/AGENTS.md` 第 198-205 行）：
+```markdown
+## 1. Implementation
+- [ ] 1.1 任务 1
+- [ ] 1.2 任务 2
+- [ ] 1.3 任务 3
+
+## 2. Testing
+- [ ] 2.1 测试 1
+- [ ] 2.2 测试 2
+```
+
+**从 MDX 提取**：
+- 从 Phase 的任务列表提取
+- 按顺序编号
+- 添加 checkbox `- [ ]`
+
+### 5. 创建 design.md（可选）
+
+**仅在以下情况创建**（参考 `openspec/AGENTS.md` 第 207-212 行）：
+- 跨服务/模块的变更
+- 新的架构模式
+- 复杂的技术决策
+- 安全、性能或迁移复杂性
+
+**对于 Phase 1.5 前端架构重构**：
+- ✅ 需要 design.md（因为是架构重构）
+
+```bash
+# 使用 Write 工具创建 design.md
+Write(
+  filePath="<openspec-root>/changes/<change-name>/design.md",
+  content="<设计文档内容>"
+)
+```
+
+**格式**（参考 `openspec/AGENTS.md` 第 214-235 行）：
+```markdown
+## Context
+[背景、约束、相关方]
+
+## Goals / Non-Goals
+- Goals: [...]
+- Non-Goals: [...]
+
+## Decisions
+- Decision: [决策和原因]
+- Alternatives considered: [备选方案 + 理由]
+
+## Risks / Trade-offs
+- [风险] → 缓解措施
+
+## Migration Plan
+[步骤、回滚]
+
+## Open Questions
+- [...]
+```
+
+### 6. 验证输出
+
+```bash
+# 使用 Bash 工具验证
+cd <openspec-root>
+openspec validate <change-name> --strict
+```
+
+**检查**：
+- proposal.md 是否存在且格式正确
+- tasks.md 是否存在且格式正确
+- 如果有 design.md，格式是否正确
+- 如果有 specs/，是否包含正确的 delta 文件
+
+## 使用示例
+
+### 示例 1：从 MDX 生成 OpenSpec
+
+```
+Agent 调用 mdx-to-openspec:
+  输入:
+  - mdxPath: /path/to/pricing-system.mdx
+  - changeName: refactor-pricing-frontend
+  - openspecRoot: ../../../../waoooo/openspec
+
+执行:
+  🔧 步骤 1: 读取 MDX
+  ⏳ 读取: pricing-system.mdx
+  ✅ 提取了 keywords: [pricing, 定价, membership, 会员]
+  ✅ 提取了标题: 定价系统
+  ✅ 提取了 Phase 1.5 内容
+
+  🔧 步骤 2: 创建目录
+  ⏳ 运行: mkdir -p changes/refactor-pricing-frontend/specs
+  ✅ 目录已创建
+
+  🔧 步骤 3: 创建 proposal.md
+  ⏳ 从 MDX 提取内容
+  ✅ 生成: proposal.md
+    - keywords: [pricing, 定价, membership, 会员, payment, 支付]
+    - Why: 当前包名错误，架构混乱
+    - What Changes: 重命名包，按三层架构重构
+    - Impact: 影响 packages/membership, apps/*
+
+  🔧 步骤 4: 创建 tasks.md
+  ⏳ 从 MDX 提取任务列表
+  ✅ 生成: tasks.md (8 个任务)
+
+  🔧 步骤 5: 创建 design.md
+  ⏳ 生成架构设计文档
+  ✅ 生成: design.md
+    - Context: L1 三层架构
+    - Decisions: 如何拆分原子层、混合层、拼装层
+    - Migration Plan: 重构步骤
+
+  🔧 步骤 6: 验证
+  ⏳ 运行: openspec validate refactor-pricing-frontend --strict
+  ✅ 验证通过
+
+显示结果:
+  ✅ OpenSpec 已生成
+
+  📂 位置:
+  openspec/changes/refactor-pricing-frontend/
+
+  📄 文件:
+  - proposal.md (提案文档)
+  - tasks.md (8 个任务)
+  - design.md (架构设计)
+  - specs/ (空目录，如需要可添加 delta)
+
+  💡 下一步:
+  1. Review OpenSpec 内容
+  2. 如需修改，手动编辑文件
+  3. 运行: openspec validate refactor-pricing-frontend --strict
+  4. 继续 Product Builder 流程
+```
+
+## 错误处理
+
+### 错误 1：已存在类似的 OpenSpec
+
+**智能相似度检测逻辑**：
+
+```
+检测到 OpenSpec → 读取 proposal.md → 计算相似度 → 自动决策
+```
+
+**相似度计算**：
+- **关键词重合度**：比较 keywords 数组
+- **目标相似度**：比较 Why/What Changes 的文本内容
+- **任务重叠度**：比较 tasks.md 的任务列表
+
+**决策规则**：
+- 相似度 > 80% → 使用现有 OpenSpec
+- 50% < 相似度 < 80% → 创建新的（可能是相关但不同的任务）
+- 相似度 < 50% → 创建新的（明显不同的任务）
+
+**示例 1：高度相似（使用现有）**
+```
+✅ 发现高度相似的 OpenSpec: pricing-frontend-refactor
+
+📊 相似度: 85%
+  - 关键词: 85% (pricing, frontend, refactor, membership)
+  - 目标: 90% (重构前端架构)
+  - 任务: 75% (重命名包、三层架构)
+
+📋 决策: 使用现有 OpenSpec
+
+📂 路径: openspec/changes/pricing-frontend-refactor/
+
+⏭️  跳过创建，直接解析
+```
+
+**示例 2：中度相似（创建新的）**
+```
+⚠️  发现中度相似的 OpenSpec: pricing-backend-api
+
+📊 相似度: 60%
+  - 关键词: 60% (pricing, api)
+  - 目标: 50% (都涉及 pricing，但前端 vs 后端)
+  - 任务: 40%
+
+📋 决策: 创建新的 OpenSpec
+
+原因: 相似度不够高，可能是不同任务
+
+💡 建议 change-name: pricing-frontend-phase-1.5
+
+✅ 继续创建
+```
+
+**示例 3：低度相似（创建新的）**
+```
+ℹ️  发现相关 OpenSpec: user-profile-update
+
+📊 相似度: 20%
+  - 关键词: 10% (frontend)
+  - 目标: 15%
+  - 任务: 5%
+
+📋 决策: 创建新的 OpenSpec
+
+✅ 继续创建
+```
+
+### 错误 2：目录已存在
+
+**自动决策逻辑**：
+
+```
+目录已存在 → 检查是否有完整的 OpenSpec 文件
+  ↓
+有完整文件（proposal.md + tasks.md）→ 使用现有 OpenSpec
+  ↓
+文件不完整或损坏 → 覆盖并重新创建
+```
+
+**示例**：
+```
+⚠️  OpenSpec 目录已存在: openspec/changes/refactor-pricing-frontend/
+
+🔍 检查文件完整性...
+  ✅ proposal.md (存在)
+  ✅ tasks.md (存在)
+  ✅ design.md (存在)
+
+📋 自动决策: 使用现有 OpenSpec
+
+⏭️  跳过创建步骤
+```
+
+**重要**：
+- 默认使用现有 OpenSpec（如果完整）
+- 避免覆盖用户已编辑的内容
+- 如果文件损坏，自动重新创建
+
+### 错误 3：MDX 文档不存在
+
+```
+❌ 错误: MDX 文档不存在
+📂 路径: <mdx-path>
+
+💡 建议:
+1. 检查路径是否正确
+2. 使用绝对路径
+3. 或使用文档搜索功能查找
+```
+
+### 错误 4：验证失败
+
+```
+❌ 错误: OpenSpec 验证失败
+🔍 原因: <验证错误信息>
+
+💡 建议:
+1. 检查 proposal.md 格式
+2. 检查 tasks.md 格式
+3. 运行: openspec validate <change-name> --strict
+4. 查看详细错误信息
+```
+
+### 错误 5：change-name 命名不规范
+
+```
+❌ 错误: change-name 命名不规范
+📝 当前: pricing_frontend_refactor
+
+💡 正确格式:
+- 使用 kebab-case (小写 + 连字符)
+- 使用 verb-led 前缀:
+  - refactor-* (重构)
+  - add-* (新增)
+  - update-* (更新)
+  - remove-* (删除)
+  - fix-* (修复)
+
+建议的名称:
+- refactor-pricing-frontend
+- refactor-pricing-frontend-architecture
+- refactor-pricing-l1-structure
+```
+
+你想选择哪个选项？
+```
+
+### 错误 2：MDX 文档不存在
+
+```
+❌ 错误: MDX 文档不存在
+📂 路径: <mdx-path>
+
+💡 建议:
+1. 检查路径是否正确
+2. 使用绝对路径
+3. 或使用文档搜索功能查找
+```
+
+### 错误 3：验证失败
+
+```
+❌ 错误: OpenSpec 验证失败
+🔍 原因: <验证错误信息>
+
+💡 建议:
+1. 检查 proposal.md 格式
+2. 检查 tasks.md 格式
+3. 运行: openspec validate <change-name> --strict
+4. 查看详细错误信息
+```
+
+## 相关命令
+
+- `openspec list` - 列出所有 changes
+- `openspec show <change-name>` - 查看 change 详情
+- `openspec validate <change-name> --strict` - 验证 change
+- `openspec archive <change-name>` - 归档 change
+
+## 注意事项
+
+1. **OpenSpec 没有 `create` 命令** - 必须手动创建目录和文件
+2. **change-name 命名规范** - kebab-case, verb-led (refactor-, add-, update-, remove-)
+3. **proposal.md 和 tasks.md 是必须的** - design.md 和 specs/ 是可选的
+4. **验证是必须的** - 创建后必须运行 `openspec validate --strict`
+5. **从 MDX 提取内容** - 不要自己编造，要从 MDX 中提取真实内容
+
+## 执行步骤
+
+### 1. 读取 MDX 文档
+
+```bash
+# 使用 Read 工具读取 MDX 内容
+Read(filePath=<mdx-path>)
+```
+
+**提取信息**：
+- frontmatter 中的 keywords
+- 文档标题
+- 主要内容（Phase 描述、任务列表等）
+
+### 2. 创建 OpenSpec 目录结构
+
+**注意**：OpenSpec 没有 `create` 命令，需要手动创建目录。
+
+```bash
+# 使用 Bash 工具创建目录
+cd <openspec-root-dir>
+mkdir -p openspec/changes/<change-name>/specs
+```
+
+**目录结构**：
+```
+openspec/changes/<change-name>/
+├── proposal.md    # 提案文档
+├── tasks.md       # 任务列表
+├── design.md      # 设计文档（可选）
+└── specs/         # 规范变更（如果需要）
+```
+
+### 3. 创建 proposal.md
+
+```bash
+# 使用 Write 工具创建 proposal.md
+Write(
+  filePath="openspec/changes/<change-name>/proposal.md",
+  content="<从 MDX 提取的内容>"
+)
+```
+
+**内容格式**（参考 `openspec/AGENTS.md`）：
+```markdown
+---
+keywords: [从 MDX frontmatter 提取的 keywords]
+---
+
+# Change: [简短描述]
+
+## Why
+[1-2 句话说明问题/机会]
+
+## What Changes
+- [变更列表]
+- [标记破坏性变更为 **BREAKING**]
+
+## Impact
+- Affected specs: [影响的能力]
+- Affected code: [关键文件/系统]
+```
+
+**从 MDX 提取**：
+- **keywords**: 
+  - 优先从 MDX frontmatter 的 `keywords` 字段提取
+  - 如果 MDX 没有 keywords，从标题、描述、内容中自动提取
+  - 提取规则：功能名称、模块名称、技术栈、操作类型
+  - 示例：[pricing, 定价, membership, 会员, refactor, 重构, frontend, 前端]
+- **Why**: 从 MDX 的背景部分提取
+- **What Changes**: 从 Phase 描述提取
+- **Impact**: 从任务列表推断
+
+### 4. 创建 tasks.md
+
+```bash
+# 使用 Write 工具创建 tasks.md
+Write(
+  filePath="openspec/changes/<change-name>/tasks.md",
+  content="<从 MDX 提取的任务列表>"
+)
+```
+
+**内容格式**：
+```markdown
+## 1. Implementation
+- [ ] 1.1 任务 1
+- [ ] 1.2 任务 2
+- [ ] 1.3 任务 3
+
+## 2. Testing
+- [ ] 2.1 测试 1
+- [ ] 2.2 测试 2
+```
+
+### 5. 创建 design.md（可选）
+
+**仅在以下情况创建**：
+- 跨服务/模块的变更
+- 新的架构模式
+- 复杂的技术决策
+
+```bash
+# 使用 Write 工具创建 design.md
+Write(
+  filePath="openspec/changes/<change-name>/design.md",
+  content="<设计文档内容>"
+)
+```
+
+### 6. 验证输出
+
+```bash
+# 使用 Bash 工具验证
+cd <openspec-root-dir>
+openspec validate <change-name> --strict
+```
+
+**检查**：
+- OpenSpec 目录是否创建
+- proposal.md, tasks.md 是否存在
+- 格式是否正确
+
+## 使用示例
+
+### 示例 1：从 MDX 生成 OpenSpec
+
+```
+Agent 调用 mdx-to-openspec:
+  输入:
+  - mdxPath: /path/to/pricing-system.mdx
+  - changeName: pricing-system
+
+执行:
+  🔧 步骤 1: 读取 MDX
+  ⏳ 读取: pricing-system.mdx
+  ✅ 提取了 keywords: [pricing, 定价, membership, 会员]
+  ✅ 提取了标题: Pricing System Phase 1.5
+  ✅ 提取了内容: 1500 words
+
+  🔧 步骤 2: 调用 openspec create
+  ⏳ 运行: openspec create pricing-system
+  ✅ 创建: openspec/changes/001-pricing-system/
+  ✅ 生成: proposal.md (模板)
+  ✅ 生成: design.md (模板)
+  ✅ 生成: tasks.md (模板)
+
+  🔧 步骤 3: 填充 proposal.md
+  ⏳ 填充 frontmatter (keywords)
+  ⏳ 填充背景（从 MDX 提取）
+  ⏳ 填充目标（从 MDX 提取）
+  ⏳ 填充价值（从 MDX 提取）
+  ⏳ 填充范围（从 MDX 提取）
+  ✅ proposal.md 已填充
+
+显示结果:
+  ✅ OpenSpec 已生成
+
+  📂 位置:
+  openspec/changes/001-pricing-system/
+
+  📄 文件:
+  - proposal.md (已填充 MDX 内容)
+  - design.md (模板，需要手动完善)
+  - tasks.md (模板，需要手动完善)
+
+  💡 下一步:
+  1. 查看生成的 OpenSpec
+  2. 手动完善 design.md 和 tasks.md
+  3. 批准: openspec approve 001-pricing-system
+  4. 继续 Product Builder 流程
+```
+
+## 错误处理
+
+### 错误 1：openspec 命令不存在
+
+```
+❌ 错误: openspec 命令不存在
+🔍 原因: OpenSpec CLI 未安装或不在 PATH 中
+
+💡 建议:
+1. 检查 OpenSpec 是否安装
+2. 检查 PATH 配置
+3. 或手动创建 OpenSpec 目录结构
+```
+
+### 错误 2：MDX 文档不存在
+
+```
+❌ 错误: MDX 文档不存在
+📂 路径: <mdx-path>
+
+💡 建议:
+1. 检查路径是否正确
+2. 使用绝对路径
+3. 或使用文档搜索功能查找
+```
+
+### 错误 3：OpenSpec 目录已存在
+
+```
+⚠️  警告: OpenSpec 目录已存在
+📂 路径: openspec/changes/001-pricing-system/
+
+💡 选项:
+1. 使用现有 OpenSpec（跳过创建）
+2. 删除现有 OpenSpec（重新创建）
+3. 使用不同的 change 名称
+```
+
+## 相关命令
+
+- `openspec create <name>` - 创建新的 OpenSpec 提案
+- `openspec list` - 列出所有 OpenSpec
+- `openspec approve <id>` - 批准 OpenSpec
+- `openspec archive <id>` - 归档 OpenSpec
+
+## 注意事项
+
+1. **使用 OpenSpec 的标准命令** - 不要重新发明轮子
+2. **只填充 proposal.md** - design.md 和 tasks.md 需要手动完善
+3. **keywords 处理逻辑**：
+   - 优先使用 MDX frontmatter 的 keywords
+   - 如果 MDX 没有 keywords，从标题和内容中自动提取
+   - 确保 proposal.md 的 frontmatter 包含 keywords（不能为空）
+4. **生成后需要人工 review** - OpenSpec 是标准化的中间格式
+5. **批准后才能继续开发流程** - 确保 OpenSpec 质量
+6. **frontmatter 格式必须正确** - 使用 YAML 格式，keywords 是数组