ArtPlayer/refactor/changes/2026-09-10-DOC-05-task-commits.md

DOC-05 文档初始化与每任务独立提交

• 日期：2026-09-10。
• 分支：codex/compatible-modernization。
• 基线：40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f。
• 提交主题：docs(refactor): [DOC-05] establish refactor docs and per-task commits。
• 关联决策：ADR-007、ADR-013、ADR-014。

问题与变化

此前已创建分支和规划文件，但没有规定每任务完成后必须提交。用户明确补充：每完成一个任务就创建一个 commit。

现在根 AGENTS.md、README、AI 流程、质量验收和变更模板都要求：任务通过验收后，包含任务 ID 的独立提交同时保存实现、测试、文档和状态；核实提交成功后才能开始下一任务。失败不能当作已完成交付。推送和发布未被这项授权涵盖。

DOC-01 至 DOC-04 在新规则前已经完成，文件尚未进入 Git。本次 DOC-05 将这些已有文档作为初始基线一并入库；不伪造更早的独立提交。之后新增完成的任务各自提交。

范围与兼容

仅 AGENTS.md 与 refactor/。没有修改生产代码、公开声明、依赖或构建产物。新增任务规则不改变浏览器用户的行为。

验证与追溯

• node refactor/scripts/plan.mjs --write：生成 191 项计划。
• node refactor/scripts/plan.mjs --check：检查任务、依赖、22 包、链接与生成同步。
• node --check refactor/scripts/plan.mjs：语法检查。
• git diff --cached --check：提交内容格式检查。
• 提交后使用 git log -1 --format='%h %s' 与 git status --short 核对实际提交和工作区。

SHA 通过上述提交主题在 Git 历史中追溯；在同一提交中写自身 SHA 会导致循环修改，因此不在这里预填。生产测试不适用于本次纯文档初始化，前期诊断仍单独列在 progress.md。

回退与下一步

必要时独立回退本次文档提交，不影响生产实现。下一项为 BASE-01，必须在 DOC-05 本地提交成功后开始。