mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-14 14:58:58 +08:00
c82518aa0d
- 重构 ai-plan public 结构为按主题分组并引入归档层级 - 新增 public README worktree 映射并同步 boot 启动入口 - 更新治理 tracking trace 与仓库文档中的 ai-plan 路径约定
61 lines
3.3 KiB
Markdown
61 lines
3.3 KiB
Markdown
# AI-Plan 治理跟踪
|
|
|
|
## 目标
|
|
|
|
继续收口 `ai-plan/` 的目录语义、启动入口与归档策略，避免多 worktree 并行时的公共恢复文档持续膨胀并拖慢
|
|
`boot` 的上下文定位。
|
|
|
|
- 为 `ai-plan/` 建立明确的目录分层
|
|
- 区分“可提交共享状态”与“工作树私有状态”
|
|
- 明确禁止写入敏感数据、绝对路径和机器本地信息
|
|
- 让 `AGENTS.md`、`ai-plan/README.md` 与 boot skill 使用同一套目录语义
|
|
- 让 `boot` 能通过公共索引快速定位当前 worktree 的活跃主题
|
|
- 为阶段完成和主题完成两类归档建立稳定规则
|
|
|
|
## 当前恢复点
|
|
|
|
- 恢复点编号：`AI-PLAN-GOV-RP-003`
|
|
- 当前阶段：`Phase 2`
|
|
- 当前焦点：
|
|
- 已将共享恢复文档按主题迁移到 `ai-plan/public/<topic>/todos/` 与 `ai-plan/public/<topic>/traces/`
|
|
- 已为 `boot` 新增 `ai-plan/public/README.md` 公共索引，并绑定当前 worktree 的活跃主题顺序
|
|
- 已将完成度更高的 `cqrs-cache-docs-hardening` 移入 `ai-plan/public/archive/`
|
|
- 已同步更新 `.gitignore`、`AGENTS.md`、`ai-plan/README.md`、根 `README.md` 与 `gframework-boot`
|
|
- 已明确主题内归档与主题级归档的双层规则，避免活动区无限增长
|
|
|
|
## 已完成
|
|
|
|
- `.gitignore` 现允许 `ai-plan/public/**/*.md` 以主题目录与归档目录形式进入版本控制
|
|
- `AGENTS.md` 已补充：
|
|
- `public/README.md`、活动主题目录、主题内归档与主题级归档的职责划分
|
|
- `boot` 默认忽略 `ai-plan/public/archive/**`
|
|
- worktree 与活跃主题映射变化时，必须同步更新公共索引
|
|
- `.codex/skills/gframework-boot/SKILL.md` 与其 `references/startup-artifacts.md` 已切换到：
|
|
- 优先读取 `ai-plan/public/README.md`
|
|
- 命中映射后优先读取对应主题目录
|
|
- 未命中映射时再扫描活动主题目录，并排除公共归档区
|
|
- `ai-plan/README.md` 已补充主题命名、归档触发条件与 `boot` 读取顺序
|
|
- 根 `README.md` 已改为要求维护公共索引与对应主题目录
|
|
- 现有共享文档已迁移为：
|
|
- `ai-plan/public/ai-plan-governance/**`
|
|
- `ai-plan/public/cqrs-rewrite/**`
|
|
- `ai-plan/public/archive/cqrs-cache-docs-hardening/**`
|
|
|
|
## 验证
|
|
|
|
- `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`
|
|
- 结果：通过
|
|
- 备注：新目录语义、索引入口与归档规则已统一到仓库规则与 boot skill
|
|
- `dotnet build GFramework.Core.Abstractions/GFramework.Core.Abstractions.csproj -c Release --no-restore`
|
|
- 结果：通过
|
|
- 备注：本轮规则与文档调整未引入构建问题
|
|
|
|
## 下一步
|
|
|
|
1. 后续新增活动主题时，先在 `ai-plan/public/README.md` 登记 worktree 到主题映射，再创建对应主题目录
|
|
2. 阶段完成后优先收入主题内 `archive/`；主题整体完成后，再整目录移入 `ai-plan/public/archive/`
|
|
3. 若未来再新增 skill 或仓库规则引用 `ai-plan/`，统一按“公共索引 + 活动主题 + 归档主题 + 私有目录”扩展，不再恢复平铺结构
|