Agent Skills
返回列表
📚

知识库健康审计

知识管理 更新于 2026.08.30

将以下提示词粘贴到你的 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,需要可解析的审计结果而非纯聊天式结论