开发者作品展览馆 Skill 发布指南：从公开仓到可投稿活动的完整走法

适用场景

这篇指南解决的是一个具体问题：华为云开发者作品展览馆现在没有传统的手工发布表单，发布要走 AI Skill 流程。很多人卡在三个地方：不知道“AI 对话”到底是哪个入口、Skill 装完不知道项目目录该指哪里、投稿活动列表里几十个选项不知道该选哪个。

下面按发布流程本身写，不按某一天的操作流水写，每一步都给了核对点，走到哪一步卡住，就在哪一步查。

1. 先确认作品和公开仓满足发布要求

发布的前提不是先打开 Skill，而是先有一个能被服务端拉到的作品：

• 项目根目录必须同时有代码和 README，缺 README 会在后面被 AI 判定为目录不对。
• 必须是一个公开 Git 仓地址加分支，GitHub、GitCode、Gitee 都可以，仓里不能有密钥和凭证。
• 在线演示不是必填，可以跳过，不影响提交。

核对方法很直接：克隆一次公开仓，看根目录文件是不是齐的，分支是不是要提交的那个分支。例如一个单页工具的根目录应该是这样：

index.html
checker.js
README.md

如果克隆下来发现多了一层目录，或者 README 不在根目录，先把目录结构修好再进下一步，不要在空目录或缓存、构建产物目录里装 Skill。

2. 选开发环境：指南没有指定唯一 App

指南里写的“在 AI 对话中”不是一个单独 App 的名字，它的意思是“在你上一节选择的开发环境中”。目前能看到的入口主要有两个：

• AI 开发者空间，里面的对话窗口叫 AI Shell，有 AI 对话、TUI、命令行三个页签。
• 码道聊天页和码道 IDE，FAQ 是按“公共 / AI 开发者空间 / 码道 IDE”三个环境页签组织的。

选哪个环境，就要在哪个环境的对话里完成后面全部步骤，不要在两个入口之间来回跳。进入环境后先看一件事：资源管理器里的 workspace 是不是空的。如果是空的，先把公开仓克隆进去，再装 Skill：

git clone <公开仓地址>

克隆完核对根目录文件、分支和远程地址，确认没有密钥，再继续。

另外注意容器类型：AI 开发者空间里有免费体验版容器和按核时付费的持久化版。发布只需要体验版，不要因为容器快到期就点持久化版，那是付费项。

3. 装 Skill：用复制按钮里的完整命令，核对全名

指南页上有一个“复制发布口令”按钮，复制出来的是安装命令，不是自然语言口令。安装命令的格式是：

npx skills add https://gitcode.com/Lingxi-HandsOn/gallery.git --skill huawei-cloud-publish-work-to-gallery -y

这里有一个容易踩的坑：页面 DOM 里 Skill 名会被截断显示成 ...-to-g，不要照着截断名打，一定要按代码块里的全名 huawei-cloud-publish-work-to-gallery 核对。安装要在带 Node.js 的终端里执行，码道 IDE 那边的 FAQ 也写了要确认终端里 node 和 npm 装好了。

装完后，在 AI 对话里发出发布口令：

请将当前项目发布至开发者作品展览馆。

AI 接下来会按顺序做六件事：识别作品与账号、检查运行与访问地址、检查 Git 仓库、生成展示材料、让你选可投稿活动、发布并返回链接。每一步需要你确认的事项，指南里都列了：作品目录对不对、要不要运行并展示、GitCode 登录与代码推送、投稿活动、重复发布的确认替换。

4. OAuth 回调抓不到时的处理

这是最容易耗时间的一步，处理原则是：先确认链接是不是最新的，再谈跳过。

• AI 发起 GitCode OAuth 后，如果回调长时间抓不到（例如多次 300 秒超时），不要反复点同一个旧链接，旧链接失效后要以 AI 重新给的新链接或新二维码为准。
• 授权要由账号本人完成，不要把密码、验证码、AK/SK、token 填给任何中间环节。
• 如果 AI 允许跳过 OAuth 直接发布，跳过后第一件事是核对作品页上的作者和仓库是不是自己的，再往下走。发布鉴权走的是临时凭证，公开仓由服务端自行拉取，这一步成立的前提是仓本身就是公开的。

如果跳过后作者或仓库对不上，停下来，不要继续提交。

5. 选投稿活动：先按状态过滤，再按绑定关系排除

AI 会列出当前可投稿活动，选活动只认一个硬条件：状态必须是“可投稿”，不可投稿的不能选，也不要编活动名。

状态过滤完，还要做第二层排除。列表里很多活动绑定了具体高校、地区或身份，例如高校教学合作、训练营、区域赛、布道师活动。如果你跟那个学校、地区或身份没有关联，就不要选，哪怕它在列表里排得很靠前。

一个可用的排除顺序是：

1. 只留“可投稿”状态的活动。
2. 排掉绑定具体高校的活动。
3. 排掉带区域赛、评审意味的比赛活动，除非你本来就是去参赛。
4. 排掉带身份意味的活动，例如布道师，除非你确实是那个身份。
5. 剩下不绑定学校、地区、身份的通用实践类活动，才是展示类小工具的合理选择。

选完活动后，作品名、封面、简介、包含架构图的详情内容都由 AI 按真实应用自动生成，不需要手工编造与应用不符的描述，也不要填学校、公司、职位这类敏感信息。

6. 提交后核对：详情页、重复规则、积分延迟

提交成功后，AI 会返回作品 ID 和展览馆链接。不要只看“提交成功”四个字，要打开详情页核对：标题、作者、活动栏目、Git 仓库、简介、详情文章和架构图是不是都对。

重复规则要提前知道：

• 同一个活动、同名或同仓库会被 AI 判定为重复，问你要不要确认替换。
• 确认替换是更新已有作品，同一个链接和 ID，不再发积分。
• 如果你这个月还没有作品，也没有同名作品，正常情况下不应该出现替换确认，出现了就停下来查清楚再点。

积分方面，提交成功不等于到账。AI 返回的只是“积分领取请求已提交”，真正到账要看成长中心积分明细，中间有延迟是正常的。没到账之前不要重复提交，也不要点确认替换。每月申领次数也有限制，同一个月不要为同一个作品反复提交。

7. 快速自查清单

走到哪一步卡住，就按这张清单倒着查：

• 作品目录对吗：根目录有代码和 README 吗，是不是选了缓存或构建产物目录？
• 公开仓对吗：地址和分支能被服务端拉到吗，仓里有密钥吗？
• Skill 装对吗：用的是复制按钮里的完整命令吗，Skill 名有没有被截断？
• OAuth 对吗：用的是最新链接吗，授权账号是不是自己的，跳过后作者和仓库对吗？
• 活动选对吗：状态是“可投稿”吗，有没有绑定你不具备的学校、地区、身份？
• 提交核对了吗：详情页的标题、作者、活动、仓库都对吗，有没有误点替换？
• 积分查了吗：是看积分明细，还是只看了提交成功的提示？

按这个顺序查，大部分发布失败都不是作品本身的问题，而是目录、Skill 名、活动选择这三处之一错了。