技能介绍

解决的问题

在团队协作环境中，WorkBuddy 的技能包通常托管在内部 CNB 仓库。手动安装需要开发者熟悉仓库结构、处理鉴权 token、正确解压归档文件，并确保路径正确落盘。整个过程涉及多个易错环节，尤其当团队规模扩大、技能包数量增加时，手动操作容易产生不一致。

这个技能把安装流程自动化，让开发者用一句话就能完成"从 CNB 仓库安装技能包"的操作。

工作原理

鉴权策略：连接器优先、登录态回退

技能采用双层鉴权机制。优先尝试使用 WorkBuddy 已连接的 CNB 连接器（cnb-api 或 cnb-woa），这些连接器会自动携带鉴权信息，用户无需关心 token。若无可用连接器，技能回退到本地登录态，通过 scripts/install.sh（macOS/Linux）或 scripts/install.ps1（Windows）脚本读取 ~/.cnb/token 或环境变量 CNB_TOKEN 完成鉴权。

安装流程

解析参数：从用户语句提取必填的技能包名，可选分支默认为 main
拉取归档：连接器路径直接调用仓库归档接口获取 .tgz 文件；脚本路径则自动处理 token 和下载
解包与落盘：校验 gzip 魔数（前 2 字节 1f 8b），解压到临时目录，再移动到 ~/.workbuddy/skills/
校验反馈：确认 SKILL.md 存在，提示用户新开对话后技能自动加载

关键约束处理

技能内置了多个实测约束的正确处理方式。CNB 归档接口实时生成 gzip 包，无需手工打包；tar 包保留 skills/ 路径前缀，因此必须先解到临时目录再移动，避免多套一层目录；路径不存在时接口返回 HTTP 500 和 JSON 而非 404，技能通过 gzip 魔数校验避免把错误 JSON 当归档解压；公开仓库也需要 Bearer token，技能统一通过连接器或 cnb login 集中托管。

适用边界与注意点

技能默认仓库固定为 playable/workbuddy/playable-skill，可通过环境变量覆盖：CNB_SKILL_REPO、CNB_SKILL_BRANCH、CNB_API_ENDPOINT。技能包内不应包含密钥等机密信息，调用内部 API 时应通过环境变量传递凭证。cnb CLI 的 get-archive 命令因强制返回 JSON 格式不可用，技能已绕过此限制使用直连 HTTP。安装完成后需新开一个 WorkBuddy 对话，技能才会按触发词自动加载。