qoder skill mapper create

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

to the moon@yuanyi-github

Install

openclaw skills install @yuanyi-github/qoder-skill-mapper

Qoder 技能映射生成器

概述

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

前置检查

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

字段映射规则

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

字段表格格式

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

text

| 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 地址 → 使用用户提供的地址

用户未提供 → 使用默认规则：

text

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 地址 → 基于提取的仓库地址生成：
text
```
git clone {仓库根地址}
cp -r {技能目录名} ~/.qoder/skills/
```
其中 {技能目录名} 从 githubUrl 的路径中提取（如 tree/main/gzh-10w-article-recommend → gzh-10w-article-recommend）

用户未提供 → 使用默认规则：

text

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 中按优先级提取：

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

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

示例

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

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

注意事项

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

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

输出要求

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

text

| 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 技能映射输出骨架)