WorkBuddy 上架改造
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @redfox-data/skill-to-workbuddy。
技能介绍
要解决的问题
通用 SKILL.md 与 WorkBuddy 平台之间有一条硬性差距。通用格式通常只需要 name 和 description,而 WorkBuddy 的上架规范要求在 frontmatter 中补齐 6 个强制字段(display_name、description_zh、category、version、author 等),此外还要提供 32x32 SVG 图标以符合商店展示要求。手工改造很容易踩三类坑:
- 字段遗漏:
description_zh留空,或display_name_en/description_en以空字符串直接提交; - source 标识不一致:多个文件中
github→workbuddy替换时出现大小写差异,导致链接参数校验失败; - 链接参数写错:redfox.hk 网站链接缺少
source参数,或 API 链接错用了网站链接的写法(全小写workbuddy),而规范要求 API 链接使用首字母大写的WorkBuddy。
更麻烦的是,整个过程涉及大量机械操作:改 frontmatter、全局替换 source、逐条核对链接、生成图标、打包 zip,漏掉任何一步,产物就不符合上架条件。
它是怎么工作的
该技能把改造拆成几个阶段。先运行分析脚本,扫描目标 SKILL.md,输出已有字段、缺失字段和可用分类列表,并附带建议值;然后与用户逐项确认 display_name、description_zh、category 等字段,确认后执行转换。
真正繁重的工作在转换命令里一次完成:
- 字段补齐:解析现有 YAML frontmatter,保留全部已有字段,只追加缺失的 WorkBuddy 字段,正文一字不改;
- Source 替换:遍历目录内所有文本文件,
github→workbuddy、GitHub→WorkBuddy,跳过二进制文件与隐藏目录; - redfox.hk 链接处理:为网站链接自动追加
source=workbuddy,跳过含/api/路径或api.redfox.hk子域名的接口链接,已有 source 参数的不重复写; - source 值校验:自动修复任意大小写写法,网站链接必须是全小写
workbuddy,API 链接必须是首字母大写的WorkBuddy; - 空字段检查:报告
display_name_en/description_en是否为空,Step 4 中强制补充。
之后还有两个需要用户确认的步骤:生成 32x32 SVG 图标,以及打包 zip(排除 icon.svg 与 .git、node_modules 等)。图标生成配有按类型划分的配色速查(搜索查询 #2563EB、下载媒体 #16A34A、社交媒体 #EC4899……),平台相关 skill 则优先采用平台品牌色(抖音 #000000、小红书 #FF2442、B 站 #FB7299)。
适用边界
- 只改 frontmatter 和链接参数,正文与已有字段不会被覆盖;
category不在 10 个标准分类内会警告但仍允许写入,不阻断流程;- 版本号按 X.Y.Z 规则自动提升,Z 到 10 进位到 Y,首次默认
1.0.0; - 生成图标与打包 zip 都需用户确认后才执行,不会悄悄产生副作用;
- 建议转换前自行备份或使用 git 版本控制,脚本处理的是磁盘上的真实文件。
使用场景
- 写好的抖音搜索 SKILL.md 要上架 WorkBuddy,需补齐 display_name、category 等必填字段并生成图标。
- SKILL 文档中 github 与 WorkBuddy 域名写法混用,redfox.hk 链接缺少 source 参数,上架前需统一替换与校验。
- 改过的 SKILL.md 里 display_name_en 为空、description 照搬英文,需要补英文字段并提炼中文一句话简介。
- 准备上架整个 skill 目录时,需确认打包 zip 自动排除 icon.svg、.git、node_modules 等无关文件。
适合人员
- 独立技能开发者:已写好自动化 SKILL.md,想把 frontmatter 补齐并生成 32x32 图标,减少手工改造的重复劳动。
- 技能维护者:负责多个 redFox 采集 skill 的迭代,每次发布前要核对链接 source 参数与版本号是否符合规范。
- 数据工具团队技术负责人:需要批量把内部 SKILL.md 迁移到 WorkBuddy 格式,并检查空字段与分类是否正确。
- 独立站运营:准备把海外平台发布 skill 上架 WorkBuddy,没有设计资源,正好需要按规范生成 SVG 图标。