SuperAPI AI 工具集

solo-audit

测试与质量

查看项目

更新于 10-15 21:46

技能介绍

用途:对 Markdown 知识库做质量审计,发现缺失 frontmatter、失效链接、标签不一致、孤立文件与覆盖缺口。

主要能力:解析可选焦点参数(如 tags、frontmatter、links),为空则全量审计;用 Glob 查找 .md 文件并排除 .venv/、node_modules/、.git/、archive/、.archive_old/;先抽样检测 frontmatter 模式,再逐文件检查 YAML frontmatter、title、tags 等核心字段及 type/status 一致性;用 Grep 校验内部 Markdown 链接目标是否存在,若项目有 scripts/check_links.py 等脚本也会运行;统计标签,识别近重复、仅用一次和过宽的标签;检查未被 related: 引用的孤立文件;识别超过 30 天的草稿、缺元数据和少于 100 词的低内容文档;按目录检查空目录或仅 1-2 个文件的目录。

使用方式:以 /audit 调用,可附带焦点区域参数。输出为 KB Audit Report,含摘要、frontmatter 问题、失效链接、标签分析、孤立文件、内容质量、覆盖情况与建议。

限制与注意:单次标签不一定是拼写错误,需结合上下文;3-inbox/ 或 4-opportunities/ 中的孤立文件可能是有意设计,仅对 methodology 或 principles 目录标记孤立;frontmatter 模式按目录不同,不应全局强制统一;related: 字段并非唯一交叉引用来源,内联链接也需检查;空目录可能是占位符,标记前应查看 registry.yaml 或 Makefile。常见问题包括未找到 Markdown 文件、单次标签过多和 YAML 语法错误,需检查运行目录、排除模式与 --- 分隔符。