mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-14 14:58:58 +08:00
406e6f1926
- 迁移 feat/ai-first-config 工作树的 tracking、next 与 trace 文档到 ai-plan/public/ai-first-config-system\n- 更新 ai-plan 公共索引与治理跟踪，登记当前分支的活跃主题映射\n- 清理 旧本地恢复入口并补充迁移后的结构校验与最小构建验证
85 lines
4.7 KiB
Markdown
85 lines
4.7 KiB
Markdown
# 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/`
|