在 ClawHub 发布技能:分类、话题与待审发布的工作方式
发布不是上传完就上线:ClawHub 先校验令牌、元数据、名称、版本与文件,再把这次发布记为待审并针对该产物跑安全检查;未通过前不会出现在搜索、安装与下载里。
一次发布要过几道关
发布做的事是把一个技能文件夹或插件包,发到你在 ClawHub 上选定的所有者名下。平台先确认你的令牌有权替这个所有者发布,再校验元数据、名称、版本、文件与来源信息,然后把这版记为待审,并针对这一份产物跑自动化安全检查。校验不通过就什么都不会发布;待审中的版本不会出现在搜索、安装与下载入口,直到安全检查通过。如果检查发现恶意内容、反复失败或超时,这一版同样不会被发布。这个顺序意味着发布命令成功返回,并不等于别人已经能装到你的技能。
命令行最短路径
最简单的路径是命令行:先登录,再发布本地技能目录,给出 slug、显示名与可选的所有者。要发到组织名下就用所有者参数,不写则以当前认证用户的身份发布。发布时内容未变会跳过;新技能从 1.0.0 起步,之后每次改动自动递增补丁版本,只有需要指定版本号时才显式传版本参数。对内容目录里多个技能的情况,官方推荐用可复用的工作流文件,它会对根目录下每个直接子文件夹分别调用发布,也可以只发指定的那一个。
分类是枚举,话题是自由标签
分类决定技能出现在浏览页的哪个筛选里,话题则是选中分类之后可点的标签。两者都在发布时设置。分类必须使用官方给出的 slug 并精确匹配,大小写不同也会被拒;话题是自由文本,平台原样存储、展示时归一化,带空格或大写的写法会变成短横线小写的形式。
官方的分类清单覆盖集成、自动化、研究、开发、效率、沟通、创意、知识、智能体、运维、安全、财务、生活与其它。规则上有几条边界:一个技能最多三个分类、最多五个话题;未知的分类 slug 会让发布失败,而且预演模式不检查 slug,真正跑到注册表时才校验;其它这个分类与具体分类同时传入时会被丢弃,三个分类的上限是在丢弃之后计算的,所以同时传其它、开发、运维,最后存下的是两个分类而不是报错。重复项会被去掉而不是拒绝,且是在归一化之后比对,因此大小写不同的同一个词只算一个话题,两个上限都按去掉之后的数量算。
话题还有长度与内容限制:每个话题不超过 48 个字符,且不能包含不可见的格式字符。另外有一批被平台保留的词不能用作话题,涉及「已审核」「已认证」「官方」「推荐」「精选」这类带背书意味的说法,检查同样在归一化之后进行,所以把首字母大写也绕不过去。这类限制的意图很清楚:避免发布者用话题伪装官方身份。
元数据的三种更新语义
首次发布时没写分类,技能会被存成「其它」,只出现在其它分类下。之后的发布如果省略分类或话题参数,平台会保留已存的值;再传一次参数才会改动;传空值则是清空——分类传空会退回「其它」,话题传空会移除全部话题。还有一个容易忽略的副作用:只要传了这两个参数中的任意一个,即使文件没有变化也会触发发布,从而产生一个新的补丁版本。因此修元数据也是一次版本变更,不是无声的编辑。
已经发到「其它」的技能,最快的中途修正方式是在 ClawHub 的技能设置页直接改分类与话题,不必为改标签专门走一次命令行发布。
发布前的自查清单
按失败原因排序,最常出问题的是四类:所有者写错或令牌没有该所有者的发布权;分类 slug 拼错或用了大写;话题里带了保留词或不可见字符;以及元数据与包内声明不一致。这四类都会在发布阶段被拒,且预演模式只能覆盖一部分——它明确不校验分类 slug,所以别把预演的通过当作最终结论。
另一个常见误解是把「待审」当成「已上线」。待审期间链接可能已经生成,但搜索、安装、下载入口都还看不到它;这段时间里改文件不会影响已经提交的那份产物,要改就得再发一版。理解了这一点,发布节奏就会按「提交—等检查—确认可见」来安排,而不是提交完就去找人安装。
谁能发布、发的是什么
发布的主体是技能文件夹或插件包,而不是一次会话里的临时内容;所有者可以是个人也可以是组织。这意味着发布前要确认目录里没有把本地配置、密钥、测试数据一并带进去——安全检查针对的是这一份产物,一旦判定恶意,问题不在平台而在包里。把发布当成一次对外交付而不是一次上传,是这套流程最省事的用法。