HB Mono

Kiro / VS Code 插件，帮你自动同步团队订阅的 skill 与 rule 到 ~/.kiro/，并支持一键发布自己的 skill / rule 到平台。

• 订阅端：自动把订阅到的 skill 装到 ~/.kiro/skills/、rule 装到 ~/.kiro/steering/
• 发布端：从状态栏一键发布 skill 目录或 steering md 文件到平台

安装

从 Mono 平台下载最新 hb-mono-<version>.vsix，在 Kiro 里安装：

1. 按 Ctrl+Shift+P（Mac 上是 Cmd+Shift+P）打开命令面板
2. 输入并选择 Extensions: Install from VSIX...
3. 选中下载好的 vsix 文件
4. 安装完成后在窗口右下角状态栏能看到 Mono 未登录

登录

首次使用要先登录，两种方式任选：

方式 1：点状态栏（推荐）

点右下角状态栏的 Mono 未登录 → 会自动打开浏览器跳到 SSO 登录页 → 完成企业账号授权 → 浏览器提示回跳 Kiro → 状态栏变成 Mono 已登录。

方式 2：命令面板

Ctrl+Shift+P → 输入 HB Mono: Login → 回车，后续流程与方式 1 一致。

登录成功后 accessKey 存在插件的 globalState 里，不用再次登录，除非登录态失效（此时插件会主动弹窗引导重新登录）。

日常使用

同步订阅的 skill / rule

登录后插件会自动帮你保持本地跟平台同步，你不用手工做任何事。触发时机：

• 插件启动
• 登录成功后立即拉一次
• 每次 Kiro 窗口重新获得焦点（比如从别的应用切回来）
• 每 10 分钟兜底轮询一次

同步结果会在状态栏短暂提示（更新 X，卸载 Y），失败时会弹通知让你点"打开输出面板"看详情。

若想立即触发一次，点状态栏 Mono 已登录 → 弹出菜单 → 立即同步。

发布自己的 skill 或 rule

在 Kiro 里打开 platformskills（或任何包含 skill 目录 / steering md 的仓库）作为 workspace，然后：

1. 点右下角状态栏 Mono 已登录
2. 弹出的菜单选 📤 发布 skill/rule
3. 二级列表里列出当前 workspace 下所有可发布项，前缀 [skill] 或 [rule]：
   • [skill] 是含 SKILL.md 的目录
   • [rule] 是 steering/ 目录下的顶层 .md 文件
   • 支持关键词模糊搜索
4. 选中要发布的项，插件会：
   • 从 SKILL.md frontmatter 读取 name 和 description（rule 用文件名当 name）
   • 到平台查询是否已存在同名条目，弹预览确认框告诉你这次是 [新建] 还是 [更新]
5. 确认后自动打包 → 上传 → 保存元数据，成功后弹通知

权限规则：只有 skill / rule 的 owner（首次发布者的邮箱）能更新，别人只能新建。若你尝试覆盖别人的 skill，插件会提前拦截并提示 owner 是谁。

退出登录

点状态栏 Mono 已登录 → 菜单选 退出登录。或命令面板执行 HB Mono: Logout。

常见问题

Q: 发布时提示"请先打开 platformskills 仓库再发布"？ Kiro 必须打开一个包含 skill 目录 / steering md 的 workspace，插件才能扫描到候选项。

Q: 发布时提示"未扫到任何 SKILL.md 或 steering md"？ 当前 workspace 里没有可发布的内容。skill 需要目录里含 SKILL.md，rule 需要在 steering/ 目录下的顶层 .md 文件。

Q: 发布时提示"发布超时（超过 30s）"？ 网络问题或 OSS 网关慢。检查 VPN / 内网连通性后重试。

Q: 发布时提示"无权覆盖 xxx，owner: yyy@..."？ 这个 skill / rule 是别人先发布的，你不能覆盖。要么改个 name 新建，要么让 owner 授权。

Q: 想看详细日志？ 状态栏点开 → 立即同步（或任何操作）失败时通知里都有"打开输出面板"按钮。也可以命令面板执行 HB Mono: Show Log 直接打开。

Q: 登录后没反应，浏览器授权完成但状态栏还是"未登录"？ 浏览器回跳可能被浏览器拦截。在浏览器地址栏检查是否有"是否允许打开 Kiro"的提示，允许即可。若仍无效，重新执行一次 HB Mono: Login。

命令一览

以上命令也都能通过点状态栏 Mono 图标弹出的菜单触发。