baiyin-skills-upgrade

检查并更新本地 baiyin skills 到 SkillHub 中的最新版本。 用于 `skill/` 目录下的百音技能在执行前做远程版本检查、按需升级、 回滚失败更新，并在升级完成后继续原始技能任务。

Security Scan

The instructions largely match the stated purpose (updating local baiyin skills), but the SKILL.md reads an environment variable it doesn't declare and leaves unspecified where it writes persistent configuration/backups and how it validates target paths — these gaps grant the skill broad discretion and merit caution.

Purpose & Capability

The skill's name/description (update local baiyin skills from SkillHub) aligns with the runtime instructions: enumerating skill/ dirs, comparing _meta.json, fetching remote package, backing up, replacing files, validating, and rolling back. It explicitly excludes self-upgrade and limits targets to a named list, which is coherent.

Instruction Scope

SKILL.md instructs the agent to read/write skill directories, create backups, delete/restore directories, and use host-provided SkillHub query capabilities — all expected. However, it (a) reads the environment variable BAIYIN_SKILL_AUTO_UPGRADE even though no required env vars are declared in metadata, (b) instructs writing configuration entries (auto-upgrade preferences, 'never ask again', last-upgrade records) but does not specify file paths or storage locations, and (c) lacks explicit defenses against path traversal or symlink attacks when operating on <target_skill_dir>. These omissions widen the agent's discretion beyond the documented metadata and could result in writes outside intended locations if the runtime context is hostile or misconfigured.

Install Mechanism

Instruction-only skill with no install spec and no code files — lowest install risk. It relies on the host environment's existing SkillHub query tools rather than downloading code, which reduces supply-chain risk.

Credentials

Metadata lists no required env vars, but SKILL.md explicitly reads BAIYIN_SKILL_AUTO_UPGRADE and also prefers '宿主环境已有的 baiyin skill 配置' (unspecified). The skill will write persistent user choices (auto-upgrade, 'never ask again') yet doesn't declare or constrain where those are stored. Requesting/using environment or config data without declaring it is an incoherence and increases surprise/risk.

Persistence & Privilege

always:false (good). The skill is allowed to run autonomously by default (normal). It will create backups, write upgrade records and preference flags, and delete backup dirs on success — all reasonable for an upgrader, but because the SKILL.md doesn't state exact config/record file locations or naming conventions, the persistence surface is unclear. Combined with file-system write/delete operations, that ambiguity should be resolved before trusting automatic mode.

What to consider before installing

This skill appears to do what it says (check and upgrade local baiyin skills), but there are a few unclear and potentially risky details you should confirm before installing or enabling automatic upgrades: - Confirm where the skill will store persistent settings and records (what file paths or config files it will write). The SKILL.md says it will write auto-upgrade preferences and 'never ask again' flags but doesn't specify locations. - The SKILL.md reads the environment variable BAIYIN_SKILL_AUTO_UPGRADE but the skill metadata lists no required env vars — decide whether you will set that env var and understand its effect. - Ensure the runtime will provide a trusted SkillHub query capability; the instructions explicitly forbid inventing SkillHub URLs, so verify the host's integration exists and is authenticated securely. - Review how <target_skill_dir> is resolved in your environment. Ask the maintainer (or review the implementation if present) whether path sanitization is applied and how symlinks or unexpected directory layouts are handled to avoid accidental writes outside skill/. - Because the skill performs backups, deletes, and rollbacks, run it first in a safe test workspace or with manual confirmation enabled (do not enable auto-upgrade) so you can verify behavior. - If you plan to allow automatic upgrades, require that the location used for storing config and backups is restricted to a location you control and inspect (or adjust SKILL.md to name explicit paths). If these questions cannot be answered, treat automatic mode as risky and prefer manual/ask-on-each-update operation.

检查并更新本地 skill/ 目录下的 baiyin skills。

适用范围：

• skill/baiyin-video-skill
• skill/baiyin-image-generate-skill
• skill/baiyin-music-generate
• skill/baiyin-voice-generate-skill
• skill/baiyin-cover-sing-skill
• skill/baiyin-cover-train-skill
• skill/baiyin-digital-human-lipsync
• skill/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 读取以下字段：

• ownerId
• slug
• version
• publishedAt

要求：

• ownerId 必须是 baiyin
• slug 必须与目录名一致
• 比较远程版本时，优先比较 publishedAt
• 若 publishedAt 相同，再比较 version

如果本地元数据损坏、缺字段或无法解析，告诉用户：

当前 skill 的本地元数据不完整，跳过自动升级，继续执行当前任务。

第 3 步：查询 SkillHub 远程版本

使用当前宿主环境已有的 SkillHub 查询能力读取远程 skill 元数据。

查询输入：

• ownerId
• slug

期望取得远程结果中的至少这些字段：

• version
• publishedAt
• files 或完整 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 的延后提醒状态
• 写入最近一次升级记录
• 删除本次备份目录

可记录的信息：

• slug
• oldVersion
• newVersion
• oldPublishedAt
• newPublishedAt
• upgradedAt

第 11 步：展示变更摘要

仅在确实完成升级后，向用户输出简短摘要：

百音技能 <slug> 已更新：v{old} -> v{new}

已继续执行当前任务。

如果远程返回了更新说明，可补充 3-5 条高信号变更；否则不要编造更新内容。

第 12 步：继续原任务

升级流程完成后，回到原始 baiyin skill 的主流程继续执行。

要求：

• 不要让用户重复输入刚才已经给过的业务参数
• 不要在升级完成后停住等待，除非原任务本身需要用户继续选择
• 如果升级前已经进入某个交互步骤，升级后从该步骤继续

---

独立使用

当用户直接调用 /baiyin-skills-upgrade 时：

1. 先枚举 skill/ 下全部 baiyin skills
2. 逐个读取 _meta.json
3. 逐个查询远程版本
4. 列出：
   • 可升级的 skill
   • 已是最新的 skill
   • 无法检查的 skill
5. 如果存在可升级项，再询问用户是否批量升级

批量升级要求：

• 默认只升级有更新的项
• 某个 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 时，若远程无更新，应静默继续原任务