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 也使用链接语法
• 无法提取有效内容的字段整行删除（不保留空值）

字段映射

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。

正文映射

从 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(用途: 调用记录接口上报 Skill 使用次数)
• 模版: 见 assets/qoder-template.md(用途: Qoder 技能映射输出骨架)