skill-link-check

# Skill Link Check ## 安装与更新 来源：[Skills.sh](https://skills.sh/yan-labs/yan-skills) ```bash # 首次全局安装，或更新失败时重新安装 npx skills add yan-labs/yan-skills --skill skill-link-check -g -y # 更新已安装的全局 Skill npx skills update skill-link-check -g -y ``` 若使用项目级安装，去掉安装命令中的 `-g`；项目级更新使用 `npx skills update skill-link-check -p -y`。 本 Skill 只审计目录布局，不自动移动、删除或覆盖文件： - `.agents/skills/<name>/` 保存真实源文件。 - `.claude/skills` 要么整体链接到 `.agents/skills`，要么通过逐个子项链接镜像它。 最常见的漂移是 Skill 被直接创建成 `.claude/skills/<name>/` 真实目录，却没有进入 `.agents/skills/`。它看似已安装，实际不会随正常备份、同步或迁移流程保存。 ## Goal Contract 在 `/goal`、autopilot 或其他持续执行器中，本 Skill 的完成条件是“审计证据完整”，不是“退出码必须为 0”。发现问题是有效结果，不能为了让检查通过而擅自修复。 ```xml <goal>审计所有适用作用域，判定 Skill 源目录与运行时镜像是否一致，并为每个问题提供可复核证据和修复命令。</goal> <gate>检查脚本已从用户目标项目运行；每个适用作用域都有布局模式、问题分类和退出状态。</gate> <done-when>无问题时明确报告 clean；有问题时完整列出数量、类别、路径和建议命令；未自动修改任何被审计目录。</done-when> ``` 因此： - 退出码 `0`：审计完成且没有发现问题。 - 退出码 `1`：审计完成且发现问题，不代表 Skill 执行失败。 - Python traceback、参数错误或无法读取目标：才属于执行失败，需要修复后重跑。 ## 运行方式 ```bash python3 "$(dirname "$0")/check.py" ``` 默认���计： - **Project**：当前目录下的 `.agents/skills` 与 `.claude/skills`。 - **Global**：`$HOME` 下的同名目录。 自动化或 checker 可使用： ```bash # 明确指定项目，避免依赖当前工作目录 python3 "$(dirname "$0")/check.py" --project-root /path/to/project # 只查一个作用域 python3 "$(dirname "$0")/check.py" --project-only python3 "$(dirname "$0")/check.py" --global-only # 输出稳定 JSON 证据；发现问题时仍返回 1 python3 "$(dirname "$0")/check.py" --json ``` ## 两种合法布局 两种模式都应通过： 1. **Parent symlink**：`.claude/skills` 本身指向 `....