Agent Skills
返回列表
🔒

Skill健康守护

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_d68814ae/skill-health-check

技能介绍

它要解决什么问题

SKILL.md 一旦进入迭代，退化往往不是某一行写错了，而是无声积累的：references/ 里躺着没人读过的旧文档，assets/ 下藏着从未被引用的 HTML 模板，frontmatter 写着 2.2，H1 却是 v2.0，版本记录表的最大行还停在 v2.1。这类问题单独出现时都不致命，组合起来却会让 Agent 在没人打算发布的版本上继续干活。Skill 健康检查就是为这种静默退化准备的巡检。

核心能力

  • 三种触发时机：每月 1 日 9:00 定时扫描 ~/.workbuddy/skills/；任何 SKILL.md 被 Edit/Write 修改后在同一回合追加扫描；用户说「检查技能健康」「skill 体检」时手动调用。
  • 12 项扫描：行数上限与增长趋势、🔒 标记密度、死引用与孤儿文件、脚本与相对 .md 路径存在性、规则重复、版本自洽（frontmatter / H1 / 版本记录表三处对齐）、_DEPENDENCY_MAP.md 同步、references/ 文件数、测试覆盖、全链元数据一致性。
  • 分级处置：输出健康报告表格并按 A/B/C/D 分级。A/B 静默通过，C/D 推微信速报并附处理方案。断链与版本断裂一律标 🔴，要求当天修复。
  • 硬约束：修改任何 SKILL 超过 5 行，必须在同一回合同步 _DEPENDENCY_MAP.md，不允许延迟到下一轮对话。

适用边界

  • 若运行环境不提供 Edit 后回调，检查不会因此跳过，而是回落到「手动 + 定时」两种兜底触发。
  • 疑似数据库表名（stats_*、beike_*、guanshi_*）只列出待人工核对，不连库校验，避免过度工程。
  • references/ 超过 15 个文件只给出合并建议，不会自动合并。
  • 自动触发仅针对修改其他 Skill 的场景，避免自我递归。

使用场景

  • 修改SKILL.md超过5行后，需在同一回合内同步依赖地图并验证frontmatter、H1与版本记录表三处版本号自洽，防止版本断裂。
  • 每月1日定时扫描技能目录时，需提取SKILL.md中的references和scripts相对路径，逐一验证文件是否真实存在以捕获死引用。
  • 发现技能目录下存在从未被SKILL.md引用的HTML或Py文件时，需识别出这些零引用孤儿文件并给出清理或接入工作流的建议。
  • 当SKILL.md行数超过500行或references目录文件超过15个时，需输出瘦身与合并候选方案，遏制技能文档的无序膨胀趋势。

适合人员

  • Agent 技能开发者：在持续迭代 SKILL.md 时，需要确保引用文件有效、版本号三处自洽且依赖地图同步更新，防止技能静默退化。
  • AI 工作流运维人员：在管理多个自动化技能时，需要定期排查孤儿文件、行数膨胀和断链，保障 Agent 调用的技能生态健康稳定。
  • 自动化团队技术负责人：在审查技能修改记录时，需要依赖自动触发的断链捕获和版本一致性校验，避免人工遗漏导致的线上运行故障。