mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-14 06:34:30 +08:00
c44b0667b5
- 修复 ai-plan 治理 trace 中重复的 Markdown 标题并追加恢复点后缀，消除 MD024 锚点冲突 - 更新 ai-plan 治理 tracking，记录本次 PR review 修正和文本校验结果
59 lines
3.3 KiB
Markdown
59 lines
3.3 KiB
Markdown
# AI-Plan 治理追踪
|
||
|
||
## 2026-04-19
|
||
|
||
### 阶段：目录语义收口（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/`
|