mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 00:39:00 +08:00
bc3d50f07e
Fixed 6 file(s) based on 6 unresolved review comments. Co-authored-by: CodeRabbit <noreply@coderabbit.ai>
69 lines
4.2 KiB
Markdown
69 lines
4.2 KiB
Markdown
# AI-Plan 治理跟踪
|
||
|
||
## 目标
|
||
|
||
继续收口 `ai-plan/` 的目录语义、启动入口与归档策略，避免多 worktree 并行时的公共恢复文档持续膨胀并拖慢
|
||
`boot` 的上下文定位。
|
||
|
||
- 为 `ai-plan/` 建立明确的目录分层
|
||
- 区分“可提交共享状态”与“工作树私有状态”
|
||
- 明确禁止写入敏感数据、绝对路径和机器本地信息
|
||
- 让 `AGENTS.md`、`ai-plan/README.md` 与 boot skill 使用同一套目录语义
|
||
- 让 `boot` 能通过公共索引快速定位当前 worktree 的活跃主题
|
||
- 为阶段完成和主题完成两类归档建立稳定规则
|
||
|
||
## 当前恢复点
|
||
|
||
- 恢复点编号：`AI-PLAN-GOV-RP-005`
|
||
- 当前阶段：`Phase 3`
|
||
- 当前焦点：
|
||
- 将"主题内 `archive/` 已存在"升级为"active todo/trace 过长时必须归档已完成且已验证阶段"的显式规则
|
||
- 让 active `todos/` / `traces/` 只保留当前恢复点、活跃事实、活跃风险、下一步与 archive 指针
|
||
- 将 `ai-plan-governance`、`ai-first-config-system` 与 `cqrs-rewrite` 的历史阶段从默认启动入口移出
|
||
|
||
### 已知风险
|
||
|
||
- 归档遗漏：已完成且已验证的阶段未及时归档，导致 active 入口文件持续膨胀
|
||
- 缓解措施：只要某个 active 主题积累了多个已完成且已验证阶段，就在同一变更里将其细节迁入该主题自己的 `archive/`
|
||
- 入口回膨胀：后续新任务直接追加到 active 入口，而不是先归档历史
|
||
- 缓解措施：每次变更前先检查当前 active 入口行数，超过合理范围时优先归档已完成内容
|
||
- 跨文档语义漂移：tracking / trace / README 三个入口对同一主题的状态描述不一致
|
||
- 缓解措施：修改任一文档时同步检查其他入口，确保恢复点编号、阶段名称和下一步描述保持一致
|
||
|
||
## 已完成
|
||
|
||
- 已为活跃主题建立并使用主题内归档目录：
|
||
- `ai-plan/public/ai-plan-governance/archive/todos/`
|
||
- `ai-plan/public/ai-plan-governance/archive/traces/`
|
||
- `ai-plan/public/ai-first-config-system/archive/todos/`
|
||
- `ai-plan/public/ai-first-config-system/archive/traces/`
|
||
- `ai-plan/public/cqrs-rewrite/archive/todos/`
|
||
- `ai-plan/public/cqrs-rewrite/archive/traces/`
|
||
- 已将以下历史内容移出默认 boot 路径：
|
||
- `ai-plan-governance` 的 RP-002 至 RP-004 历史
|
||
- `ai-first-config-system` 截至 `2026-04-17` 的详细跟踪与执行 trace
|
||
- `cqrs-rewrite` 截至 `RP-043` 的详细跟踪与执行 trace
|
||
- 已同步更新 `AGENTS.md`、`ai-plan/README.md` 与 `gframework-boot`，明确 active 文档不是追加式日志，已完成且已验证阶段必须归档
|
||
|
||
## 验证
|
||
|
||
- `find ai-plan/public -maxdepth 5 -type f | sort`
|
||
- 结果：通过
|
||
- 备注：活跃主题、主题内归档文件与主题级归档都已按新目录语义落位
|
||
- `wc -l ai-plan/public/ai-plan-governance/todos/ai-plan-governance-tracking.md ai-plan/public/ai-plan-governance/traces/ai-plan-governance-trace.md ai-plan/public/ai-first-config-system/todos/ai-first-config-system-tracking.md ai-plan/public/ai-first-config-system/traces/ai-first-config-system-trace.md ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md`
|
||
- 结果：通过
|
||
- 备注：6 个 active 入口文件当前合计 `249` 行，已从治理前的 `3046` 行显著收短
|
||
- `dotnet build GFramework.Core.Abstractions/GFramework.Core.Abstractions.csproj -c Release -p:RestoreFallbackFolders=`
|
||
- 结果：通过
|
||
- 备注：`GFramework.Cqrs.Abstractions` 与 `GFramework.Core.Abstractions` 构建通过，`0 warning / 0 error`
|
||
|
||
## Archive Index
|
||
|
||
- 治理历史跟踪归档：[ai-plan-governance-history-rp002-rp004.md](../archive/todos/ai-plan-governance-history-rp002-rp004.md)
|
||
- 治理历史 trace 归档：[ai-plan-governance-history-rp002-rp004.md](../archive/traces/ai-plan-governance-history-rp002-rp004.md)
|
||
|
||
## 下一步
|
||
|
||
1. 后续只要某个 active 主题积累了多个已完成且已验证阶段，就在同一变更里将其细节迁入该主题自己的 `archive/`
|
||
2. 若某个主题整体完成，再将整个主题目录移入 `ai-plan/public/archive/<topic>/`
|
||
3. 后续新增 topic 时，默认直接创建 `todos/`、`traces/` 与 `archive/`，不要再把历史阶段长期堆在 active 入口 |