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 部署工作流不受影响
本轮执行顺序
- 先完成任务拆解
- 再补详细设计
- 再进入开发实现
- 开发完成后执行自测
- 自测通过后补开发记录与技术博客
- 最后执行 Git 提交与推送
