v0.20.6 rebuild platform environments from templates

PLAN.md

@@ -804,3 +804,17 @@ OpenCode 的坑：如果只是在主会话里装样子地写"让 X agent 做"，
   - `scripts/runtime/skills.py` canonical skill registry 改为 `.agent/skills`，保留 legacy `.agents/skills` fallback。
   - 新增 `docs/antigravity-clean-workspace.md` 和 `scripts/export_antigravity_workspace.py`，支持 sparse checkout 或从完整仓库导出 clean workspace。
   - `.gitignore` 新增 legacy/generated platform adapter 目录，后续不再把这些目录作为 Antigravity workspace 内容。
+
+- 2026-05-07 v0.20.6 Platform env rebuild：**平台配置源与运行环境解耦**
+
+  **设计结论**：
+  - 不再把 `.agent`、`.codex`、`.opencode`、`.claude`、`.gemini` 这类隐藏运行目录作为主仓库根目录的一等入口。
+  - Git 跟踪非隐藏源模板 `platform_adapters/<platform>/`；本地运行环境统一由脚本重建到 ignored `platform_envs/<platform>/`。
+  - Antigravity 的正确打开方式是 `platform_envs/antigravity`，而不是完整多平台仓库根目录。
+  - 将来若需要彻底隔离，也可以在 Gitea 上为 `codex/*`、`antigravity/*`、`opencode/*` 等分支分别维护平台专用视图。
+
+  **已落地**：
+  - 新增 `platform_adapters/antigravity/agent`、`platform_adapters/codex`、`platform_adapters/opencode`、`platform_adapters/claude-code`、`platform_adapters/gemini-cli`。
+  - 新增 `scripts/update_platform_envs.py`：可先 `git pull --ff-only`，再重建 `platform_envs/antigravity|codex|opencode|claude-code|gemini-cli`。
+  - `scripts/deploy_adapters.py`、`scripts/export_antigravity_workspace.py`、`scripts/runtime/skills.py` 改为读取 `platform_adapters` 源模板。
+  - README、GEMINI、AGENTS、platform docs 改为说明 source template + generated env 的导入逻辑。