gewuyou/GFramework
1
0
Fork 0
mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-07 00:39:00 +08:00
Code Issues Packages Projects Releases Wiki Activity
GFramework/ai-plan/public/ai-plan-governance/archive/traces/ai-plan-governance-history-rp002-rp004.md
GeWuYou 9b904709d6 docs(ai-plan): 收口主题内归档与恢复入口 
- 新增 活跃主题的 archive 目录并归档已完成且已验证的历史 tracking 与 trace\n- 更新 ai-plan 治理规则、README 与 boot skill，明确 active todo 和 trace 必须保持精简\n- 收短 ai-plan-governance、ai-first-config-system 与 cqrs-rewrite 的默认恢复入口并补充归档索引
2026-04-19 15:11:50 +08:00

4.7 KiB
Raw Blame History

AI-Plan 治理追踪

2026-04-19

阶段：遗留 local-plan 收口（RP-004）

  • 建立 AI-PLAN-GOV-RP-004 恢复点
  • 发现当前 worktree feat/ai-first-config 仍保留旧 local-plan/，说明主题化 ai-plan/public/<topic>/ 落地后还有遗留入口未收口
  • 已据此完成本轮治理补齐：
    • 新增 ai-plan/public/ai-first-config-system/ 主题目录，并迁入 tracking / next / trace 文档
    • 在 ai-plan/public/README.md 为 feat/ai-first-config 绑定 ai-first-config-system
    • 将迁移后的公共文档中的 local-plan 旧路径引用更新为新的 ai-plan/public/... 路径
    • 将绝对路径、宿主 NuGet fallback 目录和 GIT_DIR / GIT_WORK_TREE 命令细节改写为可提交的公共表述

验证（RP-004）

  • find ai-plan/public/ai-first-config-system -maxdepth 3 -type f | sort
    • 结果：通过
  • rg -n "local-plan|D:\\\\|/mnt/|GIT_DIR=" ai-plan/public/ai-first-config-system
    • 结果：通过
  • test ! -e local-plan
    • 结果：通过
  • dotnet build GFramework.Core.Abstractions/GFramework.Core.Abstractions.csproj -c Release -p:RestoreFallbackFolders=
    • 结果：通过

下一步（RP-004）

  1. 后续若发现其他 worktree 仍有旧恢复文档，沿用“主题目录迁移 + 索引登记 + 公共内容清洗”同一流程处理
  2. 若某个主题后续再分阶段沉淀恢复文档，优先收入该主题自己的 archive/，避免活动入口再次膨胀

阶段：目录语义收口（RP-002）

  • 建立 AI-PLAN-GOV-RP-002 恢复点
  • 用户指出当前 ai-plan/ 存在三个治理问题：
    • 缺少更细的目录分层，容易随着 worktree 增长持续膨胀
    • 缺少“不得写入敏感数据、真实路径、机器信息”的明确约束
    • 目录语义没有区分共享恢复信息与 worktree 私有状态
  • 已据此完成以下收口：
    • 将既有共享 tracking / trace 文件迁移到扁平的 ai-plan/public/ 共享目录
    • 新增 ai-plan/private/ 作为工作树私有恢复空间，并通过 .gitignore 保持未跟踪
    • 新增 ai-plan/README.md 作为目录语义与内容规范的单点说明
    • 在 AGENTS.md 中补齐 public/private 职责边界，以及敏感信息与绝对路径禁写规则
    • 在 gframework-boot 中同步新的读取顺序：优先 public，按需读取当前 worktree 私有目录

验证（RP-002）

  • find ai-plan -maxdepth 3 -type f | sort
    • 结果：通过
  • rg -n "ai-plan/public/|ai-plan/private/" AGENTS.md .codex/skills/gframework-boot/SKILL.md .codex/skills/gframework-boot/references/startup-artifacts.md ai-plan/README.md .gitignore
    • 结果：通过
  • dotnet build GFramework.Core.Abstractions/GFramework.Core.Abstractions.csproj -c Release
    • 结果：通过

下一步（RP-002）

  1. 后续若出现新的 worktree 私有恢复需求，直接在 ai-plan/private/<branch-or-worktree>/ 下创建，不再向共享目录追加本地临时状态
  2. 若将来需要进一步限制格式，可再为 public/** 与 private/ 各自补一个模板文件，但本轮先把目录语义和安全边界固定下来

阶段：主题分组与启动索引（RP-003）

  • 建立 AI-PLAN-GOV-RP-003 恢复点
  • 用户进一步指出：即使 public/private 已分层，只要多 worktree 并行，扁平的活动主题集合仍会让 boot 随着 ai-plan/public 增长而退化成大范围扫描
  • 已据此完成第二轮治理：
    • 将活动共享文档迁移到 ai-plan/public/<topic>/todos/ 与 ai-plan/public/<topic>/traces/
    • 新增 ai-plan/public/README.md 作为公共启动索引，维护 worktree 到多个活跃主题的映射与优先顺序
    • 将已完成的 cqrs-cache-docs-hardening 整体移入 ai-plan/public/archive/cqrs-cache-docs-hardening/
    • 在 AGENTS.md、ai-plan/README.md、根 README.md 与 gframework-boot 中统一“公共索引 + 活动主题 + 主题内归档 + 主题级归档”的语义
    • 将 .gitignore 调整为允许 ai-plan/public/**/*.md 以新层级进入版本控制

验证（RP-003）

  • find ai-plan/public -maxdepth 4 -type f | sort
    • 结果：通过
  • rg -n "ai-plan/public/README.md|ai-plan/public/<topic>|ai-plan/public/archive|ai-plan/private/" AGENTS.md .codex/skills/gframework-boot/SKILL.md .codex/skills/gframework-boot/references/startup-artifacts.md ai-plan/README.md README.md .gitignore
    • 结果：通过
  • dotnet build GFramework.Core.Abstractions/GFramework.Core.Abstractions.csproj -c Release --no-restore
    • 结果：通过

下一步（RP-003）

  1. 未来每次新增或关闭主题，都同步更新 ai-plan/public/README.md，不要让 boot 回到全量扫描模式
  2. 若某个活跃主题内部继续积累阶段性完成物，优先收入该主题目录下的 archive/