开发记录：Dao 交付闭环落地

这篇开发记录用于复盘 M1 的背景、目标、执行过程和当前结果。

背景

当前仓库已经有 Dao 核心理论、Dao Commit 规范和基础交付工作流说明，但还缺少真正可落地的里程碑推进底座。

如果没有统一的阶段规划、文档模板和脚手架，后续每个里程碑都会重复做这些基础工作，交付成本会偏高，也不利于稳定执行 Dao 的推进原则。

因此，M1 的重点不是扩展新业务，而是先把“如何按 Dao 交付一个里程碑”这件事在仓库里跑通。

本轮目标

本轮要完成三件核心事情：

• 建立阶段里程碑规划
• 建立 M1 标准文档组
• 建立里程碑模板和脚手架

当前进度

已完成

• 已新增阶段里程碑总规划文档
• 已新增 M1 任务拆解文档
• 已新增 M1 详细设计文档
• 已建立本轮开发记录文档
• 已新增里程碑模板目录
• 已新增里程碑脚手架脚本
• 已新增 npm run dao:milestone 脚本入口
• 已完成脚手架执行验证
• 已完成 docs:sync 验证
• 已完成 docs:check 验证

待完成

• 当前仅剩由你执行最终的 Dao Commit squash 收口

关键决策

决策一：先把 M1 定义为“交付底座”，而不是直接做业务功能

原因是后续所有里程碑都依赖这套节奏。如果底层节奏先稳定下来，之后的业务里程碑推进成本会明显下降。

决策二：文档与脚手架一起落地

只写规范不够，因为规范不能自动执行；只写脚手架也不够，因为脚手架会失去语义约束。

所以本轮同时保留：

• 规划与设计文档
• 模板
• 脚手架

决策三：先使用最小可用模板字段

本轮模板只使用：

• MILESTONE
• TOPIC
• DATE

原因是先保证可用，再逐步扩展，不在 M1 过早把模板复杂化。

自测计划

本轮自测将按下面顺序执行：

1. 脚手架生成验证
2. docs:sync 验证
3. docs:check 验证

如果其中任一步失败，将回到实现阶段修复，直到通过。

自测结果

脚手架生成验证

已执行：

node scripts/create-dao-milestone.mjs M2 内容治理扩面 /tmp/dao-m2-test

结果：

• 成功生成 4 份里程碑文档
• 验证了模板变量替换、目标目录写入和文件命名逻辑

文档同步验证

已执行：

npm run docs:sync

结果：

• 通过
• 新增的 Dao 文档已成功同步到站点源目录

站点校验验证

已执行：

npm run docs:check

结果：

• 通过
• 构建与校验链路正常
• 当前质量结果为：
  • placeholderCount = 25
  • missingTitleCount = 317
  • missingAssetCount = 0
  • duplicateTitleCount = 38

当前结果

M1 已完成规划、设计、开发、自测和文档沉淀。

本轮最终沉淀出的核心资产包括：

• 阶段里程碑规划文档
• M1 文档组
• 可复用里程碑模板
• 里程碑脚手架脚本
• npm 脚本入口

这意味着后续真实业务里程碑已经可以直接复用这套底座，不需要再从零搭建流程。