GFramework/ai-plan/public/traces/ai-plan-governance-trace.md
gewuyou 6ab32032bc refactor(repo): 重构ai-plan目录语义
- 重命名 local-plan 为 ai-plan,并收口 public 与 private 的目录语义
- 更新 AGENTS、README 与 boot skill 的恢复文档路径和安全约束
- 迁移共享 tracking 与 trace 文件到 ai-plan/public,并补充治理说明文档
2026-04-19 03:18:46 +08:00

32 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# AI-Plan 治理追踪
## 2026-04-19
### 阶段目录语义收口RP-002
- 建立 `AI-PLAN-GOV-RP-002` 恢复点
- 用户指出当前 `ai-plan/` 存在三个治理问题:
- 缺少更细的目录分层,容易随着 worktree 增长持续膨胀
- 缺少“不得写入敏感数据、真实路径、机器信息”的明确约束
- 目录语义没有区分共享恢复信息与 worktree 私有状态
- 已据此完成以下收口:
- 将既有共享 tracking / trace 文件迁移到 `ai-plan/public/todos/``ai-plan/public/traces/`
- 新增 `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`
- 结果:通过
### 下一步
1. 后续若出现新的 worktree 私有恢复需求,直接在 `ai-plan/private/<branch-or-worktree>/` 下创建,不再向共享目录追加本地临时状态
2. 若将来需要进一步限制格式,可再为 `public/**``private/` 各自补一个模板文件,但本轮先把目录语义和安全边界固定下来