audit-library-health

审计库健康状况

目标

确认技能库保持一致、内容最新，并已准备好分享或安装。

注意事项

• 自动执行健康检查时，始终使用 --format json 输出结构化数据。
• 运行 build-docs 前，始终先使用 --dry-run 检查文档是否已同步。
• 未先通过 validate 和 doctor 检查，切勿将库推送到共享仓库。
• 检查大型目录时，使用 --fields 限制输出。

工作流

1. 运行验证脚本，检查目录完整性。

npx ai-agent-skills validate

此操作会检查：必填字段、文件夹一致性、frontmatter 有效性、集合完整性以及生成的文档是否同步。

2. 运行 doctor，检查已安装技能的健康状况。

npx ai-agent-skills doctor --format json

3. 检查可能需要更新的技能。

npx ai-agent-skills check --format json

4. 确认生成的文档已同步。

npx ai-agent-skills build-docs --dry-run --format json

如果 currentlyInSync 为 false，则重新生成：

npx ai-agent-skills build-docs

5. 检查需要关注的技能整理队列。

npx ai-agent-skills curate review --format json

健康检查清单

• validate 检查通过，无错误
• doctor 未报告安装损坏
• build-docs --dry-run 显示文档已同步
• 没有 whyHere 字段为空的技能
• 所有内部技能在 skills/ 中都有对应文件夹
• skills.json 中的总数与实际技能数量一致

注意事项

• validate 和 doctor 仅执行读取操作，不会修改库。
• check 会发起网络请求，以验证上游来源。对于无法访问的仓库，此操作可能较慢或超时。
• curate review 队列根据缺失字段和过期的验证日期生成，是一种启发式判断，并非强制要求。