docs(refactor): [DOC-12] close execution and release planning gaps

This commit is contained in:
Harvey Zhao committed 2026-09-10 18:30:08 +08:00
1 parent 9b9739ab61
commit 7a5354e356
10 files changed
+160 -28

No files matched your search

+24
View File
@@ -55,3 +55,27 @@ BASE-04 增加键盘可达性、焦点返回、可访问名称、设置菜单交
每次检查记录起点 SHA 和候选源码/产物的内容标识。完成提交包含状态及文档,提交 SHA 在提交后由 Git 日志核对,避免要求同一提交包含自身 SHA。当前 plan 校验器检查状态和证据文件存在,不能代替测试,也不自动证明每个 done 任务已有 commit;提交审计纳入 ENG-09。
汇报分别给出规划任务与实施任务完成情况。任务数量不是工作量百分比,不将文档完成数当作代码重构进度。
## 8. 基线启动与覆盖映射(DOC-12 复审)
BASE-03/04/06 的初始采集使用固定旧 tarball、现有 Node 测试和 docs 页面,以及随基线任务提交的最小探针/断言与运行步骤。按需安装工具仍已授权,但不提前重构生产源码。ENG-05/08 再将这些证据和用例接入正式服务及报告,不能反过来要求 BASE 等待依赖它的 ENG 完成,也不能让无法重跑的聊天记录充当基线。
BASE-05 对每包记录实际分发类别:播放器库/插件/proxy/工具使用对应产物验收;文档站使用站点构建、URL 和静态资源验收,是否另发 npm 按发布历史核实。22 包全部在重构和版本目标范围内,但不强行为没有历史库入口的站点包创造 UMD/ESM 消费 API。每个不适用项需依据及替代验收,不是跳过该包。
BASE-02 至 BASE-05 开始登记“契约编号/包/支持版本/场景 -> 固定测试 ID -> 执行命令/源码或候选标识/报告 -> 负责实施任务”。ENG-09 接入可检查的覆盖索引,明确哪些只是计划、哪些已执行、哪些缺证据。目录覆盖和测试数量不能代替契约覆盖。
SSR 区分 import 的环境安全、静态 html/useSSR 模板能力、浏览器挂载和非浏览器构造错误。当前核心 constructor 明确在非浏览器抛错,不能把“SSR 兼容”理解为允许在服务端 new 播放器;BASE-05/CORE-12/EX 消费分别比较旧行为。
## 9. 复盘顺序与版本落实
DOC-12 发现 REVIEW-01 经 MOD-05 -> MOD-04 间接依赖 mask 设备验收。第一轮改为依赖 MOD-01/02/03 等可用的工具和核心性能结论;重型插件真实环境仍经 REL-03 -> REVIEW-02 保留。早期代码复盘可登记尚未验证的设备能力,不允许由此批准发布。
REL-09 是全包 major 版本准备的明确实施任务,位于 REL-01 方案之后、REL-02 候选构建之前。按需拆分版本准备子任务,每个完成任务独立提交;只改目标文档不能算版本已落地。既有各包分发验收仍有效,但最终发布必须重新验证完成版本修改后的候选。
## 10. 何时继续补计划
现在固定兼容范围、任务依赖、任务/证据归属、版本和发布门槛。具体文件名、类型泛型、工具版本、拆分粒度、性能阈值及新复现缺陷在相关任务开始时根据源码和试点调整。不要为了补全假想细节无限增加规划任务,也不要将已知依赖冲突留到执行时碰运气。
扩展任务同时更新下游验收依赖和证据索引,保留旧 ID/历史事实。plan 校验器检查关键顺序(早期试点、首轮不依赖专项设备、最终发布依赖复盘/CI/版本准备)及实施任务到最终里程碑的可达性;这不能证明测试有效或代码无回归。
代码迁移完成后仍有 REVIEW 与发布准备;发布就绪后仍有实际授权发布步骤。未来长任务按用户指定终点执行,不能因 REL-05/06 尚未授权而冒充全项目发布完成,也不能擅自执行 publish 来清空任务表。