用途：帮助用户收集关于智能体技能（skills）的本地证据，包括技能是否位于可能被发现的位置、注入的金丝雀命令是否被观察到执行，以及使用模式。定位是技能可观测性顾问与工具集，填补本地证据空白，不替代平台原生遥测。
主要能力与三层结构： 第一层 skill-probe.sh：扫描常见本地技能目录（如 .agents/skills/、.claude/skills/、.codex/skills/、.cursor/skills/ 等）的项目级与全局位置，报告同名冲突、发现优先级、frontmatter 是否可解析。 第二层 skill-trace.sh：向 SKILL.md 注入轻量金丝雀前导块，支持 --inject、--inject-dir、--strip、--strip-dir，可字节级还原；金丝雀事件写入本地 JSONL，含基于规范路径与内容哈希的本地身份键，自动注入块不计入哈希。 第三层 skill-dashboard.sh：展示各技能身份的金丝雀事件次数、最近观测时间、cwd 分布、已观测身份率、未观测列表与最常观测技能。 综合体检：skill-probe.sh --doctor 组合探测、原生平台信号检查（如 Claude Code OTel 环境、Codex/Cursor 本地表面、OpenAI Agents SDK 追踪环境）、激活日志分析，并在安装 skill-hygiene 时交叉引用其扫描结果。
使用方式：文档给出只读快照命令 bash ~/.agents/skills/skill-debug/bin/skills-refiner-doctor.sh，可加 --json、--lang zh、--raw；各层脚本路径同上。支持 Pi 0.86.0 用户技能目录观测，命令为 node ~/.agents/skills/skill-debug/bin/pi-skill-catalog.mjs --pi-package <绝对路径> --json，退出 0 表示观测完成，3 表示不支持的 Pi 版本或配置，2 为其他失败。
限制：只对本地证据做准确计数，无法确认真实发现、加载、服从或有用性，除非平台导出运行时事件；无原生遥测时金丝雀只是代理观测。金丝雀“未观测到”不等于技能未被使用。日志仅本地保存，目录 0700、文件 0600，不外发数据。macOS 原生完整支持；WSL 2 Linux 文件系统 HOME 属设计支持但未认证；Git Bash 仅限真实目录只读治理与跟踪文件转换，不支持符号链接拓扑、金丝雀日志与 PowerShell/cmd。未观测到金丝雀可能只是未被需要，需结合工作流判断。
资料未提供具体收费、价格与平台上线信息。