技能介绍

要解决什么问题

在虾友 SkillHub 上架付费 Skill，既要走会员与配额闸门，又要区分首次发布和更新已有条目——若不做平台探查就调 POST /api/skills/publish，很容易把「更新」做成重复创建。此外，付费上架还涉及大分类（experience / book / course 等）、封面、定价，以及 description 必须携带 SKILL.md 与配套 .md 全文、整目录 fileTree 上传，任一环节省略都会导致线上装成「空壳」或元数据残缺。

技能如何工作

本 Skill 以人格化助手「小虾」组织对话，核心流程大致是：先聊 Skill 卖点 → 在收凭证前说明会员要求 → 收集用户本人的 API Key（sk- 前缀）与邀请码（BETA- 格式）并写入配置 → 自动校验身份与 canPublishPaidSkill，并用 dryRun 探测写权限 → 选大分类、封面与价格 → 按 slug 优先（GET /api/skills/{slug}/install-info）判断创建或更新，更新走 POST /api/skills/{id}，并写入版本历史。

发布前会强制做元数据完整性检查（名称、slug、版本、标签、价格等），并遵守密钥铁律：禁止在 config.json 硬编码密钥，示例只展示格式前缀。

适用边界与注意点

平台范围：专为虾友 SkillHub 付费 Skill；免费分发应使用「Skill 矩阵分发助手（免费版）」。
认证方式：读写统一 Authorization: Bearer {api_key} + X-Invite-Code: {invite_code}；写权限不足时应引导用户在平台重新生成 Key，而不是改用手机号登录或 GET 降级。
腾讯 SkillHub：若用户要求同步，因 API 无法列全库，需用户自行确认是否已有同名 Skill 及 ID。
删除下架：slug 匹配 + 详情展示 + dry-run，需用户明确确认后才执行。