Appearance
ADR-031: 2026-07-05 会话清理 — 文档翻新 + AGENTS.md 瘦身 + 硬约束精简
日期: 2026-07-05 状态: 已完成
背景
30 条 ADR 大部分无状态标记，AGENTS.md 516 行过长，AI 读完后上下文被填满导致决策质量下降。
已拆分为独立 ADR 的工作
| 子项 | 新 ADR |
|---|---|
| CI 自动检查（链接校验 + Mistake Tracker） | ADR-041 |
| motion/ → motion-algos/ 目录改名 | ADR-042 |
| DanceXR 功能差距挖掘 | ADR-043 |
| MMD 生态竞品分析 | ADR-044 |
已记录在其他 ADR 的工作
| 子项 | 所在 ADR |
|---|---|
| 粒子落地溅射 | ADR-026 Phase B |
| HTTP 目录隔离 | ADR-005 #1 |
| ADR-023 SAF Spike | ADR-017 Phase C（原 ADR-023 已并入 ADR-017 安卓适配） |
| 风场广播注释 | ADR-028 |
| ADR-025/016 核验确认 | ADR-025、ADR-016 |
本次会话保留的工作
1. 全量 ADR 状态标记
给 30 个 ADR 文件头部统一追加 > **状态**: 行，格式一致，grep 可检索。
| 状态 | 数量 | 编号 |
|---|---|---|
| 已完成/已实现 | 25 | 001-002, 004-006, 008-009, 011-022, 025-030 |
| 部分完成 | 3 | 003（远期构想）, 023（SAF）, 024（SSS） |
| 参考文档 | 2 | 007, 010 |
2. ADR 状态更正
| ADR | 原状态 | 新状态 | 原因 |
|---|---|---|---|
| 005 | 部分已修复 | 已完成 | #1 HTTP 隔离已实施 |
| 011 | 部分完成 | 已完成 | v3 已迁移（alpha2.105） |
| 014 | 部分完成 | 已完成 | 库 CRUD/自动匹配已实现 |
| 016 | 部分完成 | 已完成 | 双路径方案已实施 |
| 017 | 部分完成 | 已完成 | prompt() 全部替换 |
| 025 | 部分完成 | 已完成 | P0/P1/P2 全部实现 |
| 026 | 实施中 | 已完成 | Phase A+B+C 全部完成 |
3. 文档翻新
docs/roadmap.md：383 行 → ~130 行
- 砍掉重复已完成段落、旧 ASCII 时间线、空泛长期愿景
- 更新核心价值定位表（渲染调参/环境系统/换装已标 ✅）
- 重新排列 Phase 11+ 优先级
docs/status.md：794 行 → ~120 行
- 砍掉 200+ 行已实现清单、32 条 Bug 记录、200+ 行审查记录
- 更新 Phase 进度表（Phase 10 + 环境增强已完成）
- 保留键盘快捷键、环境依赖、构建命令、已知限制
4. AGENTS.md 重构
根 AGENTS.md：666 行 → 427 行（-36%）
- 删除 §四（多 AI 并发）/ §七（工作流）/ §八（会话边界）/ §九（子代理详情）
- 提取为独立文件：
docs/workflow.md、docs/multi-ai.md - 7 处过时文件路径修复
frontend/AGENTS.md：新建（138 行）
- 前端专用：构建命令/测试命令/TypeScript 约定/目录索引
5. AGENTS.md 瘦身 516→106 行（-79%）
砍掉的：函数映射表→docs/function-map.md、任务触发索引、前端完整目录树、启动约束块、工作流规则、docs/ 目录树、审计/沟通/多AI/环境节。
保留的：7 条硬约束、文件职责表、按任务跳转表、仓库结构、技术栈 + 构建命令。
6. AGENTS.md 硬约束精简
7 条 → 6 条：
- 删除「禁止
ls探索未知目录」 - 「禁止全量读大文件」→「大文件 (>500 行) 先 grep 再读」
- 「改完立即 build」→「改代码后 build，改文档不需要」
7. docs/ 其他翻新
docs/architecture.md：21 处过时文件路径修复docs/menu-architecture.md：删除已不存在的motion-dance-sets.ts条目docs/reusables.md：新增wind-utils.ts函数表 + 清理已不存在引用docs/function-map.md：从 AGENTS.md 提取的 140 行函数映射表
8. 文件职责边界明确化
status.md 标注为「只读快照」，roadmap.md 标注为「规划文档（可写）」，两文件顶部加互引标注。
9. docs/ 冗余文档清理
ADR-039 中删除的 10 份冗余文档：foundation.md、requirements.md、roadmap.md、reusables.md、fix-cycle.md、multi-ai.md、workflow.md、glossary.md、design-archive.md、release.md。
教训
- 文档厚度与 AI 犯错概率正相关
- 规划文本是给人类看的，AI 需要的是决策记录
- 一份路由表 + 一份架构 + 一份 UI 规范 = AI 能干活的最小集
- 三份索引等于没有索引——坚持单一路由表原则