宠物就医准备清单官 Skill 开发实录（三）：发布到 Skill 市场的四个坑与两版差异

前两篇写了骨架和自检。这篇记录把它真正发布到一个 Skill 市场的过程，以及发布环节暴露出来的问题——这部分比写代码更容易翻车。

一、发布入口和实际路径

小红书 Skill 创新赛的硬门槛是：作品必须至少使用华为云码道 CodeArts 或果办 OfficeAce 其中之一，并且要通过它把 Skill 提交到「华为云 Skill 市场」和「小红书 Skill 市场」。

实际走下来，提交本身是两句话的事：在码道里说清楚需求，然后说「帮我把这个 Skill 发布到华为云 Skill 市场和小红书 Skill 市场」。

但真正花时间的不是这两句话，是它中间问的几个问题，以及它自己踩到的坑。

二、发布环节踩到的四个坑

1. 沙箱工作目录是空的

码道的新会话里，/workspace 是空的。我本地的 Skill 有 15 个文件，但它看不到，也没有文件上传入口（页面上只有「连接到AtomGit」）。

结果它反过来问我：你要发布的 Skill 在哪？给的两个选项是「我指定路径」和「还没创建」。

教训：想发布已有产物，要么先把 zip 传进沙箱，要么用「连接到AtomGit」把仓库接进去。否则只能让它按需求重建一遍。

2. zip 结构必须扁平

华为云 Skill 市场要求 SKILL.md 在 zip 的根目录。第一次打包带了 pet-medical-prep/ 这一层子目录，直接被拒。

这一点码道自己发现了：它读完报错后重新打包，把 SKILL.md 挪到根目录，再传一次就过了。

自查命令：解压后确认 SKILL.md 在顶层，不是嵌在某个目录里。

3. 分类是平台给定枚举

华为云市场的分类只有五个：效率工具、内容创作、学习成长、生活方式、开发工具。

宠物就医这类场景，最贴的是「生活方式」。选错分类不影响发布，但会影响被检索到的概率。

4. 两个市场的发布方式不一样

华为云这边是它直接调接口上传，一次成功；小红书 SkillHub 给了两条路：

• CLI 自动上传（需要扫码授权）
• 手动上传链接（自己在浏览器里传 zip）

我选了手动。原因很简单：扫码授权意味着要动账号，这种动作让人自己确认更合适。

三、发布结果与一个必须说清的差异

华为云 Skill 市场发布成功：名称 pet-medical-prep、版本 1.0.0、分类生活方式、耗时 12 分 13 秒、消耗 55.69 积分、8 个产物。

但这里有个差异要说明：它重建出来的版本只有 4 个文件（SKILL.md、一个急症匹配脚本、两个知识库文档），而我本地那版有 15 个文件（五子命令脚本 + self-test、4 篇 references、3 个案例、3 篇笔记、README、自检报告）。

这是「让 AI 按需求重建」和「发布已有产物」的必然差别：前者会按它自己的理解精简，后者才保留你验证过的完整结构。

比赛规则是「以截止前最新一次提交为准」，所以做法是：先用重建版占位，把参赛事实锁定；后面再把本地完整版打包重传，替换掉它。

四、发布前后该做的最小检查

1. zip 根目录有 SKILL.md，且 frontmatter 里 name / description 齐全
2. 脚本能在干净环境跑通（我用 self-test 兜底，9 项断言）
3. 安全边界写进 SKILL.md 而不是只写在说明里（否则换个调用方就丢了）
4. 发布后回赛事页确认状态，别只看工具回执

五、下一步

把本地完整版替换上去，然后在小红书发笔记拿真实反馈。发布只是把作品放上货架，能不能进下一轮看的是有没有人真的用它。