docs: update agent rules and add latest e2e reports

CLAUDE.md

@@ -174,3 +174,25 @@ npm run build
 - 项目使用JaCoCo进行测试覆盖率分析
 - 管理后台使用Vue 3 + TypeScript + Element Plus
 - API使用X-API-Key进行认证
+
+## 2026-03 实战经验补充（智能体执行）
+
+1. **迁移策略要前置统一**  
+   - PostgreSQL 作为唯一目标方言。  
+   - 历史迁移脚本仅在未发布环境允许改写，发布后必须增量修复迁移。
+
+2. **测试环境漂移是主要假失败来源**  
+   - 严格迁移测试依赖容器运行时与临时目录配置，需固定到 CI 命令而不是口头约定。  
+   - 对 “Skipped” 项要有脚本化断言（如 `assert-migration-not-skipped.sh`）。
+
+3. **仓库污染必须脚本化治理**  
+   - 通过 `clean-artifacts.sh` 做 dry-run 门禁，避免根目录与前端目录被测试产物污染。  
+   - 构建产物优先归档后清理，降低误删风险。
+
+4. **日志管理需要“归档 + 索引”双机制**  
+   - `archive-logs.sh` 负责搬迁历史日志，`update-log-archive-index.sh` 负责检索索引。  
+   - 持续运行任务会自动再生日志，清理前需识别后台进程状态。
+
+5. **发布阶段必须尊重远端保护策略**  
+   - `main` 受保护时不可强推覆盖，优先走任务分支 + PR。  
+   - 若业务要求覆盖，先确认分支保护权限再执行推送。