Skill 归一化

问题从哪来

如果你同时在 Claude Code、Codex、CodeBuddy、WorkBuddy 或 agents-personal 里装过同一套 skill，磁盘上往往是多份内容相同或近似的目录：各自更新、各自占空间，改一处其它 agent 仍读旧拷贝。本技能面向的是「本地多 agent 目录里 skill 重复」这件事，而不是从 skillhub 商店安装或搜索云端包。

它怎么工作

skill-normalize 是 skillhub CLI 的 normalize 子命令（scripts/skills_normalize.py + 包装脚本）。流程可以概括为：

• 探查：按内置 adapter 扫描各 agent 的 skill 路径（如 ~/.claude/skills/、~/.codex/vendor_imports/skills/ 等），用 frontmatter 做 normalize-safe 判定；带 allowed-tools、connector、disable 等与 agent 绑定的 skill 会 跳过 并记录原因。
• 合并：按 skill 目录名（小写 basename）分组，组内 sha256 全相同 才进入 canonicalize；同名不同内容记为 conflict，写入 plan 但 apply 不自动选边。
• 落盘：仅 --apply 会改磁盘；每个 skill 单事务——先 tar 备份目标与所有出现路径到 ~/.skillhub/.normalize-backup/，再把权威副本放到 ~/.skillhub/<skill>/，各 agent 原路径换成 目录级 symlink；并清理 adapter 声明的 cache，避免 stale 状态。

默认是只读输出；回滚可解 tar 还原 agent 路径、删除权威副本并清理 lockfile 中本次 apply 条目。新 agent 可通过 ~/.skillhub/.normalize-adapters.json 扩展，无需改代码。

边界与注意

• 平台：文档写明仅 macOS 适配，Linux / Windows 不在支持范围。
• 职责：install / search / upgrade / list 仍由 skillhub 其它子命令负责；normalize 写入 lock 的 source 为 agent-import，列表可见但不会按云端 URL 升级。
• 冲突：v1 不自动合并 hash 不一致的同名 skill，误合并代价大于保留重复，需你手动二选一、跳过或重命名。