用途:整理 Claude Code / Codex 技能库,让技能名反映其实际触及的后端或产品,并在重命名时保持符号链接与交叉引用一致。许多环境维护一个共享目录中的规范技能库,再符号链接到各工具的 hub(如 ~/.claude/skills/、~/.codex/skills/),部分技能位于项目仓库再链入 hub,因此一次重命名可能牵动多个链接和文档。
主要能力与使用方式(四步):
- 盘点:列出每个技能及其真实位置,用 ls -la 查看各 hub,用 readlink -f 解析真实目录,区分共享库与项目仓库技能。
- 按后端分类:前缀取技能实际调用的后端而非主题,可用 grep -rlE "<api-host>/api|/api/<x>|<db-client>|<AUTH_TOKEN_NAME>" "$skill_dir" 检查依赖;无后端调用的归本地通用前缀;大家族可保留主题中缀。重命名前先向用户说明分类依据。
- 重命名并修复连带影响:共享库用 mv <lib>/OLD <lib>/NEW,仓库内用 git mv <skills-path>/OLD <skills-path>/NEW && git commit;重建各 hub 的符号链接;更新 NEW/SKILL.md frontmatter 中的 name 与目录一致(加载器以此为准);用 grep -rln "OLD" <lib> <memory-dirs> 找交叉引用,先替换最具体字符串(完整旧路径优先于裸名称)。
- 验证:用 find -L "$hub" -maxdepth 1 -type l ! -exec test -e {} ; -print 找断链,grep -rn "OLD" <lib> 确认无残留旧名,grep -m1 "^name:" <lib>/NEW/SKILL.md 核对名称。
适用场景:维护多点符号链接的技能库、批量统一命名规范、重命名后修复文档与记忆文件引用。
限制与注意:不要删除未重命名的技能,只改约定要求的部分;重命名本身廉价可逆,真正成本是断掉的交叉引用;仓库内重命名建议每个逻辑重命名单独提交,便于 bisect 与回滚。资料未提供具体安装命令、依赖版本与收费信息。