mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-07 00:39:00 +08:00

GeWuYou c44b0667b5 docs(ai-plan): 修复治理追踪锚点冲突

- 修复 ai-plan 治理 trace 中重复的 Markdown 标题并追加恢复点后缀，消除 MD024 锚点冲突
- 更新 ai-plan 治理 tracking，记录本次 PR review 修正和文本校验结果

2026-04-19 11:35:26 +08:00

AI-Plan 治理追踪

2026-04-19

建立 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 私有目录

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
- 结果：通过

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

建立 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 以新层级进入版本控制

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
- 结果：通过