已安装 paperthin skills 落后于当前目录时…

将某个安装范围中的已安装 paperthin skills 对齐到当前完整 catalog，先展示并确认完整变更计划再执行。

适用场景

解决思路

1. 目标：将所选范围升级到完整当前 catalog，而不是仅原安装子集；确认前展示 reconciliation plan 并点名每个 new-to-user skill；偏好更窄安装的用户可以拒绝。
2. 退役重命名：按发布顺序维护 rename SSOT；未来新增 renames 追加此处；将链解析到最终 current names；`ssot-check` 行是用户确认的 pre-v0.2.0 历史，force-push 后在 git 中不可验证，不要编造日期或 tag。
3. 使用 Deprecations 表：`ssot-check`→`ssotchk`（pre-v0.2.0 history, force-pushed, user-confirmed）；`tasting`→`sip`（0.6.0）；`redteam`→`hate`（0.7.0）；`scratch`→`re0-work`（0.8.2）；`retro`→`re0-memo`（0.11.0）；`flywheel`→`re0-loop`（0.11.0）；`ssotchk`→`ssotize`（0.11.0）；`ppt-upgrade`→`re0-upgrade`（0.11.0）；`ppt-release`→`re0-release`（0.11.0）。
4. Current catalog：安装以下每个 skill，除非确认时拒绝：`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`。使用该 roster 在 `npx skills list` 和已安装目录中区分 current 与 unknown names。
5. Workflow 1：选择整个运行的一个安装范围；若未指定则询问。范围错误会读取错误的安装位置。
6. Global：使用 `npx skills list --global`，检查 `~/.agents/skills/<skill>/SKILL.md`，并在每个 `remove`、`add`、`update` 上传 `--global`。
7. Project：从该项目运行 `npx skills list`，如存在则检查其已安装 skill 目录，省略 `--global`。
8. Exact agent：使用显式 slugs 如 `--agent claude-code`，绝不使用 `--agent '*'`，包括 removals；没有 agent scoping 时使用 global 或 project scope。
9. Workflow 2：分类前检查 shadow install。如果 paperthin 已加载但所选 scope 的 list 报告零个 paperthin skills，不要断定整个 catalog 缺失；检查该 scope 管理足迹中是否有任何 Current catalog 目录（全局 `~/.agents/skills/`，例如 `~/.agents/skills/re0`）。
10. 若目录存在：重新检查 scope 并重试 list（全局 `npx skills list --global`）。若仍与足迹矛盾，报告 CLI 失败并停止；读取不稳定不等于空安装。
11. 若目录不存在且 paperthin 已加载：报告 shadow install，通常是作为 Claude Code plugin 加载的 clone（`/paperthin:<skill>`）。CLI 无法看到、更新或删除它。提供通过 `npx skills add` 在所选 scope 进行 managed reinstall（推荐用于未来升级和 discovery notices），或保持 clone 不变且 CLI 不可见，每次升级重新标记。等待用户选择；绝不自行删除 clone 或安装第二份副本。
12. 一旦 managed，对照 Deprecations 和 Current catalog 分类已安装 names 和 directory slugs：`stale`: deprecated name 或 slug；`missing`: 解析 rename chains 后未安装的 current name；已安装的 replacement 算 present 而非 missing，因此只 retire stale name，不再次 add replacement；`present`: current、已安装、非 deprecated names；`unknown`: 既非 current 也非 deprecated，保持不动。
13. Workflow 3：变更前打印 reconciliation plan：先 scope（global / project / exact agent），然后 retire: stale names；add (new to you): 完整列出 missing catalog names，包括 retired names 的 replacements；refresh: present names；untouched: unknown names；wire discovery notice: 在步骤 9 要接入的 present agents，或拒绝则 `none`。
14. Workflow 4：在 removal、installation、update 或 hook wiring 前获得明确确认。推荐 full-catalog convergence 和 discovery wiring；用户可批准计划、拒绝整个运行，或只拒绝 wiring。批准前不得变更。
15. Workflow 5：确认后只运行计划中指定的命令，并使用步骤 1 的 scope flags：retire group 用 `npx skills remove <scope-flags> <stale...> --yes`；add group 用 `npx skills add LilMGenius/paperthin <scope-flags> -s <missing...> --yes`，每个 catalog name 用自己的 `-s` 枚举；refresh group 用 `npx skills update <scope-flags> <present...> --yes`。
16. Workflow 6：如果 `npx skills add` 或 `npx skills update` 报告某个 skill 失败，用相同 scope flags 单独重试该 skill。若再次失败，按 skill name 获得确认，然后用相同 `skills remove`/`skills add -s` 形式 remove 并 reinstall。
17. Workflow 7：用 `npx skills list` 验证：无 deprecated name 残留，每个 Current catalog skill 都已安装，unknown names 未被触碰，任何走 retry/fallback 路径的 skill 确实存在。
18. Workflow 8：解释如何拾取更新：Claude Code 在本会话自动应用更改后的 `SKILL.md` 内容；共享该安装的其他正在运行的 Claude Code 会话运行 `/reload-skills`。Codex 没有会话内 reload：重启它（或 `codex resume`）。其他 agents 如果新行为未出现则重启。
19. Workflow 9：成功升级验证后，除非拒绝，为 present agents 接入 session-start discovery notice。编辑前备份每个 config。
20. 从 `https://raw.githubusercontent.com/LilMGenius/paperthin/v<installed-version>/scripts/<file>` 获取 `catalog.cjs` 和 `session-check.cjs`，仅 OpenCode 额外获取 `opencode-discovery.js`，放入 `~/.re0/`。使用固定的已安装 release tag，绝不用 `main`。
21. Claude Code (`~/.claude/settings.json`) 和 Codex (`~/.codex/config.toml`)：仅当尚没有任何以任何路径运行 `session-check.cjs` 的 `SessionStart` command 时，添加运行 `~/.re0/session-check.cjs` 的 command。保留 rename 前的 wiring 在其自己的 runtime 上；重复会 double-fire。
22. OpenCode (`opencode.json`/`opencode.jsonc`)：仅当没有任何以任何路径存在的 `opencode-discovery.js` entry 时，将 `~/.re0/opencode-discovery.js` 添加到 `plugin`。
23. 跳过 Copilot CLI（忽略 session-start hook 输出）、Antigravity CLI（无 session-start event）、Grok Build（hook 格式未验证）。只接入三个受支持 agents。
24. 绝不删除或覆盖另一个工具的 hook。报告冲突并保持不动。报告接入了什么、哪些文件更改、如何取消接入。
25. Workflow 10 可选 GitHub star：成功升级验证并报告 upgrade/discovery 结果后，使用宿主的结构化 user-question 工具一次询问「是否用已认证的 gh 账号给 LilMGenius/paperthin 加星？」。提供「Star repository」，然后「Skip」；说明 star 可选，跳过不改变升级。
26. 等待提交选择；对于待处理问题，让出给宿主的输入流程并在答案时恢复。只有提交的「Star repository」授权该操作，绝不因 preselection、silence、upgrade approval 或 install `--yes`。
27. 如果工具不可用、运行无人值守，或结果不是该选择（包括 skip、cancellation、session closure、timeout 或 free text），跳过。不重复询问、不在聊天中替代、不解析同意、不用备用输入方式。
28. 批准后，检查 `gh auth status --hostname github.com`。如果 `gh` 缺失或 auth 失败，跳过并提供 `gh auth login --hostname github.com` 和 star command 供用户运行。绝不登录、读取 tokens 或切换 API clients。拒绝时，既不提供命令也不提供 login nudge。
29. 有批准且 auth 可用时，运行一次 `gh api --hostname github.com -X PUT user/starred/LilMGenius/paperthin --silent`。`--silent` 只隐藏响应体。命令成功时报告「star is set」，不是「newly added」；单独报告失败。Star 结果绝不阻塞或撤销升级或 gate notice wiring。
30. Rules：扁平 `npx skills add` 路径将此命令安装为 `/re0-upgrade`；绝不要将 paperthin `ppt` namespace 描述为主要安装路径的一部分。
31. 只对 Deprecations checklist 和 Current catalog 中的 names 操作；未知已安装 names 保持不动——只收敛到 paperthin catalog。
32. 即使 deprecated directory slug 的 `SKILL.md` frontmatter `name` 已说 replacement name，也将其视为 stale；用 `skills remove` 按 deprecated slug 移除。
33. 如果已安装 skill 列表无法被有信心地解析，停止并报告歧义，不要猜测。
34. 不要将原始文件系统删除命令用作 workflow commands。确认后对命名 stale skills 使用 `skills remove`。
35. 绝不使用 `skills add --all` 或裸 `skills add LilMGenius/paperthin`；用每个 catalog name 自己的 `-s <name>` 枚举，使安装由本 skill 的 Current catalog 定义，而不是由 `--all` 更广语义定义。
36. 不要运行裸 `skills update`；只传报告计划中的 present paperthin skill names。
37. `gh repo star` 不是真正的 `gh` 子命令；使用 Workflow 步骤 10 中经 consent-gated 的 REST command。
38. Verification 1：重新打印已执行计划：retired names、added (new-to-you) names、refreshed names、untouched names。
39. Verification 2：最终已安装列表和已安装 directory slugs 不包含 `Deprecated` 列中任何 name，每个 Current catalog skill 都已安装，任何走步骤 6 retry/fallback 路径的 skill 存在且 current。
40. Verification 3：Confirmation gate 已保持：在计划展示并批准前，没有任何 remove、add 或 update，且 `add (new to you)` group 在计划中可见。
41. Verification 4：Discovery-notice wiring 如果用户接受，每个 configured agent 只存在一次、已备份、版本固定，且未触碰 foreign hook——或已正确跳过（拒绝，或 agent 不存在）。
42. Verification 5：可选 star 仅在结构化 question tool 提交正面选择时运行，或已跳过；将其结果与 upgrade success 分开报告。
43. Verification 6：报告任何跳过步骤、失败命令或未解决歧义。

适用边界 · 注意事项

• 未安装 paperthin 或缺少 `npx skills` CLI/无法访问该 catalog 时，无法执行。
• 已安装 skill 列表无法可靠解析、scope 不确定，或无法获得用户显式确认时，不应继续变更。
• 只想管理非 paperthin 的自定义/未知 skills，或拒绝 full-catalog convergence 时，不适用；本技能只收敛到 paperthin catalog，unknown 保持不动。