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
+39
View File
@@ -0,0 +1,39 @@
# 可复用模式
## 目的
记录开发过程中发现的可持续复用的模式和做法。
同样的模式出现 3 次以上时,应当记录在这里。
---
## P-001: AI 任务交接 (review/active/)
**上下文**: AI 角色之间需要传递工作成果
**问题**: 如何结构化任务交接,让任何 AI 都能接手
**方案**: 标准化 `review/active/{任务ID}/` 结构:
- `task.md` — 任务描述(Arch AI 定义)
- `acceptance.md` — 验收标准(Arch AI + Dev AI + QA AI 共同维护)
- `impact.md` — 变更影响范围(Arch AI + Dev AI 评估)
- `feedback/` — 反馈记录(QA AI 提交)
**何时用**: 每个跨 AI 角色的任务
**何时不用**: 单角色任务(如纯文档更新、配置修改)
---
## P-002: 角色工作台 (daily task board)
**上下文**: AI 每次会话需要快速进入工作状态
**问题**: 从头探索项目结构浪费时间
**方案**: `.ai/roles/{role}/today.md` 每日任务清单,AI 只需读 2 个文件(card + today
**何时用**: 每次 AI 会话
**维护者**: Arch AI 负责分配,各 AI 自己更新完成状态
---
## 反模式(避免)
- 在多个文件中重复同一状态信息 → 只在 ROADMAP.md 记录
- 决策讨论散落在任务 feedback 中 → 提炼到 knowledge/decisions.md
- 大段文档内联而非链接 → 用链接 + 一句话摘要