用途
oracle-soul-sync-update 是一个一体化技能，把 /soul-sync、/calibrate 和 /update 三个动作合并为一条命令，用于检查并更新 Oracle 系列技能工具链，使其与最新版本保持同步。
主要能力
- 读取本地已安装版本：从 ~/.claude/skills/VERSION.md 读取，若文件缺失则回退到 arra-oracle-skills --version。
- 查询最新版本：通过 GitHub API 获取仓库 Soul-Brews-Studio/arra-oracle-skills-cli 的全部标签，区分 stable（排除 alpha/beta/rc）与 alpha。
- 版本比对：采用 CalVer（v{YY}.{M}.{D}，首位数字 ≥ 25）与旧版 SemVer（v3.x.x）两种格式。CalVer 标签直接编码发布日期，因此以“落后 N 天”而非语义化版本差距来判断陈旧程度；旧 SemVer 标签会被标记为需要迁移。
- 同日比较：当两个标签属于同一日历日时，改用 GitHub release 的 publishedAt 时间戳作为判断依据，避免因 semver 排序（预发布 < 稳定版）而误判 alpha 为陈旧。
- 执行同步：版本不一致或使用 --cleanup 时，通过 bunx 从 GitHub 指定标签安装；--cleanup 会先卸载再重装。
- 验证同步：重启后运行 arra-oracle-skills list -g | head -5 检查版本是否匹配。
使用方式
命令形式：
- /oracle-soul-sync-update：检查并更新到最新 stable。
- /oracle-soul-sync-update --alpha：检查并更新到最新 alpha（开发轨道）。
- /oracle-soul-sync-update --check：仅检查，不更新。
- /oracle-soul-sync-update --cleanup：先卸载，再重新安装。
默认轨道为 stable，只有显式传入 --alpha 才切换到开发轨道。
同步命令（普通）：
~/.bun/bin/bunx --bun arra-oracle-skills@github:Soul-Brews-Studio/arra-oracle-skills-cli#$LATEST install -g -y
带 --cleanup 时：
arra-oracle-skills uninstall -g -y && ~/.bun/bin/bunx --bun arra-oracle-skills@github:Soul-Brews-Studio/arra-oracle-skills-cli#$LATEST install -g -y
更新后需重启 Claude Code 以加载同步后的技能。
查看最近变更：
gh release list --repo Soul-Brews-Studio/arra-oracle-skills-cli --limit 5
或查看提交：
gh api repos/Soul-Brews-Studio/arra-oracle-skills-cli/commits --jq '.[0:5] | .[] | "(.sha[0:7]) (.commit.message | split("\n")[0])"'
技能管理已迁移到 /oracle，可使用 /oracle install、/oracle remove、/oracle profile、/oracle skills。
适用场景
- 在运行 /awaken 之前，先确保技能版本为最新。
- 需要检查当前安装是否落后于最新发布时。
- 需要切换到 alpha 开发轨道进行测试时。
- 需要彻底清理旧技能并重新安装时。
限制与注意事项
- 应在 /awaken 之前运行，而不是在 /awaken 过程中运行。/awaken 向导 v2 会在 Phase 0（系统检查）检查技能版本；若已过时，应先运行本技能、重启 Claude Code，再运行 /awaken。中途运行会因需要重启而打断向导流程。
- 更新后必须重启 Claude Code 才能加载新技能。
- 同日比较依赖 GitHub API 获取 release 时间戳；若 API 不可达，则仅报告同日不同标签，需人工核实。
- 版本比对依赖 gh 命令与 jq 等工具。
- 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。