Agent Skill Doctor

---

Agent Skill Doctor 用来帮你检查本地 AI Agent Skills 是否健康：有没有重复安装、版本漂移、互相冲突、危险指令、僵尸 Skill、描述不清等问题。它不会直接删除或覆盖你的 Skill 文件；默认只诊断、出报告、给 Agent 修复提示词。

它能诊断什么

• risk：危险能力提示，例如 rm -rf、读取 .env、curl/wget、powershell、child_process。
• conflict：Skill 之间的指令冲突，例如一个要求 npm install，另一个要求 pnpm install。
• duplicate：重复 Skill，包含完全重复、同源重复、同名不同内容。
• version_drift：同一个 Skill 在多个位置存在不同版本、不同 ref 或不同内容。
• governance：Registry / 团队共享就绪度，例如缺少 owner、version、生命周期状态、stable/dev 标签或可信来源。
• freshness：技能是否需要更新，例如无来源 URL（无法检查更新）、来源未锁定 ref/commit、修改时间过长（>180 天）疑似落后上游、同源副本版本更低。--check-upstream 可联网用 git ls-remote 验证 commit 是否落后上游 HEAD。
• zombie：疑似长期不用或无人维护的 Skill。
• description_quality：缺少触发条件、输入输出、风险说明，或者描述过短。
• scan_warning：目录结构问题，例如缺少 SKILL.md 或 frontmatter 格式异常。

评分和判定规则

• 风险等级来自规则文件：破坏性文件操作通常是 critical，凭据访问和远程下载通常是 high，shell 执行通常是 medium。
• 重复检测有三个策略：完全相同内容 confidence=1.0，同一来源和 slug confidence=0.95，同名但内容不同 confidence=0.7。
• 僵尸评分范围是 0.0 - 1.0，分数越高越可疑：
  • 未出现在 preset：+0.25
  • 未安装到任何 agent：+0.20
  • 未安装到任何项目：+0.20
  • 近期未修改：+0.15
  • 无活动记录：+0.15
  • 描述质量过低：+0.05
• 僵尸保护规则：pinned/keep/core/system 标签直接归零；官方来源归零；插件来源分数乘 0.5；第三方插件来源分数乘 0.75。
• 僵尸阈值：>=0.8 是强疑似僵尸，>=0.6 是疑似僵尸，>=0.4 是低活跃。
• 描述质量从 60 分起算；描述过短、没有触发条件、没有输入输出、风险未说明都会扣分并生成提示。

安装

npm install -g agent-skill-doctor

不想全局安装也可以直接