mirror of
https://github.com/zhw2590582/ArtPlayer.git
synced 2026-10-08 10:56:15 -08:00
docs(refactor): [DOC-REVIEW-01] wait for user-led release reviews
This commit is contained in:
1 parent
9cfb6c8b9f
commit
bb2c12df30
7 files changed
+72
-6
No files matched your search
@@ -27,8 +27,10 @@ The user also authorizes installing needed dependencies and adding or improving
|
||||
project scripts for the refactor without asking again for routine tooling choices.
|
||||
Record their purpose and versions, use the appropriate workspace/dependency category, update
|
||||
the lockfile when applicable, and verify compatibility and reproducible execution.
|
||||
After implementation, follow [refactor/release-reviews.md](refactor/release-reviews.md):
|
||||
complete the three review rounds and close blocking findings before candidate publication.
|
||||
After implementation and its necessary tests, hand off the results and wait for the
|
||||
user to guide and start the review phase. Do not automatically begin REVIEW-01/02/03,
|
||||
including an early first review. Follow [refactor/release-reviews.md](refactor/release-reviews.md):
|
||||
the three review rounds and closure of blocking findings remain required before candidate publication.
|
||||
Connected Chrome interaction checks complement committed automated browser tests; neither
|
||||
connection availability nor mocks replace actual playback or required device evidence.
|
||||
If Chrome is unavailable, use the Codex in-app browser for supported real-page tests.
|
||||
|
||||
@@ -34,6 +34,11 @@ AI 用于源码分析、任务拆分、实现、测试和差异审查。现代
|
||||
|
||||
## 实现后
|
||||
|
||||
2026-09-15 用户要求由其指导复盘:实施和必要验证完成后先交接,等待用户明确
|
||||
启动 REVIEW-01/02/03,不自动进行首轮或后续全局复盘。各任务日常自查和回归
|
||||
测试仍需完成;三轮复盘及发布门槛不删除、不标为已通过。以
|
||||
[当前复盘启动规则](release-reviews.md)为准,减少重复验证和冗长进度输出。
|
||||
|
||||
1. 执行受影响测试、类型检查、正常构建和必要浏览器 demo。
|
||||
2. 用相同旧用户调用检查行为;记录有意差异和类型影响。
|
||||
3. 做独立的一轮差异审查:公开签名、事件/Promise、资源清理、旧核心/插件、包入口。独立审查可由同一会话分轮执行,不要求创建代理。
|
||||
|
||||
@@ -0,0 +1,14 @@
|
||||
# DOC-REVIEW-01 用户指导复盘启动
|
||||
|
||||
2026-09-15 用户提醒token额度将尽,并明确要求重构完成后先不要进入复盘,
|
||||
由用户指导复盘。本任务同步根AGENTS、AI接续流程和复盘准入文档。
|
||||
|
||||
继续已授权的实施、日常自查、必要测试和故障修复;实施结束后交接真实结果、
|
||||
待处理项和证据,等待用户明确启动复盘。REVIEW-01/02/03保持todo,不自动提前
|
||||
进行首轮。既有三轮复盘与发布门槛不变,不以等待用户指导等同通过或发布授权。
|
||||
减少无新证据需求的重复运行及冗长输出,不省略必要验证。
|
||||
|
||||
这是文档和执行边界变更,不修改JS/TS接口、生产代码、测试、依赖或产物。
|
||||
计划生成/检查、三轮复盘状态及原依赖保留检查、Git diff检查通过后独立提交
|
||||
`docs(refactor): [DOC-REVIEW-01] wait for user-led release reviews`。
|
||||
无需浏览器重跑;回退文档提交也不能撤销用户在对话中作出的有效指示。
|
||||
+5
-3
@@ -2,9 +2,9 @@
|
||||
|
||||
> 由 tasks.json 生成。请修改数据后运行 `node refactor/scripts/plan.mjs --write`,不要手改本表。
|
||||
|
||||
基线:`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 281 项,范围 22 个包及工作区/示例。
|
||||
基线:`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 282 项,范围 22 个包及工作区/示例。
|
||||
|
||||
状态:todo 43 / doing 21 / blocked 0 / done 217 / deferred 0。风险 L/M/H 表示兼容风险,不表示工期。
|
||||
状态:todo 43 / doing 21 / blocked 0 / done 218 / deferred 0。风险 L/M/H 表示兼容风险,不表示工期。
|
||||
|
||||
前置依赖是启动条件;验收是完成条件。任务可以继续拆分,但不能复用或悄悄删除旧 ID。
|
||||
|
||||
@@ -54,6 +54,7 @@
|
||||
| DOC-11 | workspace<br>记录全部包各自升级一个大版本 | DOC-10 | 22 包目标版本清单、决策和发布/CI/复盘规则同步 | 版本表与 manifest 对照、计划检查通过并独立提交;不修改旧 API 兼容要求 | L | done |
|
||||
| DOC-12 | workspace<br>复审开发启动、验收覆盖及发布依赖 | DOC-11 | 语义依赖修正、版本实施任务、基线/分发分类及契约映射要求、校验器保护 | 原范围状态保持,计划检查和故障负例通过,独立提交 DOC-12 | M | done |
|
||||
| DOC-13 | workspace<br>记录并验证内置浏览器回退规则 | DOC-08 | 根指令、复盘和夹具文档中的浏览器回退及实际环境证据 | 内置浏览器打开真实页面,报告基础检查结果及未覆盖项;独立提交 | L | done |
|
||||
| DOC-REVIEW-01 | workspace<br>记录用户主导复盘阶段启动 | DOC-08 | 实施及必要测试完成后交接、等待用户指导复盘的持久执行规则 | 根指令与复盘/AI流程一致;三轮保持待办,原依赖与发布门槛不变,不自动提前复盘 | L | done |
|
||||
|
||||
## 1 基线
|
||||
|
||||
@@ -461,7 +462,7 @@
|
||||
|
||||
| ID | 范围 / 步骤 | 前置依赖 | 交付物 | 验收条件 | 风险 | 状态 |
|
||||
| --- | --- | --- | --- | --- | --- | --- |
|
||||
| REVIEW-01 | workspace<br>第一轮全项目架构与兼容性复盘 | REL-02, CORE-22, SITE-04, DOC-08, MOD-01, MOD-02, MOD-03, CORE-25, ENG-13 | 22 包结构、类型、旧 API/路径、测试盲区和维护文档的逐包报告 | 本轮阻断项由独立修复任务关闭并复测;环境缺口转交下一轮,不宣称已发布就绪 | H | todo |
|
||||
| REVIEW-01 | workspace<br>第一轮全项目架构与兼容性复盘 | REL-02, CORE-22, SITE-04, DOC-08, MOD-01, MOD-02, MOD-03, CORE-25, ENG-13, DOC-REVIEW-01 | 22 包结构、类型、旧 API/路径、测试盲区和维护文档的逐包报告 | 本轮阻断项由独立修复任务关闭并复测;环境缺口转交下一轮,不宣称已发布就绪 | H | todo |
|
||||
| REVIEW-02 | workspace<br>第二轮真实浏览器与生态集成复盘 | REVIEW-01, REL-03 | Chrome 交互、自动浏览器、新旧组合、真机/SDK/性能/资源的全范围报告 | 所需环境证据齐全,前轮修复再次核对;本轮阻断项关闭,无关 mock 不替代真实验收 | H | todo |
|
||||
| REVIEW-03 | workspace<br>第三轮 npm 候选内容与发布准备复盘 | REVIEW-02, REL-04, CI-04 | 实际候选 integrity、干净安装构建/消费者、入口/许可/版本/tag/回退及前轮证据汇总 | 最终候选完整检查通过,发布阻断项为零;准备可审阅的批次报告,不自动执行 publish;逐包核对 major 目标,不能用大版本豁免旧 API 兼容 | H | todo |
|
||||
|
||||
@@ -738,3 +739,4 @@
|
||||
- CI-TYPES-02: [记录](changes/2026-09-15-CI-TYPES-02-ecosystem.md) [记录](baselines/ecosystem-types-validation.json)
|
||||
- SITE-EDITOR-VAST-01: [记录](changes/2026-09-15-SITE-EDITOR-VAST-01-consumer.md) [记录](baselines/editor-vast-consumer-validation.json) [记录](baselines/ci-source-firefox-validation.json) [记录](vast-type-decision.md)
|
||||
- CI-JASSUB-SOURCE-01: [记录](changes/2026-09-15-CI-JASSUB-SOURCE-01-native-inputs.md) [记录](baselines/jassub-source-selection-validation.json)
|
||||
- DOC-REVIEW-01: [记录](changes/2026-09-15-DOC-REVIEW-01-user-guidance.md) [记录](release-reviews.md) [记录](ai-workflow.md)
|
||||
@@ -1,5 +1,16 @@
|
||||
# 进度与证据
|
||||
|
||||
## DOC-REVIEW-01 用户主导复盘启动
|
||||
|
||||
用户明确要求实施完成后先不要复盘,由用户指导启动。已同步根AGENTS、
|
||||
release-reviews和ai-workflow:继续实施与必要测试,结束后交接并等待指示,
|
||||
不自动进入三轮复盘,也不提前开始首轮;原复盘及发布门槛保留。
|
||||
见[记录](changes/2026-09-15-DOC-REVIEW-01-user-guidance.md)。
|
||||
当前为218 done、21 doing、43 todo,共282;这项完成数仅代表执行规则文档。
|
||||
Firefox验收已提交9cfb6c8b9;当前没有浏览器测试进程运行,完整WebKit安装回归
|
||||
及其他实施任务仍待继续。减少重复运行和冗长输出,不推送或发布。
|
||||
|
||||
|
||||
## CI-01 完整 Firefox 安装包回归
|
||||
|
||||
固定b3344a7c6、Node24.21.0/Yarn1.22.22,复用5e0447fc5打包的run-cRduve;
|
||||
|
||||
@@ -2,6 +2,17 @@
|
||||
|
||||
2026-09-10 用户要求:实现完成后继续进行多次全局复盘,以达到可以发布到 npm 的质量。复盘是必须完成的验收工作;规划完成、源码迁移完成、发布就绪和实际发布分别报告。
|
||||
|
||||
## 当前启动规则:等待用户指导
|
||||
|
||||
2026-09-15 用户明确调整执行顺序:“当你完成了,先不要走复盘,让我来指导复盘”。
|
||||
继续完成已授权的重构实施和必要测试;实施完成后先交接实际结果、剩余问题与证据,
|
||||
等待用户明确指导和启动复盘。不得自动进入 REVIEW-01/02/03,也不提前启动首轮。
|
||||
下文关于首轮可以提前进行的安排仅表示技术依赖允许,不构成当前启动授权。
|
||||
|
||||
三轮复盘及发布门槛保持原样,待用户指导后按其范围和顺序执行。等待期间不得
|
||||
将复盘标为完成或声称发布就绪。日常实现自查、回归测试和已复现问题修复继续进行,
|
||||
不能把必要验证省略为节省token,也不为消耗剩余额度反复运行已经充分验证的内容。
|
||||
|
||||
## 浏览器验证的分工
|
||||
|
||||
本地验收优先复用 [docs HTML 与在线编辑器](docs-browser-testing.md),保留旧页面/参数并核实每个资源的候选来源。REVIEW-02 检查这些入口的实际行为,REVIEW-03 核对测试页面加载内容与待发布包一致。
|
||||
|
||||
+22
-1
@@ -5056,7 +5056,8 @@
|
||||
"MOD-02",
|
||||
"MOD-03",
|
||||
"CORE-25",
|
||||
"ENG-13"
|
||||
"ENG-13",
|
||||
"DOC-REVIEW-01"
|
||||
],
|
||||
"status": "todo",
|
||||
"risk": "H",
|
||||
@@ -6077,6 +6078,26 @@
|
||||
"changes/2026-09-15-CI-JASSUB-SOURCE-01-native-inputs.md",
|
||||
"baselines/jassub-source-selection-validation.json"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "DOC-REVIEW-01",
|
||||
"phase": "0 规划",
|
||||
"title": "记录用户主导复盘阶段启动",
|
||||
"scope": [
|
||||
"workspace"
|
||||
],
|
||||
"dependsOn": [
|
||||
"DOC-08"
|
||||
],
|
||||
"status": "done",
|
||||
"risk": "L",
|
||||
"deliverable": "实施及必要测试完成后交接、等待用户指导复盘的持久执行规则",
|
||||
"acceptance": "根指令与复盘/AI流程一致;三轮保持待办,原依赖与发布门槛不变,不自动提前复盘",
|
||||
"evidence": [
|
||||
"changes/2026-09-15-DOC-REVIEW-01-user-guidance.md",
|
||||
"release-reviews.md",
|
||||
"ai-workflow.md"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
Reference in new issue
Block a user