refactor(architecture): 信息架构重构 — 从"人类导向单体文档"到"AI优先分层架构"

新增四层信息架构:
- Layer 0: 角色工作台 (.ai/roles/) — AI 每天只需读2个小文件
- Layer 1: 路线图看板 (ROADMAP.md) — 人机共享进度
- Layer 2: 阶段上下文 (.ai/phases/) — 按当前阶段加载
- Layer 3: 知识沉淀 (.ai/knowledge/) — 决策/模式/教训自动积累

新增:
- DASHBOARD.md — 人类仪表盘(30秒了解全貌)
- ROADMAP.md — 任务看板+阻塞追踪
- docs/share/ — 对外分享内容层(一鸡多吃)
- docs/使用手册.md — 人+AI使用手册
- .ai/prompts/architecture/ — 补充缺失的架构提示词
- .ai/principles.md — 信息架构设计原则
- review/active/INDEX.md — 任务索引

修改:
- AGENTS.md: 239行→117行,顶部AI跳转
- README.md: 精简聚焦人类读者
- PROJECT_CONTEXT.md: 精简+分层说明
- DECISIONS.md: 替换为跳转存根
- 5个task.md: 添加phase字段

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
tupingr
2026-05-25 16:49:36 +08:00
parent 5dfc382c55
commit 4184a6d0b5
65 changed files with 1642 additions and 582 deletions
+47
View File
@@ -0,0 +1,47 @@
# 信息架构设计原则
## 为什么这样设计
AI 的上下文窗口有限(~200K tokens)。当前架构按人类认知模式设计——详尽文档、全局视角——但 AI 每个读入上下文的字都是成本。这套分层架构的核心思想:**每个角色只加载必要信息,按需展开细节。**
## Token 预算
| 层级 | 预算 | 内容 | 加载时机 |
|------|------|------|----------|
| 角色工作台 (card + today) | < 2K | 身份+今日任务 | 每次会话必读 |
| 阶段上下文 (phase) | < 5K | 目标+范围+架构 | 按需加载 |
| 专题文档 (knowledge) | < 3K | 决策/模式/教训 | 按需加载 |
| 路线图 (ROADMAP) | < 2K | 全局进度 | 需要全局视野时 |
## 信息分层
```
Layer 0: 角色工作台 → AI 每天进来只读这个
Layer 1: 路线图看板 → 人类 + AI 共享进度
Layer 2: 阶段上下文 → 按当前阶段按需加载
Layer 3: 知识沉淀 → 自动积累,永久沉淀
```
## 维护规则
1. **不超预算**:每个文件严格遵守 token 预算,超了就拆分
2. **不重复状态**:状态只在一处记录(ROADMAP.md),其他地方引用
3. **Git 管历史**:文档只描述"现在是什么",历史由 Git 负责
4. **一文一答**:每个文件独立回答一个问题,不需要串联阅读
5. **角色无关设计**:任何 AI 模型都能通过读 card.md 快速接管角色
## 文件约定
- 角色工作台: `.ai/roles/{role}/`
- 阶段上下文: `.ai/phases/phase-NN-name/`
- 知识沉淀: `.ai/knowledge/`
- 提示词模板: `.ai/prompts/{domain}/`
## 阶段切换检查清单
切换阶段时 Arch AI 必须:
- [ ] 更新所有角色的 card.md(当前阶段字段)
- [ ] 更新 ROADMAP.md(阶段进度条)
- [ ] 生成上一阶段的 completion.md
- [ ] 产出阶段复盘(docs/share/phase-NN/
- [ ] 审计 token 预算