用途:在技能 PR 已 merge 到远端仓库后,完成本机发布收尾。它不执行 git、PR、merge、push 或远端发布,merge 需调用方先行完成。
主要能力:安装或更新指定技能;清理重命名或删除的旧技能(含 .agents、.claude、.soia、.workbuddy、.codex 五处残留);执行 update 覆盖连带更新;为有 SKILL.md 但 Codex 侧缺失的技能创建相对软链;同步 SOIA 与 WorkBuddy;对账 ~/.agents/.skill-lock.json 与各 checkout 的版本。输出六列回执(技能、动作、仓库版本、装机版本、软链三处、结果)。
使用方式:先安装依赖:npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-skill-release -y。然后运行:python3 skills/soia-dev-skill-release/scripts/release_skills.py --repo <owner/name> --skills <skill-a,skill-b> --removed <legacy-skill> --dry-run。复核 dry-run 后移除 --dry-run 执行。默认面向 claude-code,codex,可用 --agents 覆盖;版本核对默认用约定本地 checkout,可用 --repo-dir <repo-path> 覆盖。
依赖:npx skills(强依赖,缺失则停止并报告失败步骤)、soia-dev-sync-skills(强依赖,需先安装)、Python 3(强依赖)。
限制:只做 merge 后本机收尾;任一步失败即停止并报告已到达步骤;--dry-run 不执行命令或写文件,只输出计划回执。按 DATA_STORAGE_SPEC.md,仅读写各 AI 技能安装目录及 ~/.agents/.skill-lock.json,不读取或保存凭据、私有配置、缓存或中间文件。