mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 00:39:00 +08:00
docs(ai-plan): 收口PR299剩余追踪归档问题
- 更新 active tracking 与 latest validation，改为记录 PR #299 当前仅剩的 ai-plan review 项。 - 归档 RP-041 到 RP-048 的 trace 时间线，并把 active trace 收敛为恢复点、验证摘要与下一步。 - 补充 PR review 抓取与 docs 站点构建结果，保持本轮收口具备可追溯验证记录。
This commit is contained in:
gewuyou
parent
121479835a
commit
9888f80945
@ -1,5 +1,17 @@
|
||||
# Documentation Full Coverage Governance Validation History (RP-041 to RP-048)
|
||||
|
||||
## 2026-04-28 / RP-048 active tracking follow-up
|
||||
|
||||
### PR review 抓取
|
||||
|
||||
- `python3 .agents/skills/gframework-pr-review/scripts/fetch_current_pr_review.py --format json --json-output /tmp/current-pr-review.json`
|
||||
- 结果：通过；PR `#299` 处于 `OPEN`，latest head review 有 `1` 条 `CodeRabbit` open thread 与 `1` 条 nitpick，`Greptile` / `Gemini Code Assist` 当前无 open thread，测试汇总为 `2159 passed`，仅剩 `Title check` inconclusive。
|
||||
|
||||
### 站点构建
|
||||
|
||||
- `bun run build`（工作目录：`docs/`）
|
||||
- 结果：通过；active tracking 收口与时间线归档瘦身后站点仍可构建，仅保留既有大 chunk warning。
|
||||
|
||||
## 2026-04-28 / RP-048
|
||||
|
||||
### PR review 抓取
|
||||
|
||||
@ -0,0 +1,55 @@
|
||||
# Documentation Full Coverage Governance Trace History (RP-041 to RP-048)
|
||||
|
||||
## Scope
|
||||
|
||||
- 该归档记录 `RP-041` 到 `RP-048` 从 active trace 迁出的阶段性时间线，保留每轮恢复点、主要决策与停止条件。
|
||||
- 逐命令验证明细继续保存在：
|
||||
`ai-plan/public/documentation-full-coverage-governance/archive/todos/documentation-full-coverage-governance-validation-history-rp-041-to-rp-048-2026-04-28.md`
|
||||
|
||||
## 2026-04-28 / RP-048
|
||||
|
||||
- 通过 `$gframework-pr-review` 重新抓取 PR `#299` 后确认：latest head review 只剩 `1` 条 `CodeRabbit` open thread 与 `1` 条 nitpick，且都指向 active tracking 文档，而非公开文档页面本身。
|
||||
- 本地复核确认此前对抽象层入口语义化链接、生命周期入口示例与教程 / 排障页的修正已不再构成当前 remote latest-head review 的剩余阻塞。
|
||||
- 因此本轮收敛为 active tracking 收口：补齐 `RP-048` 下一步，并将 `RP-045` 到 `RP-047` 的逐命令历史从 active trace 下沉到 archive。
|
||||
|
||||
## 2026-04-27 / RP-047
|
||||
|
||||
- 第 `2` 批次提交 `2d2cd0c` 后，branch diff 相对 `origin/main` 为 `13` files / `124` lines，仍明显低于 `$gframework-batch-boot 50` 的 stop condition。
|
||||
- 最后一批集中收口 `core/query.md`、`core/command.md`、`core/context.md`、`game/scene.md`、`godot/ui.md`、`source-generators/priority-generator.md`、`core/lifecycle.md`、`game/ui.md`、`godot/scene.md`、`source-generators/context-aware-generator.md` 中依赖“旧文档 / 旧入口”对比的句式。
|
||||
- 在这里停止，不是因为达到阈值，而是因为剩余命中已转成需要人工判断是否保留迁移边界或 README 交叉引用的问题。
|
||||
|
||||
## 2026-04-27 / RP-046
|
||||
|
||||
- 第 `1` 批次提交 `c56260b` 后，branch diff 相对 `origin/main` 为 `7` files / `68` lines，仍远低于 stop condition。
|
||||
- 本轮继续处理 `docs/zh-CN/game/ui.md`、`godot/signal.md` 以及 `4` 个 source-generators 专题页，把直接暴露 `ai-libs/CoreGrid` 路径的公开说明改写为项目侧常见实现或典型入口组织方式。
|
||||
- 决策上继续保持单页文字级边界，不把 `ai-libs/**` 当成公开导航或消费者说明，并在每个稳定批次校验通过后立即提交，以便精确计量 branch diff。
|
||||
|
||||
## 2026-04-27 / RP-045
|
||||
|
||||
- 通过 `$gframework-batch-boot 50` 从零 diff 状态重新进入，沿用显式 `--git-dir` / `--work-tree` 绑定，确认当前分支仍为 `docs/sdk-update-documentation`，baseline 固定到最新本地 `origin/main` `7cfdd2c`。
|
||||
- 第 `1` 批次先处理 `docs/zh-CN/source-generators/index.md`、`game/index.md`、`api-reference/index.md`、`godot/setting.md`、`abstractions/index.md` 的 reader-facing 标题、描述与导航措辞，不改示例代码，也不扩栏目结构。
|
||||
- 当轮下一候选批次被限定为继续清理 `ai-libs/CoreGrid` 与“旧文档”式指向表达，保持风险最低且适合批处理。
|
||||
|
||||
## 2026-04-27 / RP-044
|
||||
|
||||
- 本轮从 `$gframework-pr-review` 重新进入，抓取 PR `#296` 后确认 latest reviewed commit 为 `5778782df05e22dd24dc95189dd768458afb8537`，共有 `4` 条 open thread。
|
||||
- 接受的仍成立问题集中在 `GFramework.Game.SourceGenerators/README.md` 的表头语义、`GFramework.Game/README.md` 的重复 `storage.md` 链接，以及 `docs/zh-CN/tutorials/godot-integration.md`、`docs/zh-CN/godot/extensions.md` 的 reader-facing 措辞收口。
|
||||
- 唯一 failed check `Title check` 被明确排除在仓库文件修复范围之外，本轮只做 review 指向文件的最小修正并同步 tracking / trace。
|
||||
|
||||
## 2026-04-27 / RP-043
|
||||
|
||||
- 在提交 `docs(reader-facing): 统一站内入口与公开术语` 后，branch diff 已到 `46` changed files，接近 `$gframework-batch-boot 50` 的停止线。
|
||||
- 因此最后只接受 `10` 个还没进入 branch diff 的文件，包括 `tutorials/godot-integration.md`、`game/setting.md`、`game/serialization.md`、`godot/index.md`、`godot/architecture.md`、`godot/storage.md`、`godot/logging.md`、`godot/setting.md`、`godot/extensions.md`、`core/architecture.md`。
|
||||
- 这些修正统一把 `旧文档`、`ai-libs`、`.Wait()`、`family` 等维护 / 内部口吻改成当前采用指导，并在验证通过后立即停止扩批。
|
||||
|
||||
## 2026-04-27 / RP-042
|
||||
|
||||
- 用户明确允许在 stop condition 内循环推进，并接受使用 subagent 降低主线程上下文压力；主线程保留实现与验证，把热点识别交给 `3` 个 explorer。
|
||||
- 接受的结论主要是：入口页应统一为 reader-facing 骨架；GitHub blob README 不应继续作为公开主导航；多个 README 与 Godot 页面还残留 `ai-libs`、`family`、`seam`、`ReadMe.md` 等对外不友好的表述。
|
||||
- 基于这些结论，连续落地了入口页改写、README / Godot 页面去内部口吻、以及 GitHub blob README 外链回归站内入口等 `3` 组低风险切片。
|
||||
|
||||
## 2026-04-27 / RP-041
|
||||
|
||||
- 这一轮用于提交后重算 branch diff，并确认在继续补一批新文件后，工作树已经来到 `46` changed files，足够触发“接近 stop condition 时收口”的策略。
|
||||
- 因此最后批次刻意限制在 `10` 个尚未进入 branch diff 的文件，并保持全部为 reader-facing 文案修正，不扩大到新结构或示例体系重写。
|
||||
- 验证通过后，将后续恢复建议切换为“下一轮从 PR review 或剩余未触达细页重新开一轮”，而不是在同一轮继续堆文件数。
|
||||
@ -15,17 +15,17 @@
|
||||
- 恢复点编号：`DOCUMENTATION-FULL-COVERAGE-GOV-RP-048`
|
||||
- 当前阶段：`Phase 5 - Governance Maintenance`
|
||||
- 当前焦点：
|
||||
- 按 `$gframework-pr-review` 复核 PR `#299` 的 latest-head review，并收口仍然成立的 3 条文件内问题：抽象层入口语义化链接、架构生命周期入口示例、active tracking 验证历史归档瘦身
|
||||
- 按 `$gframework-pr-review` 复核 PR `#299` 的 latest-head review，并收口当前仍成立的 active tracking 问题：补齐 `RP-048` 下一步，以及把 `RP-045` 到 `RP-047` 的逐命令历史迁入归档
|
||||
- 本轮通过 `$gframework-batch-boot 50` 重新进入后确认 `HEAD == origin/main`，当前已提交 branch diff 为 `0` files / `0` lines，因此可以从新的低风险文档批次重新累计阈值
|
||||
- 当前已完成 4 个低风险批次，并在本轮额外完成 1 次 review-driven 收口：入口页 reader-facing 标题统一、内部参考路径去暴露，以及 `Core` / `Game` / `Godot` / `source-generators` 多个页面中“旧文档式对比”提示的直接契约化改写
|
||||
- 第 2 个已提交批次结束时，branch diff 相对 `origin/main` 为 `13` files / `124` lines；本轮最后一批提交后仍会明显低于 `50` 文件 stop condition
|
||||
- 本轮已确认 `Architecture` 只暴露 `OnInitialize()`，`AbstractArchitecture` 通过 `InstallModules()` 暴露模块注册入口，而组件级 `OnInit()` 仍然是当前有效生命周期
|
||||
- 当前建议在本轮停止：PR `#299` 剩余 `Title check` 只是 GitHub 侧 PR 标题元数据提示，不是仓库文件内的阻塞问题
|
||||
- 当前建议在本轮停止：active tracking 收口完成并推送后，只需重新抓取 PR `#299`，确认剩余项是否只剩 GitHub 侧 `Title check` 元数据提示
|
||||
|
||||
## 当前状态摘要
|
||||
|
||||
- `Core`、`Ecs.Arch`、`Cqrs`、`Game`、`Godot` 五个模块族当前都已有 README / landing / topic / API 参考层级的已验证入口。
|
||||
- `2026-04-28` 已抓取 PR `#299` 并复核 latest-head review：`CodeRabbit` 的 `3` 条 open thread 在本地都仍成立，现已分别收口为抽象层入口语义化链接、生命周期入口澄清、以及 active tracking 验证历史归档；`Greptile` / `Gemini Code Assist` 当前无 open thread，`Title check` 仍是 PR 元数据问题。
|
||||
- `2026-04-28` 已重新抓取 PR `#299` 并复核 latest-head review：remote 当前只剩 `1` 条 `CodeRabbit` open thread 与 `1` 条 nitpick，且都指向 active tracking 文档；`Greptile` / `Gemini Code Assist` 当前无 open thread，测试汇总为 `2159 passed`，`Title check` 仍是 PR 元数据问题。
|
||||
- `2026-04-25` 已重新抓取 PR `#290` 并确认：latest reviewed commit 为 `54b8e5770af9ab3c8a86a396ffa4794fe4bb5181`，open thread 聚焦在 `docs/.vitepress/config.mts` 的侧栏重复 / 标签不一致，以及 `GFramework.Core`、`GFramework.Ecs.Arch`、`GFramework.Game` README 的 reader-facing 表格残留治理字段。
|
||||
- `2026-04-25` `docs/.vitepress/config.mts` 已保留 `source-generators` 栏目自有子页导航，但不再让 `api-reference` 侧栏重复跳回 `core`、`game`、`godot`、`ecs` 等独立栏目入口。
|
||||
- `2026-04-25` `GFramework.Core/README.md`、`GFramework.Ecs.Arch/README.md`、`GFramework.Game/README.md` 当前把 XML 阅读表统一收敛为“代表类型 + 阅读重点”，不再暴露日期、覆盖计数或 `已覆盖` 这类治理式字段。
|
||||
@ -65,7 +65,7 @@
|
||||
- 当前 WSL 会话里 `git.exe` 可解析但不能执行，应继续使用显式 `--git-dir` / `--work-tree` 绑定作为默认 Git 策略。
|
||||
- `dotnet build GFramework.csproj -c Release` 当前仍会输出仓库既有 analyzer warnings（如 `MA0158`、`MA0051`、`MA0004`）；本轮仅修改文档与 package metadata，不扩展到 warning 清理。
|
||||
- 当前 batch boot 已从 `origin/main` 零 diff 状态重新起步并完成 4 个低风险文案批次；剩余命中更偏向是否保留迁移说明的编辑判断，不再适合继续按同一批处理模式机械推进。
|
||||
- PR `#299` 当前仅剩 `Title check` inconclusive；这需要直接修改 GitHub 上的 PR 标题，而不是继续改仓库文件。
|
||||
- PR `#299` 在 remote latest-head review 中仍显示 `1` 条 open thread 与 `1` 条 nitpick，直到本轮 `ai-plan` 改动推送后才会反映关闭状态；`Title check` 仍需要直接修改 GitHub 上的 PR 标题。
|
||||
|
||||
## 归档指针
|
||||
|
||||
@ -79,31 +79,23 @@
|
||||
`ai-plan/public/documentation-full-coverage-governance/archive/traces/documentation-full-coverage-governance-trace-history-through-rp-016.md`
|
||||
- 时间线归档（`RP-023` 到 `RP-025`）：
|
||||
`ai-plan/public/documentation-full-coverage-governance/archive/traces/documentation-full-coverage-governance-trace-history-rp-023-to-rp-025-2026-04-24.md`
|
||||
- 时间线归档（`RP-041` 到 `RP-048`）：
|
||||
`ai-plan/public/documentation-full-coverage-governance/archive/traces/documentation-full-coverage-governance-trace-history-rp-041-to-rp-048-2026-04-28.md`
|
||||
- 验证历史归档（`RP-041` 到 `RP-048`）：
|
||||
`ai-plan/public/documentation-full-coverage-governance/archive/todos/documentation-full-coverage-governance-validation-history-rp-041-to-rp-048-2026-04-28.md`
|
||||
|
||||
## 最新验证
|
||||
|
||||
- `2026-04-28` `python3 .agents/skills/gframework-pr-review/scripts/fetch_current_pr_review.py --format json --json-output /tmp/current-pr-review.json`
|
||||
- 结果：通过；PR `#299` 处于 `OPEN`，latest head review 有 `3` 条 `CodeRabbit` open thread，`Greptile` / `Gemini Code Assist` 当前无 open thread，测试汇总为 `2159 passed`，仅剩 `Title check` inconclusive。
|
||||
- `2026-04-28` 页面校验：
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/abstractions/index.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/core/lifecycle.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/tutorials/state-machine-tutorial.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/tutorials/resource-management.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/tutorials/save-system.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/tutorials/pause-system.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/tutorials/large-project-organization.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/troubleshooting.md`
|
||||
- 结果：通过；本轮触达页面的 frontmatter、链接与代码块校验均通过。
|
||||
- 结果：通过；PR `#299` 处于 `OPEN`，latest head review 有 `1` 条 `CodeRabbit` open thread 与 `1` 条 nitpick，`Greptile` / `Gemini Code Assist` 当前无 open thread，测试汇总为 `2159 passed`，仅剩 `Title check` inconclusive。
|
||||
- `2026-04-28` `bun run build`（工作目录：`docs/`）
|
||||
- 结果：通过；PR `#299` review follow-up 的文档修正与 active tracking 归档瘦身后站点仍可构建，仅保留既有大 chunk warning。
|
||||
- 结果：通过；active tracking 收口与时间线归档瘦身后站点仍可构建，仅保留既有大 chunk warning。
|
||||
- `2026-04-27` 到 `2026-04-28` 的详细逐命令验证历史已迁入：
|
||||
`ai-plan/public/documentation-full-coverage-governance/archive/todos/documentation-full-coverage-governance-validation-history-rp-041-to-rp-048-2026-04-28.md`
|
||||
|
||||
## 下一步
|
||||
|
||||
1. 推送本轮提交后，优先重新抓取 `$gframework-pr-review`，确认 PR `#299` 仅剩标题元数据提示或已全部清空。
|
||||
2. 若后续继续文档治理，优先人工复核尚未触达的 `Game` persistence、Godot runtime 细页与少量残余迁移边界表述，而不是继续按关键词机械扩批。
|
||||
2. 若 remote review 清空后仍继续文档治理，优先人工复核尚未触达的 `Game` persistence、Godot runtime 细页与少量残余迁移边界表述，而不是继续按关键词机械扩批。
|
||||
3. 若后续分支继续调整 `Game` persistence runtime、README 或公共 API，优先复核 `docs/zh-CN/game/data.md`、`storage.md`、`serialization.md`、`setting.md` 与 landing page 是否仍保持同一套职责边界。
|
||||
4. 若后续分支继续调整 `Godot` generator 接法，优先复核 `GFramework.Godot.SourceGenerators/README.md`、`docs/zh-CN/tutorials/godot-integration.md` 与相关专题页是否仍保持一致。
|
||||
|
||||
@ -4,117 +4,44 @@
|
||||
|
||||
### 当前恢复点：RP-048
|
||||
|
||||
- 本轮按 `$gframework-pr-review` 抓取当前 PR `#299`，并确认 latest head review 仍有 `3` 条 `CodeRabbit` open thread；`Greptile` 与 `Gemini Code Assist` 当前无 open thread，测试汇总为 `2159 passed`，仅剩 `Title check` inconclusive。
|
||||
- 本地复核源码后确认：`GFramework.Core/Architectures/Architecture.cs` 只暴露架构级 `OnInitialize()`；`GFramework.Godot/Architectures/AbstractArchitecture.cs` 通过 `InstallModules()` 暴露模块注册入口；组件级 `OnInit()` 仍是 `Model` / `System` 的正确生命周期。
|
||||
- 仍成立的文件内问题只有三类：`docs/zh-CN/abstractions/index.md` 的原始文件名式导航、`docs/zh-CN/core/lifecycle.md` 与 `tutorials` / `troubleshooting` 里的架构级旧 `Init()` 示例、以及 active tracking 中过长的逐命令验证历史。
|
||||
- 本轮按 `$gframework-pr-review` 抓取当前 PR `#299`，确认 latest head review 当前只剩 `1` 条 `CodeRabbit` open thread 与 `1` 条 nitpick；两者都指向 active tracking 文档本身，`Greptile` 与 `Gemini Code Assist` 当前无 open thread，测试汇总为 `2159 passed`，另有 `Title check` inconclusive。
|
||||
- 本地复核后确认：此前针对 `docs/zh-CN/abstractions/index.md`、`docs/zh-CN/core/lifecycle.md` 与相关教程 / 排障页的 review follow-up 已不再是当前 remote latest-head review 的剩余阻塞项。
|
||||
- 当前仍需收口的只剩两件事：为 `RP-048` 补齐明确的“下一步”段落，以及把 `RP-045` 到 `RP-047` 的逐命令时间线从 active trace 下沉到归档文件。
|
||||
|
||||
### 当前决策（RP-048）
|
||||
|
||||
- 在同一轮里收口所有仍然适用于仓库文件的 open thread；不把 `Title check` 当成仓库文件修复项。
|
||||
- 普通 `Architecture` 示例统一改回 `OnInitialize()`，`AbstractArchitecture` 示例改成 `InstallModules()`，组件级 `OnInit()` 示例保持不变。
|
||||
- 将 active tracking 的“最新验证”压缩为摘要，把详细命令历史迁入新的 `archive/todos` 文件，避免默认恢复入口继续膨胀。
|
||||
- 本轮限定只修改 `ai-plan/public/documentation-full-coverage-governance` 下的 tracking / trace 文档，不再扩展到已经收口的公开文档页面。
|
||||
- active trace 只保留当前恢复点、验证结论、下一步与归档指针；`RP-041` 到 `RP-048` 的阶段细节转入专门的 trace archive，逐命令验证继续保留在 validation history archive。
|
||||
- 不把 `Title check` 当成仓库文件修复项；本轮完成后只需要在提交推送后重新抓取 PR review，确认 remote 线程状态是否清空。
|
||||
|
||||
### 当前验证（RP-048）
|
||||
|
||||
- PR review 抓取：
|
||||
- `python3 .agents/skills/gframework-pr-review/scripts/fetch_current_pr_review.py --format json --json-output /tmp/current-pr-review.json`
|
||||
- 结果：通过；PR `#299` 处于 `OPEN`，latest head review 有 `3` 条 `CodeRabbit` open thread，`Greptile` / `Gemini Code Assist` 当前无 open thread，测试汇总为 `2159 passed`，仅剩 `Title check` inconclusive。
|
||||
- 页面校验：
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/abstractions/index.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/core/lifecycle.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/tutorials/state-machine-tutorial.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/tutorials/resource-management.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/tutorials/save-system.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/tutorials/pause-system.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/tutorials/large-project-organization.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/troubleshooting.md`
|
||||
- 结果：通过；本轮触达页面的 frontmatter、链接与代码块校验均通过。
|
||||
- 结果：通过；PR `#299` 处于 `OPEN`，latest head review 有 `1` 条 `CodeRabbit` open thread 与 `1` 条 nitpick，`Greptile` / `Gemini Code Assist` 当前无 open thread，测试汇总为 `2159 passed`，仅剩 `Title check` inconclusive。
|
||||
- 站点构建：
|
||||
- `bun run build`（工作目录：`docs/`）
|
||||
- 结果：通过；PR `#299` review follow-up 的文档修正与 active tracking 归档瘦身后站点仍可构建，仅保留既有大 chunk warning。
|
||||
- 结果：通过；active tracking 收口与时间线归档瘦身后站点仍可构建，仅保留既有大 chunk warning。
|
||||
- 详细时间线归档：
|
||||
- `ai-plan/public/documentation-full-coverage-governance/archive/traces/documentation-full-coverage-governance-trace-history-rp-041-to-rp-048-2026-04-28.md`
|
||||
- 详细验证归档：
|
||||
- `ai-plan/public/documentation-full-coverage-governance/archive/todos/documentation-full-coverage-governance-validation-history-rp-041-to-rp-048-2026-04-28.md`
|
||||
|
||||
### 下一步（RP-048）
|
||||
|
||||
1. 提交本轮 active tracking 收口改动，并将提交推送到 PR `#299`。
|
||||
2. 推送后重新抓取 `$gframework-pr-review`，确认 latest-head review 是否只剩 `Title check` 或已全部清空。
|
||||
3. 若仍有新的文档 review 线程，继续按 latest-head review 精确收口，不恢复关键词驱动的机械扩批。
|
||||
|
||||
## 2026-04-27
|
||||
|
||||
### 当前恢复点：RP-047
|
||||
### 已归档历史（RP-041 到 RP-047）
|
||||
|
||||
- 第 2 批次提交 `2d2cd0c` 后，重新计算 branch diff 确认当前相对 `origin/main` 为 `13` files / `124` lines，仍然远低于 `$gframework-batch-boot 50` 的 stop condition。
|
||||
- 本轮最后继续接受两组同类低风险文案收口：`core/query.md`、`core/command.md`、`core/context.md`、`game/scene.md`、`godot/ui.md`、`source-generators/priority-generator.md`，以及 `core/lifecycle.md`、`game/ui.md`、`godot/scene.md`、`source-generators/context-aware-generator.md`。
|
||||
- 这 10 个页面的共同点是：把“旧文档/旧入口对比”句式改成直接陈述当前契约、默认入口或推荐做法，不引入结构改造，也不删掉真实的迁移边界信息。
|
||||
|
||||
### 当前决策（RP-047）
|
||||
|
||||
- 将第 3、4 批次合并为本轮最后一个提交，避免继续把批次拆得过碎，同时仍保持文件范围可审阅。
|
||||
- 本轮在这里停止，不是因为触达了 `50` 文件阈值，而是因为剩余命中已经从机械可收口的 reader-facing 文案问题，转成是否保留迁移信息或 README 交叉引用的编辑判断题。
|
||||
- 下一轮若继续，优先从剩余 `旧文档` / `README.md` / `先理解` 命中里做人工复核，而不是继续按关键词机械替换。
|
||||
|
||||
### 当前验证（RP-047）
|
||||
|
||||
- 页面校验：
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/core/query.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/core/command.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/core/context.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/game/scene.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/game/ui.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/godot/ui.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/source-generators/priority-generator.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/core/lifecycle.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/godot/scene.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/source-generators/context-aware-generator.md`
|
||||
- 结果：通过；本轮最后 10 个公开页面的 frontmatter、链接与代码块校验均通过。
|
||||
- 站点构建：
|
||||
- `bun run build`（工作目录：`docs/`）
|
||||
- 结果：通过；本轮 batch boot 第 3、4 批次的 10 个公开页面 reader-facing 收口后站点仍可构建，仅保留既有大 chunk warning。
|
||||
|
||||
### 当前恢复点：RP-046
|
||||
|
||||
- 第 1 批次提交 `c56260b` 后，重新计算 branch diff 确认当前相对 `origin/main` 为 `7` files / `68` lines，仍远低于 `$gframework-batch-boot 50` 的 stop condition。
|
||||
- 基于上一轮搜索结果，本轮继续接收一组同样低风险的公开文案收口：`docs/zh-CN/game/ui.md`、`godot/signal.md` 以及 4 个 source-generators 专题页中直接暴露 `ai-libs/CoreGrid` 路径的段落。
|
||||
- 这些页面都只是把内部参考项目路径改写为“项目侧常见实现”或“典型入口组织方式”，不改变示例代码、采用顺序或专题页结构。
|
||||
|
||||
### 当前决策（RP-046）
|
||||
|
||||
- 第 2 批次继续保持单页文字级修正边界，不把 `ai-libs/**` 当成公开文档里的直接导航或消费者说明。
|
||||
- 在站点构建通过后立即提交本批次，以便 branch diff 能继续被 stop condition 精确计量。
|
||||
- 当前下一候选批次是清理仍残留在若干公开页面中的“旧文档式对比”提示，继续限定为文案级收口。
|
||||
|
||||
### 当前验证（RP-046）
|
||||
|
||||
- 页面校验：
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/game/ui.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/godot/signal.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/source-generators/godot-project-generator.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/source-generators/get-node-generator.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/source-generators/bind-node-signal-generator.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/source-generators/auto-register-exported-collections-generator.md`
|
||||
- 结果：通过；本轮 6 个公开页面的 frontmatter、链接与代码块校验均通过。
|
||||
- 站点构建：
|
||||
- `bun run build`（工作目录：`docs/`）
|
||||
- 结果：通过；本轮 batch boot 第 2 批次的 6 个公开页面 reader-facing 收口后站点仍可构建，仅保留既有大 chunk warning。
|
||||
|
||||
### 当前恢复点：RP-045
|
||||
|
||||
- 本轮通过 `$gframework-batch-boot 50` 重新进入，继续沿用显式 `--git-dir` / `--work-tree` 绑定确认当前分支仍为 `docs/sdk-update-documentation`，并按技能要求把 baseline 固定到最新本地 `origin/main` `7cfdd2c`（`2026-04-27 16:59:57 +08:00`）。
|
||||
- 重新计算 branch diff 后确认当前已提交范围相对 `origin/main` 为 `0` files / `0` lines；原因是本分支先前工作已经并入 `origin/main`，因此这一轮 batch boot 需要从零 diff 状态重新累计 stop condition。
|
||||
- 结合公开文档搜索结果，本轮先挑一组最稳的 reader-facing 入口页收口：`docs/zh-CN/source-generators/index.md`、`game/index.md`、`api-reference/index.md`、`godot/setting.md`、`abstractions/index.md`。
|
||||
|
||||
### 当前决策（RP-045）
|
||||
|
||||
- 第 1 批次只处理标题、描述和导航措辞，不改示例代码、不扩栏目结构，确保本轮重新起步时的风险保持最低。
|
||||
- 由于 branch-size stop condition 只统计已提交 diff，本轮应在每个稳定批次校验通过后尽快提交，再决定是否继续下一批。
|
||||
- 当前下一候选批次是清理公开文档里残留的 `ai-libs/CoreGrid` / `旧文档` 指向式表述，继续保持单页文案级修正边界。
|
||||
|
||||
### 当前验证（RP-045）
|
||||
|
||||
- 页面校验：
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/source-generators/index.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/game/index.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/api-reference/index.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/godot/setting.md`
|
||||
- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/abstractions/index.md`
|
||||
- 结果：通过；本轮 5 个 reader-facing 入口页的 frontmatter、链接与代码块校验均通过。
|
||||
- 站点构建：
|
||||
- `bun run build`（工作目录：`docs/`）
|
||||
- 结果：通过；本轮 batch boot 第 1 批次的 5 个入口页 reader-facing 收口后站点仍可构建，仅保留既有大 chunk warning。
|
||||
- `RP-045` 到 `RP-047` 的 batch boot 逐阶段时间线、branch diff 计量与 review follow-up 决策，已迁入专门的 trace archive，避免 active trace 继续保留逐命令历史。
|
||||
- 对应的页面校验、README 链接校验与站点构建命令，继续保留在 validation history archive 中，供后续追溯。
|
||||
- 归档路径：
|
||||
- `ai-plan/public/documentation-full-coverage-governance/archive/traces/documentation-full-coverage-governance-trace-history-rp-041-to-rp-048-2026-04-28.md`
|
||||
- `ai-plan/public/documentation-full-coverage-governance/archive/todos/documentation-full-coverage-governance-validation-history-rp-041-to-rp-048-2026-04-28.md`
|
||||
|
||||
### 当前恢复点：RP-044
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user