---
name: qoder-skill-mapper
description: 根据 SKILL.md 文件生成 Qoder 技能映射模版文件。读取用户提供的 SKILL.md，自动提取 frontmatter 和正文内容，填充 Qoder 模版的对应字段，无法提取的字段自动移除。当用户需要将技能迁移/适配到 Qoder 平台时使用。
---

# Qoder 技能映射生成器

## 概述

将 用户提供的 SKILL.md 转换为 Qoder 平台的技能描述文件。读取 SKILL.md 的 frontmatter 和正文内容，智能映射到 Qoder 模版字段，无法提取有效内容的字段自动删除。

## 前置检查

1. 用户**必须提供** SKILL.md 文件（上传文件或指定路径）
2. 若用户未提供 SKILL.md，直接提示：「请上传需要转换的 SKILL.md 文件，或提供文件路径」
3. **Skill 加载后，立即调用** `scripts/record_usage.py` 上报使用记录（静默调用，**无论成功与否均不影响后续流程**）

## 字段映射规则

读取 `assets/qoder-template.md` 作为输出骨架，按以下规则填充：

### 字段表格格式

生成的文件**顶部字段信息使用 Markdown 两列表格展示**，必须包含表头行和分隔行：

```
| Field | Value |
|-------|-------|
| **name** | skill-name |
| **title** | Skill Title |
| **description** | A brief description... |
| **source** | community |
| **author** | Author Name |
| **githubUrl** | [https://github.com/example/skill](https://github.com/example/skill) |
| **docsUrl** | [https://example.com/docs](https://example.com/docs) |
| **category** | development |
| **tags** | tag1 tag2 |
| **roles** | developer |
| **featured** | false |
| **popular** | false |
| **isOfficial** | false |
| **installCommand** | git clone [https://github.com/example/skill](https://github.com/example/skill) cp -r skill-name ~/.qoder/skills/ |
| **date** | 2026-01-01 |
```

**格式要求：**
- 表头行：`| Field | Value |`
- 分隔行：`|-------|-------|`（至少3个减号）
- 数据行：`| **字段名** | 字段值 |`
- 第一列：加粗的字段名（如 `**name**`）
- 第二列：字段值
- `tags` 值用**空格分隔**（不是 YAML 列表，如 `wechat hot-articles 10w-reading`）
- `roles` 值用**空格分隔**（如 `developer`）
- URL 字段（githubUrl、docsUrl）使用 Markdown 链接语法 `[url](url)`
- installCommand 中的 URL 也使用链接语法
- 无法提取有效内容的字段**整行删除**（不保留空值）

### 字段映射

| Qoder 字段       | 数据来源                           | 规则                                                                |
| ---------------- | ---------------------------------- | ------------------------------------------------------------------- |
| `name`           | SKILL.md frontmatter `name`        | 直接取值                                                            |
| `title`          | SKILL.md 第一个 H1 标题文本        | 若 H1 为 `# xxx`，取 `xxx`；若无 H1 则取 `name` 并转 Pascal Case    |
| `description`    | SKILL.md frontmatter `description` | 直接取值                                                            |
| `source`         | 无来源                             | 固定值 `community`                                                  |
| `author`         | githubUrl 中的 GitHub 用户名       | 从 githubUrl 中提取 `github.com/{author}/` 部分（如 `redfox-data`） |
| `githubUrl`      | 用户输入 或 默认规则               | 见下方「GitHub 地址规则」                                           |
| `docsUrl`        | SKILL.md 正文中的文档链接          | 若无法提取有效链接则**删除此行**                                    |
| `category`       | SKILL.md 内容推断                  | 见下方「分类推断规则」                                              |
| `tags`           | 从 description + 正文关键词提取    | 3-5 个标签，英文小写，用连字符连接，空格分隔展示                   |
| `roles`          | 无来源                             | 固定值 `developer`                                                  |
| `featured`       | 无来源                             | 固定值 `false`                                                      |
| `popular`        | 无来源                             | 固定值 `false`                                                      |
| `isOfficial`     | 无来源                             | 固定值 `false`                                                      |
| `installCommand` | 用户输入 或 默认规则               | 见下方「安装命令规则」                                              |
| `date`           | 当前日期                           | 格式 `YYYY-MM-DD`                                                   |

### GitHub 地址规则

- 用户提供了 GitHub 地址 → 使用用户提供的地址
- 用户未提供 → 使用默认规则：
  ```
  githubUrl: https://github.com/redfox-data/redfox-community/tree/main/skills/{name}
  ```

### 安装命令规则

**仓库克隆地址提取规则**：
- 从 githubUrl 中提取仓库根地址：取 `github.com/{author}/{repo}` 部分，去掉 `/tree/main/...` 等路径
- 例如：`https://github.com/yuanyi-github/skills/tree/main/gzh-10w-article-recommend` → 克隆地址为 `https://github.com/yuanyi-github/skills`

**生成规则**：
- 用户提供了 GitHub 地址 → 基于提取的仓库地址生成：
  ```
  git clone {仓库根地址}
  cp -r {技能目录名} ~/.qoder/skills/
  ```
  其中 `{技能目录名}` 从 githubUrl 的路径中提取（如 `tree/main/gzh-10w-article-recommend` → `gzh-10w-article-recommend`）
- 用户未提供 → 使用默认规则：
  ```
  git clone https://github.com/redfox-data/redfox-community
  cp -r {name} ~/.qoder/skills/
  ```

### 分类推断规则

根据 SKILL.md 内容关键词匹配：

| 分类值         | 匹配关键词                                   |
| -------------- | -------------------------------------------- |
| `development`  | 代码、开发、API、脚本、编程、code、dev       |
| `marketing`    | 爆款、文案、内容、公众号、小红书、抖音、营销 |
| `productivity` | 效率、自动化、工具、管理                     |
| `data`         | 数据、分析、统计、查询、排行榜               |
| `design`       | 设计、封面、图片、UI、视觉                   |
| `document`     | 文档、PDF、Word、提取、OCR                   |
| `automation`   | 自动、定时、批量、机器人                     |
| `security`     | 安全、违禁、审核、检测                       |
| `meta`         | 技能、skill、模板、生成器（元能力类）        |

匹配不到时默认使用 `development`。

### 正文映射

从 SKILL.md 正文提取内容，填充 Qoder 模版的三个正文区块：

#### 使用场景

从 SKILL.md 中按优先级提取：

1. 「使用场景」章节 → 直接使用
2. 「使用指南」章节 → 精简为场景列表
3. 「功能特性」章节 → 转为场景描述列表
4. 「简介」中的「能做什么？」列表 → 转为场景列表

格式：每条场景以 `- ` 开头的无序列表。

#### 示例

从 SKILL.md 中按优先级提取：

1. 「示例」章节 → 直接使用
2. 「使用指南」中的代码块或命令示例
3. 正文中的 bash/python 代码块
4. 若无任何示例 → **删除此区块**

#### 注意事项

从 SKILL.md 中按优先级提取：

1. 「注意事项」章节 → 直接使用
2. 「限制」或「已知限制」章节
3. 「运行依赖」章节
4. 正文中的 WARNING/CAUTION 相关内容
5. 若无任何注意事项 → **删除此区块**

## 输出要求

1. 生成的文件以 `{name}.md` 命名（即 SKILL.md 中的 name 值，如 `gpt-image2-pro.md`）
2. 保持 Qoder 模版的 YAML frontmatter 格式和缩进
3. 正文区块之间保持空行分隔
4. 无法填充的正文区块整体删除（含标题）
5. 代码块保持原始语言标记
6. **生成文件后，在 reply 中用表格展示映射结果**，格式：

```
| Field | Value |
|-------|-------|
| **name** | gpt-image2-pro |
| **title** | AI 图片生成器 |
| **description** | AI 图片生成器 — 基于 gpt-image-2 模型... |
| **source** | community |
| **author** | redfox-data |
| **githubUrl** | [https://github.com/...](https://github.com/...) |
| **category** | design |
| **tags** | ai-image-generation text-to-image ... |
| **roles** | developer |
| **featured** | false |
| **popular** | false |
| **isOfficial** | false |
| **installCommand** | git clone ... |
| **date** | 2026-05-27 |
```

   - 已填充的字段标注实际值和来源
   - 已删除的字段标注 `—` 和删除原因
   - 使用固定值（如 `source: community`、`roles: developer`）也一并展示

## 资源索引

- 脚本: 见 [scripts/record_usage.py](scripts/record_usage.py)(用途: 调用记录接口上报 Skill 使用次数)
- 模版: 见 [assets/qoder-template.md](assets/qoder-template.md)(用途: Qoder 技能映射输出骨架)