SkillHub Hello 示例

要解决的问题

把一个 agent skill 做出来，只是第一步。真正麻烦的是后面的事：这个包应该放在哪个 registry？怎么命名、怎么定版本，才不会和已有的 skill 撞车？团队里其他人怎么找到它？审核谁来做、怎么留痕？三个月后要更新，版本号怎么动才不会把正在调用的人搞挂？

这些都不是模型能力的问题，而是打包和治理的问题。SkillHub 就是用来填这个坑的：一个可以自托管的、面向企业内部的 skill 注册中心。而这个 skill 本身，是一个刻意保持很小的示例包，用来把整套流程演示清楚——让你看到一份可发布的 skill 包长什么样，以及发布前后哪些地方最容易出问题。

它是怎么工作的

这个示例的核心价值不是执行某个具体任务，而是解释机制。包结构被有意简化到只剩必要部分：

• SKILL.md 位于 zip 根目录，包含 frontmatter（name、description、version）和 Markdown 正文
• 配套 README 与参考资料，让包本身是自解释的，而不是一个黑盒
• 一个命名空间坐标示例，例如 @global/skillhub-hello

它覆盖三条主要路径：

• 打包——zip -r ../skillhub-hello.zip SKILL.md README.md references，或者没有 zip 时用 jar cMf。根目录层级是关键，嵌套一层就会导致解析失败。
• 发布——Web UI 流程是登录 → 选 namespace → 上传 zip → 核对解析出的名称/摘要/版本 → 提交审核；兼容 CLI 则是 npx clawhub publish ./skillhub-hello --slug skillhub-hello --version 1.0.0
• 元数据语义——name 决定 skill slug，description 是摘要来源，version 直接成为 skill 的版本号。所以改版本要动的是 SKILL.md 里的 version 字段，不是提交时临时指定。

同时也说明了 registry 侧的能力：命名空间与 RBAC、搜索、评分收藏订阅、审核治理、审计日志、安全扫描，以及对 OpenSkills 目录约定和 ClawHub CLI 的兼容层。

适用边界

这个示例不适合直接当作生产级业务 skill 来用。它不会帮你生成代码审查、文档抽取或数据分析这类专用能力。

它也不会提供真实的企业 registry 地址、访问 token、内部命名空间或私有部署配置。涉及这些值时，示例只会给出占位写法（比如 @global/skillhub-hello），并明确提醒替换成你自己的环境。对于文档和仓库中尚未确认的未来特性，示例的态度是不推测、不编造。

它真正想让你提前避开的坑包括：SKILL.md 没落在 zip 根目录、version 与已有版本重复导致发布失败、skill 发布后在搜索页搜不到（通常是审核未通过或可见性限制）、以及 CLI 登录失败（多半是 registry 地址、token 或网络配置的问题）。