用途:在 Claude Code、Codex、WorkBuddy 三个宿主上安装或更新 SOIA 开源技能,覆盖从全量初装到单域更新的场景,也可只做只读状态检查。
主要能力:按宿主(全部可用宿主或指定单一宿主)与粒度(全 8 域、单个域插件、由单个技能反查所属域)组合出安装/更新矩阵;逐域执行、任一域失败记录并继续;更新后生成域级回执表。SOIA 以“域插件”为最小交付单元,更新单个技能在插件模式下等价于更新整个域插件,脚本会说明是哪个技能触发。
使用方式:先只读检查 python3 scripts/inspect_soia_plugins.py --json,再展示计划等确认。Claude Code:claude plugin marketplace add soia-team/soia-open-skills,未装用 claude plugin install <域名>@soia,已装用 claude plugin update <域名>@soia。Codex 无 update 命令,需先刷新市场缓存 rm -rf ~/.codex/.tmp/marketplaces/soia,再 codex plugin marketplace add soia-team/soia-open-skills,未装 codex plugin add <域名>@soia,已装先 remove 再 add。WorkBuddy 用 install_workbuddy_experts.py,可先 --dry-run,完成后须提示重启。仅装单个技能需改用 npx skills add 路线,且与插件路线互斥。
适用场景:全量或指定宿主初装、单域插件更新、查看安装状态。
限制:不负责卸载与禁用,不覆盖私有技能仓与发布收尾;claude/codex CLI、WorkBuddy、Python 3 缺失时按宿主跳过并给出替代建议,失败不自动回滚。