48 lines
1.8 KiB
Markdown
48 lines
1.8 KiB
Markdown
|
# 信息架构设计原则
|
|||
|
|
|
|||
|
|
## 为什么这样设计
|
|||
|
|
|
|||
|
|
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 预算
|