用华为云码道 CodeArts 从零开发一个 Skill，并上架双市场

前几天参加华为开发者大赛的 Skill 创新赛，要求把作品同时发布到华为云 Skill 市场和小红书 Skill 市场。我没写过 Skill，于是完整走了一遍「用码道 CodeArts 生成 Skill → 发布到两个市场」的流程。这篇把过程和我踩到的坑记下来。

一、先搞清楚 Skill 是什么

简单说，Skill 就是给 AI 助手加的一段「专业能力包」：一个 SKILL.md 说明书，加上它需要的脚本和模板。触发词写得好，用户一句话就能把整段流程跑起来。

从官方文档能看到目录约定：

my-skill/
├── SKILL.md          # 必须有：元信息 + 使用说明
├── scripts/          # 可选：可执行脚本
├── references/       # 可选：参考文档
└── assets/           # 可选：模板等静态资源

SKILL.md 顶部的 YAML frontmatter 里，name 和 description 是必填项。description 一定要写成单行。

二、让码道把 Skill 写出来

打开码道 CodeArts 网页版，新建任务，把需求讲清楚就行。我提的是：

你是一个技能开发专家。帮我创建一个 Skill，能够把一段中文会议记录自动整理成结构化纪要，提取结论和待办事项，并输出 Markdown。请给出完整的 SKILL.md 和可运行的脚本实现。

接下来码道自己做了一整套动作，这部分挺超出预期的：

1. 加载 skill-authoring 技能，按规范建目录

2. 生成 SKILL.md、scripts/parse_meeting.py、references/extraction-rules.md、assets/template.md

3. 跑 validate_skill.py 自检

4. 建 evals/ 测试集并执行

5. 测试暴露出 8 个真实提取缺陷，它自己把脚本重写成「段落状态机 + 句级判定」，再跑一轮全绿

整个过程 7 分多钟，最后给了 13 个产物。这一点值得点赞：它不是给你一段演示代码就完事，而是真的写了测试、跑了测试、根据失败结果改了实现。

三、发布到华为云 Skill 市场

在码道对话框里直接说：

我正在参加小红书Skill创新赛，帮我把这个Skill先发布到华为云Skill市场

它会带着你走 redskillhub-upload 的流程，最后回执里能看到发布结果：Skill 名称、分类、版本号、状态。到 skills.huaweicloud.com/community 搜一下就能看到自己的作品。

这一步很顺，一次就过。

四、发布到小红书 SkillHub（坑都在这）

同样的方式让它发到小红书，就热闹了。连着撞了三道校验：

1. 实名认证：SUBMIT_REJECTED / 请先完成实名认证。这个只能本人去小红书 App 做，别人替代不了。

2. 名称长度限制：原名 19 个字符超限。注意是按 name 判重和限长，不是按 identifier——一开始只改 identifier 完全没用。

3. Skill ID 已被占用：疑似首次失败的那次提交已经在平台侧留了记录，导致 meeting-minutes 和缩短后的 minutes-pro 都被判占用。

最后换成一个独特组合才通过，Skills 内容（脚本、模板、测试）一个字没改，只是名字适配了平台规则。

所以如果要给建议：一开始就把名字起短、起独特，别用太通用的词，能省掉两轮往返。

五、几条实用经验

• 提需求时把「交付物」写全：直接说要 SKILL.md + 可运行脚本，它会连测试一起给你。
• 触发词要写进 description：用户会怎么说这个需求，就把那些说法都列进去，命中率高很多。
• 发布前检查 frontmatter：description 用 | 这种多行块标量时，有的 CLI 只会取到一个 | 字符，简介就废了。
• 两个市场的规则不一样：华为云侧相对宽松，小红书侧对实名、名称长度、ID 唯一性都卡得比较严。先用严格的那边验证命名，再发另一边。

六、小结

从零到 Skill 上架，整个链路在浏览器里就能完成，不需要装 IDE、不需要本地环境。真正花时间的不是写代码，而是搞清楚平台各自的提交规则。把规则先摸清，后面就很顺了。

如果你也想试试，建议从一个很小的场景入手（比如「把会议记录整理成纪要」这种输入输出都很明确的），跑通全流程之后再去做复杂的。