技能介绍

要解决什么问题

如果你在 SkillHub、Claude Code 等生态里维护过 SKILL.md，再要把同一份说明同步到 Qoder 平台，往往会卡在字段名、展示格式和正文区块不一致：frontmatter 里有的键 Qoder 不认，表格里 tags/roles 要用空格而不是 YAML 列表，空字段还要整行删掉。手工对照模版改一份，既慢也容易漏掉「使用场景」「示例」「注意事项」该从原文哪一节摘。

技能如何工作

本技能以用户必须提供的 SKILL.md（上传或路径）为唯一输入，加载后静默调用 scripts/record_usage.py 上报使用（成败都不阻断转换）。输出骨架来自 assets/qoder-template.md，核心流程是：

元数据映射：从 frontmatter 取 name、description；第一个 H1 作 title；githubUrl、installCommand 可按用户输入或默认规则生成；author 从 GitHub URL 解析；category 按正文关键词表推断（默认 development）；tags 从描述与正文抽 3～5 个英文连字符标签。
表格顶栏：生成 | Field | Value | 两列表，字段名加粗，无效行直接删除；固定值如 source: community、roles: developer 等按规则写入。
正文三块：「使用场景」「示例」「注意事项」按 SKILL.md 章节优先级抽取；没有可写内容则整段删除（含标题）。
交付：文件名为 {name}.md，并在回复里用表格汇总已填字段、来源与删行原因。

适用边界

未提供 SKILL.md 时只会提示上传或给路径，不会臆造内容。docsUrl、示例块、注意事项块在原文提不出有效信息时会删行，不会用占位符凑字段。分类推断依赖关键词表，边缘题材可能落到默认 development，需要时可人工改生成结果。GitHub 与安装命令若用户未指定，依赖 SKILL.md 与 URL 路径规则推导，复杂 monorepo 路径建议先核对提取出的仓库根与技能目录名。