feat: mcp prompts

docs/mcp.md

@@ -289,13 +289,125 @@ label,name,type,cost,description
 - 其他列：由 frontmatter 中的 `fields` 定义
 - `body`: 卡牌 body 内容（可选，支持 `{{字段名}}` 语法）
 
+## MCP Prompts
+
+MCP 服务器提供以下 Prompts，用于引导用户完成卡牌设计工作流：
+
+### `design-card-game` - 设计卡牌游戏
+
+引导用户设计新的卡牌游戏系统，定义卡牌模板和字段结构。
+
+**参数：**
+
+| 参数 | 类型 | 必需 | 说明 |
+|------|------|------|------|
+| `deck_name` | string | ✗ | 卡牌组名称 |
+| `output_dir` | string | ✗ | 输出目录（相对路径） |
+| `game_theme` | string | ✗ | 游戏主题/类型（如：奇幻、科幻、恐怖等） |
+
+**使用示例：**
+
+```json
+{
+  "name": "design-card-game",
+  "arguments": {
+    "deck_name": "魔法物品",
+    "output_dir": "./content",
+    "game_theme": "奇幻"
+  }
+}
+```
+
+**返回内容：**
+
+Prompt 会返回一个对话式的引导流程，帮助 AI 助手了解：
+1. 卡牌类型（角色卡、物品卡、法术卡等）
+2. 核心机制（费用系统、稀有度、阵营等）
+3. 卡牌信息字段
+
+并提供常见配置的示例参考。
+
+---
+
+### `populate-deck` - 填充卡牌内容
+
+为已有的卡牌组生成和填充卡牌内容。
+
+**参数：**
+
+| 参数 | 类型 | 必需 | 说明 |
+|------|------|------|------|
+| `csv_file` | string | ✗ | CSV 文件路径 |
+| `card_count` | number | ✗ | 要生成的卡牌数量 |
+| `theme` | string | ✗ | 卡牌主题/描述 |
+
+**使用示例：**
+
+```json
+{
+  "name": "populate-deck",
+  "arguments": {
+    "csv_file": "./content/magic-items.csv",
+    "card_count": 20,
+    "theme": "火焰主题法术"
+  }
+}
+```
+
+**返回内容：**
+
+Prompt 会引导 AI 助手：
+1. 读取现有卡牌模板结构
+2. 选择生成方式（随机/主题化/手动/扩展现有）
+3. 生成符合主题的卡牌内容
+
+---
+
+### `setup-deck-display` - 配置卡牌显示
+
+引导用户配置卡牌的显示参数（尺寸、布局、样式等）。
+
+**参数：**
+
+| 参数 | 类型 | 必需 | 说明 |
+|------|------|------|------|
+| `csv_file` | string | ✗ | CSV 文件路径 |
+| `usage` | string | ✗ | 卡牌用途（如：桌面游戏、印刷、在线预览等） |
+
+**使用示例：**
+
+```json
+{
+  "name": "setup-deck-display",
+  "arguments": {
+    "csv_file": "./content/magic-items.csv",
+    "usage": "桌面游戏"
+  }
+}
+```
+
+**返回内容：**
+
+Prompt 会引导 AI 助手配置：
+1. 卡牌尺寸（桥牌尺寸、标准尺寸、塔罗尺寸等）
+2. 网格布局（每张 A4 纸的排列）
+3. 出血边距、内边距
+4. 卡牌形状
+5. 图层配置（自动排版文字）
+
+---
+
 ## 工作流示例
 
 ### 创建新卡牌组
 
-1. **定义模板**：调用 `deck_frontmatter_write` 创建 CSV 和 frontmatter
-2. **创建预览**：调用 `deck_ensure_preview` 创建 Markdown 预览文件
-3. **添加卡牌**：调用 `deck_card_crud`（action=create）添加卡牌
+1. **设计模板**：调用 `design-card-game` Prompt 引导设计字段结构
+2. **定义模板**：调用 `deck_frontmatter_write` 创建 CSV 和 frontmatter
+3. **创建预览**：调用 `deck_ensure_preview` 创建 Markdown 预览文件
+4. **填充内容**：调用 `populate-deck` Prompt 引导生成卡牌内容
+5. **添加卡牌**：调用 `deck_card_crud`（action=create）添加卡牌
+6. **配置显示**：调用 `setup-deck-display` Prompt 配置显示参数
+7. **保存配置**：调用 `deck_frontmatter_write` 更新 deck 配置
 
 ### 修改现有卡牌组