Skip to content

M5 任务拆解:内容质量治理与校验链路增强

这份任务拆解文档用于承接 M5 的执行范围:在站点已经具备导航、专题、SEO、发布与导览能力后,进一步补齐内容质量治理和校验链路。

本轮目标

让知识站不仅“能展示、能搜索、能导览”,还具备面向长期维护的质量反馈能力。

本轮重点回答四个问题:

  • 当前 Markdown 资料总量与问题量是多少
  • 哪些文档缺少一级标题
  • 哪些页面存在资源缺失或占位页问题
  • 如何把这些校验纳入本地与 CI 流程

本轮交付范围

  • 站点治理总览页
  • Markdown 质量巡检结果生成能力
  • 本地 docs:check 校验命令
  • GitHub Actions 文档校验工作流

任务拆解

任务一:质量巡检指标生成

目标:自动收集知识库当前的基础质量指标。

子任务:

  • 统计 Markdown 文档总量
  • 统计占位页 / 空文件数量
  • 统计缺少一级标题的文档
  • 统计本地资源缺失链接
  • 汇总重复标题情况

任务二:站点治理总览页

目标:把巡检结果以站内页面形式展示,而不只是打印在命令行里。

子任务:

  • 新增 站点治理/ 页面
  • 用卡片展示质量总览
  • 展示缺少一级标题、重复标题、缺失资源等重点问题
  • 为后续治理提供明确入口

任务三:本地校验命令

目标:让本地在构建后能直接执行站点质量校验。

子任务:

  • 新增 npm run docs:check
  • 校验关键构建文件是否存在
  • 校验治理报告是否生成
  • 输出巡检摘要

任务四:CI 校验链路

目标:把知识站构建与治理检查纳入远端工作流。

子任务:

  • 新增 docs-check.yml
  • 在 PR / 分支推送时执行 npm run docs:check
  • 保持 Pages 部署工作流不受影响

本轮执行顺序

  1. 先完成任务拆解
  2. 再补详细设计
  3. 再进入开发实现
  4. 开发完成后执行自测
  5. 自测通过后补开发记录与技术博客
  6. 最后执行 Git 提交与推送

共 20 个模块,1301 篇 Markdown 文档。