用途:校验 dev-workflow-bundle 中各成员的规范目录 skills/<name>/skills/<name>/ 与副本目录 plugins/dev-workflow-bundle/skills/<name>/ 是否一致,并报告差异。该技能仅为规避上游 Claude Code 符号链接 bug(anthropics/claude-code#53948)而存在,属于项目本地技能,不注册在 .claude-plugin/marketplace.json 中。
主要能力:从 .claude-plugin/marketplace.json 读取 bundle 成员列表,逐个用 test -d 检查两个目录是否存在,再用 diff -rq 比较。输出差异类型包括 differ、only_in_canonical、only_in_copy。该技能只检测,从不修改任何文件。
使用方式:接受可选的 --base-commit <sha> 参数(会被忽略,检查是结构性的,不依赖变更集),无参数运行行为相同。直接在主线程执行,无需派发子智能体。结果分两层返回:第一层为文字摘要(Status: SUCCESS | TEST_FAILED | EXECUTION_ERROR),第二层为围栏 JSON,包含 status、checked_count、drift_files、reason 字段。状态映射:SUCCESS→ok,TEST_FAILED→drift,EXECUTION_ERROR→error。
限制:仅适用于上述 bundle 布局的项目。若 marketplace.json 缺失、格式错误、缺少 dev-workflow-bundle 条目、jq 或 diff 不可用、路径不存在,则返回 EXECUTION_ERROR,且同一次运行内结果确定,重试不会改变。TEST_FAILED 时会给出形如 cp -R skills/<name>/skills/<name>/. plugins/dev-workflow-bundle/skills/<name>/ 的修复提示。当上游 bug 修复、bundle 布局恢复为符号链接后,应删除本技能目录及记录该规避方案的相关条目。