Files
ArtPlayer/refactor/changes/TEMPLATE.md

47 lines
1.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# <任务 ID> <变更主题>
## 范围
- 日期、分支、基线 SHA、关联任务:
- 修改模块、受影响包和消费者:
- 关联兼容契约和 ADR:
- 完成提交主题(包含任务 ID;SHA 通过 Git 日志查找):
## 旧行为与证据
源码、声明、发布包和文档分别记录;提供最小用户调用或复现步骤。标明已复现与待验证。
## 改动与理由
记录最终方案、内部职责变化、资源所有者、错误/取消/事件语义。必要时解释放弃的备选方案。
新增依赖或脚本时,记录用途、版本、所属包/依赖类别、命令输入输出与副作用、锁文件和 CI/用户产物影响。
## 兼容评估
| 范围 | 原行为 | 新行为 | 兼容结论/例外 |
| --- | --- | --- | --- |
| JS API | 待填 | 待填 | 待填 |
| TypeScript | 待填 | 待填 | 待填 |
| 事件/Promise/生命周期 | 待填 | 待填 | 待填 |
| DOM/CSS/插件集成 | 待填 | 待填 | 待填 |
| 发布入口和资源 | 待填 | 待填 | 待填 |
## 验证
| 命令/用例 | 环境与产物 SHA | 结果 | 持久报告/证据 |
| --- | --- | --- | --- |
| 待填 | 待填 | 未运行 | 待填 |
记录失败、跳过、真实浏览器/设备未验证项,不把没有运行的检查写成通过。
## 发布与回退
版本影响、兼容别名/适配、依赖范围、回退提交/旧版本、是否需要重新生成产物。
## 结论与后续
是否满足本任务验收、阻塞、后续任务 ID、文档更新。按实际证据更新 tasks.json,模板自身不能作为完成证据。
验收后将本任务的实现、测试、文档和状态单独提交,核实实际 SHA;提交失败时不能报告交付完成。
同时对照 quality-contract.md,记录职责拆分、已处理的不合理设计、包内实现地图、风险对应测试和后续 AI 修改入口。无法适用的项目说明原因,不机械打勾。