Skip to content

M12任务拆解:LearnTypeScript子目录治理深化

这份文档用于定义 M12 的任务拆解。

本轮目标

围绕 06TypeScript/LearnTypeScript 完成一轮按 Dao 流程推进的子目录治理闭环,继续压降全站缺少一级标题问题,并验证“教程型目录 + 概念笔记型目录”是否也能稳定复用当前标题治理方案。

本轮范围

本轮范围包括:

  • 锁定 06TypeScript/LearnTypeScript 为当前治理对象
  • 梳理目录内基础笔记、类型专题、实践专题与声明文件专题的命名差异
  • 补充脚本入口并执行批量 H1 修复
  • 对自动补齐结果做语义化收口,统一为 TypeScript学习:<主题> 标题
  • 顺带处理目录内可安全修复的空页面
  • 完成自测、基线更新、开发记录和 Dao Commit 提交

本轮不包含:

  • 进入 05Nodejs/Node入门2
  • 修改底层标题修复脚本逻辑
  • 并行处理 06TypeScript 下其他子目录

拆解顺序

任务一:目标与现状梳理

目标:确认为什么在 M11 之后切换到 LearnTypeScript 子目录。

完成标准:

  • 已确认该目录当前缺少一级标题数量与收益
  • 已识别学习笔记、note、专题页等弱语义标题风险
  • 已说明为何本轮继续避开 05Nodejs

任务二:业务流程梳理

目标:让本轮主流程、异常回修和回写流程提前对齐。

完成标准:

  • 已明确“巡检 -> 批量修复 -> 语义收口 -> 自测 -> 记录”的主流程
  • 已明确空页面与重复标题的处理策略
  • 已明确沉淀文档位置和更新顺序

任务三:详细设计

目标:明确 LearnTypeScript 目录的命名规范和收口边界。

完成标准:

  • 已形成独立详细设计文档
  • 已明确脚本入口和标题命名策略
  • 已明确基线更新方式

任务四:开发实现

目标:完成当前 LearnTypeScript 子目录的标题治理,并确保指标继续下降。

完成标准:

  • 目标目录缺少一级标题文档已补齐 H1
  • 弱语义标题已统一改为 TypeScript学习:<主题> 或等价上下文标题
  • docs:syncdocs:check 最终通过

任务五:自测与记录

目标:把本轮过程、设计判断、结果和经验完整沉淀到里程碑文档中。

完成标准:

  • 开发记录已更新
  • 里程碑开发笔记已更新
  • 当前轮次已完成 Dao Commit 提交

本轮完成标准

  • 06TypeScript/LearnTypeScript 完成一轮子目录治理
  • 当前质量基线得到更新或确认
  • 里程碑文档组已形成完整闭环
  • 当前子任务已按 Dao Commit 方式提交

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