- name
- baiyin-skills-upgrade
- version
- 1.0.0
- description
- |
- allowed-tools
/baiyin-skills-upgrade
检查并更新本地 skill/ 目录下的 baiyin skills。
适用范围：
skill/baiyin-video-skillskill/baiyin-image-generate-skillskill/baiyin-music-generateskill/baiyin-voice-generate-skillskill/baiyin-cover-sing-skillskill/baiyin-cover-train-skillskill/baiyin-digital-human-lipsyncskill/baiyin-track-separation-skill
不处理当前升级 skill 自身目录 skill/baiyin-upgrade。
内联升级流程
当其他 baiyin skill 的启动前导检测到远程版本更新时，引用本节。
第 1 步：识别当前目标 skill
先确定当前要升级的是哪个本地 skill 目录。
规则：
- 如果当前 skill 已明确知道自己的目录，直接使用该目录
- 否则从当前执行上下文中定位
skill/<slug>/SKILL.md - 目标目录必须位于项目根目录下的
skill/中 - 如果目标目录是
skill/baiyin-upgrade，直接跳过，不要自升级
目标目录确认后，读取本地元数据：
LOCAL_META="<target_skill_dir>/_meta.json"
LOCAL_SKILL_MD="<target_skill_dir>/SKILL.md"若 _meta.json 不存在，则视为无法进行远程比对，只继续当前 skill，不做升级。
第 2 步：读取本地版本信息
从 _meta.json 读取以下字段：
ownerIdslugversionpublishedAt
要求：
ownerId必须是baiyinslug必须与目录名一致- 比较远程版本时，优先比较
publishedAt - 若
publishedAt相同，再比较version
如果本地元数据损坏、缺字段或无法解析，告诉用户：
当前 skill 的本地元数据不完整，跳过自动升级，继续执行当前任务。
第 3 步：查询 SkillHub 远程版本
使用当前宿主环境已有的 SkillHub 查询能力读取远程 skill 元数据。
查询输入：
ownerIdslug
期望取得远程结果中的至少这些字段：
versionpublishedAtfiles或完整 skill 包内容
要求：
- 不要自行猜测其他
ownerId - 不要把别的 skill 的返回结果套用到当前 skill
- 若当前环境已有 SkillHub 查询脚本、MCP、CLI 或 API 封装，优先使用现成能力
- 只有在宿主环境明确提供 SkillHub HTTP 接口说明时，才直接请求 HTTP；不要凭空编造 URL
如果查不到远程结果：
- 静默放弃升级
- 继续当前 skill 原任务
第 4 步：判断是否需要升级
仅在以下任一条件满足时才升级：
- 远程
publishedAt大于本地publishedAt - 远程
publishedAt相同，但远程version高于本地version
如果远程没有更新：
- 直接继续当前 skill 原任务
- 不额外提示“已是最新版本”，除非用户显式调用
/baiyin-skills-upgrade
第 5 步：询问用户或自动升级
首先检查是否启用 baiyin skill 自动升级：
- 优先读取宿主环境已有的 baiyin skill 配置
- 如无专门配置，可读取环境变量
BAIYIN_SKILL_AUTO_UPGRADE
如果自动升级开启：
- 记录：
Auto-upgrading baiyin skill <slug> v{old} -> v{new}... - 跳过用户确认，直接进入第 6 步
否则，使用 AskUserQuestion 询问：
- 问题：
百音技能 <slug> 有新版本（当前 v{old}，最新 v{new}），现在更新吗？ - 选项：
- Yes, upgrade now - Always keep baiyin skills up to date - Not now - Never ask again
分支处理：
- 选择
Yes, upgrade now：进入第 6 步 - 选择
Always keep baiyin skills up to date：
- 写入自动升级配置 - 提示 已开启 baiyin skills 自动升级。 - 进入第 6 步
- 选择
Not now：
- 写入本地延后标记 - 本次不再重复提醒 - 继续当前 skill 原任务
- 选择
Never ask again：
- 写入关闭更新检查配置 - 继续当前 skill 原任务
第 6 步：备份本地 skill
升级前先备份当前目录：
BACKUP_DIR="<target_skill_dir>.bak"规则：
- 若已存在旧备份目录，先删除该旧备份，再创建新备份
- 备份内容至少包含：
- SKILL.md - _meta.json - references/ - scripts/ - assets/ - 其他当前 skill 目录内文件
第 7 步：拉取并覆盖最新 skill 内容
从 SkillHub 取回远程 skill 的完整内容后，覆盖本地目标目录。
覆盖原则：
- 只更新当前
<target_skill_dir>，不要误改其他 skill - 远程若包含
SKILL.md、_meta.json、references/、scripts/、assets/，按目录结构完整覆盖 - 远程若删除了某些旧文件，本地也应同步删除，避免保留陈旧资源
- 不要改动目标 skill 目录外的任何内容
如果宿主环境返回的是压缩包、文件列表或对象存储下载地址，都按“还原为 skill 目录完整快照”的结果处理。
第 8 步：校验更新结果
覆盖完成后至少检查：
<target_skill_dir>/SKILL.md存在且非空<target_skill_dir>/_meta.json存在且可解析- 新
_meta.json的ownerId仍为baiyin - 新
_meta.json的slug与目标目录匹配 - 新版本信息确实等于远程版本
如果当前 skill 自带 scripts/：
- 仅做轻量存在性检查
- 不要因为未知外部依赖而主动跑高风险脚本
第 9 步：失败回滚
在以下任一情况发生时，必须回滚：
- 远程文件获取失败
- 覆盖中断
SKILL.md丢失或为空_meta.json不可解析- 新
slug或ownerId与目标 skill 不匹配
回滚动作：
- 删除当前损坏的新目录
- 用备份目录恢复原目录
回滚后提示用户：
百音技能 <slug> 自动更新失败，已恢复到本地旧版本。
然后继续当前 skill 原任务。
第 10 步：清理升级标记
升级成功后：
- 清理该 skill 的延后提醒状态
- 写入最近一次升级记录
- 删除本次备份目录
可记录的信息：
slugoldVersionnewVersionoldPublishedAtnewPublishedAtupgradedAt
第 11 步：展示变更摘要
仅在确实完成升级后，向用户输出简短摘要：
百音技能 <slug> 已更新：v{old} -> v{new}
已继续执行当前任务。如果远程返回了更新说明，可补充 3-5 条高信号变更；否则不要编造更新内容。
第 12 步：继续原任务
升级流程完成后，回到原始 baiyin skill 的主流程继续执行。
要求：
- 不要让用户重复输入刚才已经给过的业务参数
- 不要在升级完成后停住等待，除非原任务本身需要用户继续选择
- 如果升级前已经进入某个交互步骤，升级后从该步骤继续
独立使用
当用户直接调用 /baiyin-skills-upgrade 时：
- 先枚举
skill/下全部 baiyin skills - 逐个读取
_meta.json - 逐个查询远程版本
- 列出：
- 可升级的 skill - 已是最新的 skill - 无法检查的 skill
- 如果存在可升级项，再询问用户是否批量升级
批量升级要求：
- 默认只升级有更新的项
- 某个 skill 升级失败时，仅回滚该 skill
- 不影响其他 skill 继续升级
- 最终输出逐项结果摘要
批量模式输出格式：
百音 skills 检查完成
可升级：
- baiyin-video-skill: v1.0.0 -> v1.1.0
- baiyin-image-generate-skill: v1.0 -> v1.1
已最新：
- baiyin-music-generate
检查失败：
- baiyin-track-separation-skill回复规则
- 不要编造 SkillHub 接口地址、认证方式或返回结构
- 不要在无法确认远程内容时硬做覆盖
- 不要升级
skill/baiyin-upgrade自身 - 不要改动
skill/目录外文件 - 不要在升级失败后保留半更新状态
- 用户未显式调用升级 skill 时，若远程无更新，应静默继续原任务