SuperAPI AI 工具集

audit-discovery-symlinks

部署与运维

查看项目

更新于 10-16 08:07

技能介绍

用途:审计并修复 Claude Code 的发现符号链接,覆盖技能、智能体与团队三类内容,比对注册表与项目级、全局级 .claude/ 目录,发现缺失、损坏、多余或过期条目。适用于新增内容后、仓库重命名或移动后、斜杠命令或智能体找不到时、定期健康检查,以及新项目接入共享内容时。不适用于从零创建初始符号链接中心。

主要能力:自动探测 agent-almanac 根路径;从 skills/_registry.yml、agents/_registry.yml、teams/_registry.yml 提取规范清单;分别审计项目级与全局级符号链接;区分 almanac 内容与外部内容;生成含计数与可操作清单的报告;可选修复。

使用方式:输入参数包括 almanac_path(可选,自动探测)、scope(project、global 或 both,默认 both)、fix_mode(report 默认仅审计、auto 自动修复安全项、interactive 逐项确认)。流程为:识别路径、清点注册表、审计项目级、审计全局级、生成报告、可选修复、验证。修复时项目级技能用相对路径 ln -s "../../skills/$skill",全局级用绝对路径 ln -s "$ALMANAC_PATH/skills/$skill";缺失的 agents/teams 目录链接也按对应路径创建。

限制与注意:绝不删除非 almanac 的外部内容;template 不应出现在发现路径中;ln -s 遇到已存在目录会失败,需先 rmdir 空目录或人工处理非空目录;注册表头部 total* 计数可能过期,应以实际 - id: 条目为准;项目级用相对路径、全局级用绝对路径,混用会在移动后失效。修复后需重新运行审计确认零缺失、零损坏。