Agent Skills
返回列表
WorkBuddy 上架改造

WorkBuddy 上架改造

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 图标。