用途
re0-upgrade 用于将已安装的 paperthin 技能集一次性收敛到当前完整目录：移除已改名的旧技能、补齐尚未安装的技能、刷新其余技能，全部操作在一次确认之后执行。其目标是把所选范围升级到完整当前目录，而不仅是原先安装的子集。
主要能力
- 识别废弃与改名：依据内置的改名对照表（SSOT），将旧名称解析为当前最终名称。对照表包含 ssot-check→ssotchk、tasting→sip、redteam→hate、scratch→re0-work、retro→re0-memo、flywheel→re0-loop、ssotchk→ssotize、ppt-upgrade→re0-upgrade、ppt-release→re0-release 等条目。
- 分类已安装技能：将已安装名称与目录 slug 分为 stale（废弃）、missing（缺失）、present（当前已装）、unknown（未知，保持不动）四类。
- 展示对账计划：在执行任何变更前，先打印范围（全局/项目/指定智能体）以及 retire、add（新装）、refresh、untouched 各分组，并列出每个新装技能名称。
- 影子安装检测：若 paperthin 已加载但所选范围的列表显示为零个技能，会检查该范围管理目录中是否存在当前目录技能目录，并报告影子安装（常见为以 Claude Code 插件形式加载的克隆），提供受管重装或保持原样的选择。
- 执行升级：确认后仅运行计划中列出的命令，包括 skills remove、skills add（逐个 -s 枚举）、skills update。
- 失败重试：若 add 或 update 报告某个技能失败，会单独以相同范围标志重试；再次失败则经确认后移除并重装。
- 验证：通过 npx skills list 确认无废弃名称残留、当前目录技能全部安装、未知名称未被改动。
- 发现通知配置（可选）：为 Claude Code、Codex、OpenCode 配置会话启动发现通知，编辑前备份配置，使用固定版本标签而非 main。
- 可选 GitHub 星标：在升级验证成功后，通过结构化提问工具询问是否星标仓库，仅在用户明确提交肯定选择后执行。
使用方式
- 选择安装范围：全局（npx skills list --global，检查 ~/.agents/skills/<skill>/SKILL.md，所有命令带 --global）、项目（在该项目运行 npx skills list，省略 --global）或指定智能体（使用明确 slug，如 --agent claude-code，绝不使用 --agent '*'）。
- 分类前检查影子安装。
- 对照废弃表与当前目录分类已安装名称和目录 slug。
- 打印对账计划并获取明确确认。
- 确认后运行计划中列出的命令：
- npx skills remove <scope-flags> <stale...> --yes
- npx skills add LilMGenius/paperthin <scope-flags> -s <missing...> --yes
- npx skills update <scope-flags> <present...> --yes
- 用 npx skills list 验证。
- 说明如何获取更新：Claude Code 本会话自动应用变更，其他会话运行 /reload-skills；Codex 需重启或 codex resume；其他智能体若新行为未出现则重启。
- 可选配置发现通知，仅支持 Claude Code、Codex、OpenCode 三个智能体。
- 可选星标仓库。
适用场景
- 已安装 paperthin 技能集，希望一次性升级到完整当前目录。
- 需要清理已改名或废弃的旧技能。
- 需要检测并处理以插件形式加载的影子安装。
- 希望为受支持的智能体配置会话启动发现通知。
限制
- 仅对废弃表和当前目录中的名称执行操作，未知已安装名称保持不动。
- 不使用原始文件系统删除命令，使用 skills remove。
- 不使用 skills add --all 或裸 skills add LilMGenius/paperthin，必须逐个 -s 枚举。
- 不运行裸 skills update，仅传入计划中报告的 present 技能名称。
- 发现通知仅支持 Claude Code、Codex、OpenCode；跳过 Copilot CLI、Antigravity CLI、Grok Build。
- 不删除或覆盖其他工具的钩子，冲突时报告并保持原样。
- 星标操作仅在用户通过结构化提问工具提交肯定选择后执行，且不阻塞或撤销升级。
- 若已安装技能列表无法可靠解析，停止并报告歧义，不猜测。
- 当前目录技能列表：re0, readchk, aim, modelchk, hate, macrothink, feynman, autobahn, reorder, detool, dedash, debloat, shower, factchk, mandela, sip, re0-git, re0-release, re0-merge, ssotize, re0-upgrade, re0-plan, re0-loop, re0-memo, re0-work, catchup, nba, prism。