技能介绍

解决什么问题

在 Agent 中接入多个 wm-* 技能与 role-* 场景时，容易出现版本漂移、鉴权重复试错、Role 被误当作可执行技能、本地凭证混入技能包等问题。SkillHub 管家 把这些运维动作收拢为一个入口，负责发现远端 catalog、安装/升级官方包、验收 frontmatter 与 sidecar，并把业务请求路由到正确的 Role 或子技能。

如何工作

统一入口：以 wm.sh discover / wm.sh run 作为执行面，避免 Agent 手搓 curl、OAuth 或反馈 URL。
安装与升级：优先使用官方 pack / catalog 路径，写入 ~/.winmale/ 下的凭证、token 缓存与 workspace 镜像，升级时保留用户态文件并备份旧包。
路由与验收：按四个场景 Role（个股核对、投研管家、公司深读、金融分析师）和 L1 技能匹配请求；每次安装/更新都检查 SKILL.md frontmatter、_skillhub_meta.json 与 agents/openai.yaml。
错误与反馈：失败时给出可读原因和落地页，按约定提交 POST /v1/feedback 或 feedback.create，不盲目重试、不伪造已解决。

适用边界

适合需要管理 Winmale SkillHub 中官方 skill / role 的工程师；不适合绕过平台接口调用第三方数据，也不适合在已有凭证的机器上重复使用含密钥的首装话术。

截图预览

使用场景

在 Cursor 或 Claude Code 中首次接入 Winmale 技能时，统一安装官方 pack 并验收 frontmatter、sidecar 与中文展示名。
本机已有多个 wm-* 技能需要升级时，对比 catalog semver，覆盖官方包并保留 ~/.winmale/ 下的凭证、缓存与 workspace。
用户要求研究一家公司并输出投资备忘时，把请求路由到公司深读专家 Role，而不是只调用公司卡片或行情快照。
遇到 SCOPE_DENIED、额度耗尽或密钥失效时，按错误恢复流程给出可读原因、落地页和 feedback 上报入口。