知识库健康审计
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/thcjp-solo-audit-103。
技能介绍
要解决什么问题
Markdown 知识库一旦体量上来,断链、frontmatter 缺字段、标签命名漂移和封面路径错误往往不会在一次 PR 里暴雷,而是在几周后的检索或发布环节才被发现。人工逐篇点开链接、对照规范表,成本高且容易漏检;单纯用脚本扫 URL 又常常抓不住「元数据与标签约定」这类项目内规则。
技能如何工作
Audit 以 project_dir 为入口,通过 check_items 选择检查范围(links / metadata / tags / all,默认全量)。在支持 SKILL.md 的 Agent(Cursor、Claude Code 等)里用自然语言驱动执行后,会按场景产出结构化结果:健康检查场景汇总断链、缺失元数据与标签不一致;链接验证场景给出失效 URL 清单与修复建议;元数据一致性场景对照 frontmatter 规范报告字段缺失与格式问题。资料中说明整体输出可为 JSON,含评分、明细与改进建议,便于接进 CI 或人工修复流水线。
适用边界与注意点
技能定位在链接与元数据层面的知识库维护,不适用于非链接/元数据相关的内容质量评估(行文、逻辑、业务正确性等)。运行依赖 Agent 内置 LLM,无额外必需 CLI;若检查项含外部 URL,网络与限流会影响速度与误判率。资料中的深度漏洞扫描、CVE 关联、威胁情报等列为付费版能力,与免费版基础健康检查应区分开来,避免对输出范围产生错误预期。
使用场景
- 文档站大版本发布前,需要对整仓 Markdown 跑一次断链与 frontmatter 完整性扫描
- 团队统一了标签命名规范后,要找出仍使用旧 tag 的文件并生成不一致清单
- 开源文档仓库接入 CI 前,用结构化 JSON 报告作为门禁输入
- 迁移知识库目录结构后,批量验证文内相对链接与封面资源路径是否仍有效
适合人员
- 维护内部技术文档站的工程师,需要在合并前自动发现断链与元数据缺口
- 负责开源项目文档的维护者,希望按 links/metadata/tags 分项审计而非手工抽检
- 知识管理团队负责人,要对多目录知识库做标签一致性与封面路径合规检查
- 把文档质量纳入流水线的 DevOps,需要可解析的审计结果而非纯聊天式结论