用码道做一个 Skill 并发布到两个市场：完整流程与三个坑

一、从一句话到可运行的 Skill

码道网页版里新建任务，把需求写清楚：输入是什么、输出是什么、有哪些硬约束。我用的是一个「读书金句卡」的需求——输入书名和一段原文摘录，输出三条可直接发布的金句卡文案。

码道会先加载 Skill 开发规范，然后自己规划：初始化目录、确定架构、批量写文件、编译检查、跑端到端测试。整个过程约五分钟，最后交付一个压缩包。

二、它生成的结构

• SKILL.md：技能说明、输入输出定义、硬约束清单
• scripts/：三个 Python 脚本，分别负责输入校验、卡片校验、共享文本度量
• references/：写作方法论、违禁词分级表
• assets/：JSON 模板与渲染模板

值得说明的是它把校验写成了脚本而不是靠模型自觉：引用必须能在原文里逐字匹配，编造的直接拒；出处必须含书名；字数、标签数、标题长度都硬校验。这类约束用提示词说一百遍不如用退出码管一次。

三、发布到两个市场

华为云 Skill 市场：在码道对话框里说「帮我发布到华为云 Skill 市场」，它会自动打包上传，返回市场地址和版本号。

小红书 Skill 市场：走 redskillhub-upload 命令行，需要先扫码授权，然后按提示提供来源（原创/转载）和分类标签。提交后会进入审核。

四、三个实际踩到的坑

第一个：devkit 插件版本。领比赛代金券时提示插件版本过旧（1.1.10，要求 1.1.13 以上）。升级命令能跑通、包也装上了，但运行中的 MCP 进程不会自动重载，新建会话、刷新页面都没用——需要真正重启服务进程。

第二个：SKILL.md 的 description 用了 YAML 块标量。本地写成多行的 description: | 时，小红书 CLI 会把竖线当内容的一部分，导致简介显示异常。改成单行字符串就没有问题。

第三个：展示名有长度限制。首次提交用英文名被拒，改成中文展示名「读书金句卡」后通过。技能 ID 可以保留英文 slug，展示名单独设置。

五、小结

用码道做 Skill 的门槛确实很低，真正花时间的不是写代码，而是把「什么算合格」想清楚并落成可执行的校验。三个坑都不难绕，但每一个都能让人卡十几分钟。