diff --git a/AGENTS.md b/AGENTS.md index e722bbe53..af31a9ec3 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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. diff --git a/refactor/ai-workflow.md b/refactor/ai-workflow.md index 2ae4773a3..164049ab8 100644 --- a/refactor/ai-workflow.md +++ b/refactor/ai-workflow.md @@ -34,6 +34,11 @@ AI 用于源码分析、任务拆分、实现、测试和差异审查。现代 ## 实现后 +2026-09-15 用户要求由其指导复盘:实施和必要验证完成后先交接,等待用户明确 +启动 REVIEW-01/02/03,不自动进行首轮或后续全局复盘。各任务日常自查和回归 +测试仍需完成;三轮复盘及发布门槛不删除、不标为已通过。以 +[当前复盘启动规则](release-reviews.md)为准,减少重复验证和冗长进度输出。 + 1. 执行受影响测试、类型检查、正常构建和必要浏览器 demo。 2. 用相同旧用户调用检查行为;记录有意差异和类型影响。 3. 做独立的一轮差异审查:公开签名、事件/Promise、资源清理、旧核心/插件、包入口。独立审查可由同一会话分轮执行,不要求创建代理。 diff --git a/refactor/changes/2026-09-15-DOC-REVIEW-01-user-guidance.md b/refactor/changes/2026-09-15-DOC-REVIEW-01-user-guidance.md new file mode 100644 index 000000000..1e31a1d5e --- /dev/null +++ b/refactor/changes/2026-09-15-DOC-REVIEW-01-user-guidance.md @@ -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`。 +无需浏览器重跑;回退文档提交也不能撤销用户在对话中作出的有效指示。 diff --git a/refactor/plan.md b/refactor/plan.md index 0d4dcbd37..e854cecfa 100644 --- a/refactor/plan.md +++ b/refactor/plan.md @@ -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
记录全部包各自升级一个大版本 | DOC-10 | 22 包目标版本清单、决策和发布/CI/复盘规则同步 | 版本表与 manifest 对照、计划检查通过并独立提交;不修改旧 API 兼容要求 | L | done | | DOC-12 | workspace
复审开发启动、验收覆盖及发布依赖 | DOC-11 | 语义依赖修正、版本实施任务、基线/分发分类及契约映射要求、校验器保护 | 原范围状态保持,计划检查和故障负例通过,独立提交 DOC-12 | M | done | | DOC-13 | workspace
记录并验证内置浏览器回退规则 | DOC-08 | 根指令、复盘和夹具文档中的浏览器回退及实际环境证据 | 内置浏览器打开真实页面,报告基础检查结果及未覆盖项;独立提交 | L | done | +| DOC-REVIEW-01 | workspace
记录用户主导复盘阶段启动 | DOC-08 | 实施及必要测试完成后交接、等待用户指导复盘的持久执行规则 | 根指令与复盘/AI流程一致;三轮保持待办,原依赖与发布门槛不变,不自动提前复盘 | L | done | ## 1 基线 @@ -461,7 +462,7 @@ | ID | 范围 / 步骤 | 前置依赖 | 交付物 | 验收条件 | 风险 | 状态 | | --- | --- | --- | --- | --- | --- | --- | -| REVIEW-01 | workspace
第一轮全项目架构与兼容性复盘 | 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
第一轮全项目架构与兼容性复盘 | 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
第二轮真实浏览器与生态集成复盘 | REVIEW-01, REL-03 | Chrome 交互、自动浏览器、新旧组合、真机/SDK/性能/资源的全范围报告 | 所需环境证据齐全,前轮修复再次核对;本轮阻断项关闭,无关 mock 不替代真实验收 | H | todo | | REVIEW-03 | workspace
第三轮 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) diff --git a/refactor/progress.md b/refactor/progress.md index 474d63919..811f6007a 100644 --- a/refactor/progress.md +++ b/refactor/progress.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; diff --git a/refactor/release-reviews.md b/refactor/release-reviews.md index cf557200d..0b650abbd 100644 --- a/refactor/release-reviews.md +++ b/refactor/release-reviews.md @@ -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 核对测试页面加载内容与待发布包一致。 diff --git a/refactor/tasks.json b/refactor/tasks.json index ef4270ec4..c00e92ace 100644 --- a/refactor/tasks.json +++ b/refactor/tasks.json @@ -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" + ] } ] }