SuperAPI AI 工具集

health

测试与质量

查看项目

更新于 10-15 16:42

技能介绍

用途:对笔记库(vault)运行基于条件的健康诊断,覆盖 8 类指标并输出报告。运行前读取 ops/derivation-manifest.md 配置词汇表与目录名、ops/config.yaml 配置处理深度与阈值;文件不存在时使用通用默认值(笔记目录 notes/、收件箱 inbox/、主题地图位于 notes/)。

调用模式:无参数或 quick 只跑第 1、2、3 类;full 跑全部 8 类;three-space 只跑第 5 类。执行流程为识别模式、扫描 vault 清点文件、按序运行各类诊断、以 PASS/WARN/FAIL 分级、生成含具体路径与计数的报告,并写入 ops/health/YYYY-MM-DD-report.md。

8 类检查:1 schema 合规(YAML frontmatter、description、topics、枚举值);2 孤儿检测(无入链,按创建时间分级);3 链接健康(悬空 wiki 链接);4 描述质量(是否仅复述标题);5 三空间边界(ops/self/notes 内容混入);6 处理吞吐(收件箱与笔记比例);7 陈旧笔记(超 30 天且入链少于 2);8 主题地图一致性(笔记数与覆盖缺口)。

限制:部分检查依赖平台能力,未配置语义搜索(qmd)时跳过相关项并说明缺失;无 hooks 则仅按约定校验;self/ 目录不存在时跳过其检查但确认 ops/ 是否正确吸收相关内容。报告只反映可检查项,不评判平台缺少的功能。