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>
2026-05-25 16:49:36 +08:00
parent 5dfc382c55
commit 4184a6d0b5
65 changed files with 1642 additions and 582 deletions
@@ -0,0 +1,17 @@
+# 阶段索引
+
+| 阶段 | 名称 | 状态 | 目录 |
+|------|------|------|------|
+| 1 | 基础搭建 | ACTIVE | `phase-01-foundation/` |
+| 2 | MVP | PLANNED | `phase-02-mvp/` |
+| 3 | 功能完善 | PLANNED | `phase-03-features/` |
+| 4 | 打磨发布 | PLANNED | `phase-04-polish/` |
+
+## 阶段切换规则
+
+1. 当前阶段 completion.md 全部打勾
+2. 人类签字确认
+3. Arch AI 更新本索引文件
+4. Arch AI 更新所有角色 card.md
+5. Arch AI 更新 ROADMAP.md
+6. 产出阶段复盘（docs/share/phase-NN/）
@@ -0,0 +1,45 @@
+# Phase 1: 基础搭建 — 架构概览
+
+## 技术栈
+
+| 层 | 技术 | 说明 |
+|----|------|------|
+| 前端 (P01) | Taro 4 + React 18 + TypeScript + Tailwind CSS | 跨端小程序 |
+| 后端 (P01) | NestJS 10 + TypeScript | REST API |
+| 数据库 | PostgreSQL（Schema 本阶段确定） | 关系型存储 |
+| 包管理 | pnpm | monorepo |
+| 测试 | Jest | 单元 + 集成 + E2E |
+| AI 训练 (P02) | Python + PyTorch | 延期至 Phase 2 |
+| Web 后台 (P03) | Next.js | 延期至 Phase 2 |
+
+## 当前架构快照
+
+```
+P01_errlens_app/
+  src/                    # Taro 小程序源码（已有骨架）
+    pages/index/          # 首页（通用模板，待替换为错题本首页）
+    components/ui/        # shadcn/ui Taro 组件库（~50个组件）
+    lib/                  # 工具函数（cn, platform, measure, hooks）
+    presets/              # H5 适配（navbar, error boundary, styles）
+    server/               # NestJS 后端
+      src/
+        main.ts           # 启动入口
+        app.module.ts     # 根模块
+        app.controller.ts # GET /hello, GET /health
+  tests/                  # Jest 测试（已有 utils 测试骨架）
+
+P02_errlens_training/     # 空壳，Phase 2 启动
+P03_errlens_web/          # 空壳，Phase 2 启动
+```
+
+## 关键约束
+
+- 所有业务代码在 projects/*/src/（权限边界）
+- 跨平台目标：微信小程序优先，抖音/H5 为次
+- AI 代码必须遵循 `.ai/prompts/coding/code-style.md`
+
+## 待定问题
+
+- 数据库 Schema 设计（PRD 先行）
+- P01 页面架构（几个页面、导航结构）
+- 后端 API 版本策略
@@ -0,0 +1,16 @@
+# Phase 1: 基础搭建 — 完成检查清单
+
+## 完成状态
+
+- [ ] 所有 goal.md 中的成功标准达成
+- [ ] 所有活跃任务处于 DONE 或 ARCHIVED
+- [ ] QA AI 签字确认
+- [ ] 人类签字确认
+- [ ] 知识已沉淀至 .ai/knowledge/
+- [ ] Phase 2 MVP 计划已起草
+- [ ] 阶段复盘已写出（docs/share/phase-01/）
+- [ ] Token 预算审计通过
+
+## 阶段交接
+
+*（阶段接近完成时填写）*
@@ -0,0 +1,27 @@
+# Phase 1: 基础搭建 — 阶段决策
+
+本文件记录在 Phase 1 执行过程中产生的决策（区别于全局 ADR）。
+
+## D-001: 信息架构分层设计
+
+- 日期: 2026-05-25
+- 状态: 已采纳
+- 决策: 采用 token 预算的分层架构（工作台 → 阶段 → 知识 → 分享）
+- 理由: AI 上下文窗口有限，旧 AGENTS.md 单体文件浪费 token
+- 影响: 所有 AI 从 `.ai/roles/{role}/` 启动，不再从 AGENTS.md 启动
+
+## D-002: 阶段化上下文加载
+
+- 日期: 2026-05-25
+- 状态: 已采纳
+- 决策: AI 只加载当前 Phase 的上下文，不加载所有历史
+- 理由: 未来阶段技术栈和侧重点可能不同，历史信息反而干扰
+- 影响: 阶段包必须自包含、可独立阅读
+
+## D-003: 角色工作台代替全局入口
+
+- 日期: 2026-05-25
+- 状态: 已采纳
+- 决策: 用 `today.md` + `queue.md` 替代从 AGENTS.md 找任务
+- 理由: AI 不需要理解整个项目结构，只需要知道自己该干什么
+- 影响: Arch AI 负责维护各角色的任务分配
@@ -0,0 +1,27 @@
+# Phase 1: 基础搭建 — 目标
+
+## 阶段目标
+
+建立完整的开发骨架：
+- 可运转的"1 人 + 3 AI"协作框架
+- 完整的目录和权限体系
+- 可运行的项目脚手架（Taro + React + NestJS）
+- 测试基础设施
+- 信息架构设计（分层 AI 上下文）
+
+## 成功标准
+
+- [ ] 3 个 AI 角色能独立通过工作台启动工作
+- [ ] P01 可通过 `pnpm dev` 启动并显示首页
+- [ ] 测试可通过 `pnpm test` 运行并产出报告
+- [ ] 所有初始 review/ 任务处于 DONE 或 ARCHIVED
+- [ ] 共享工具库可工作并通过测试
+- [ ] 信息架构重构完成
+
+## 阶段 Owner
+
+Arch AI 协调，Dev AI 实现，QA AI 验证，人类最终验收。
+
+## 下一阶段
+
+Phase 2: MVP — 实现错题本核心功能
@@ -0,0 +1,42 @@
+# Phase 1: 基础搭建 — 范围
+
+## 范围内
+
+### 协作框架
+- AGENTS.md（AI 角色 + 权限 + 工作流）
+- .ai/config/（JSON 角色配置）
+- .ai/prompts/（编码、测试、架构提示词模板）
+- .ai/roles/（AI 角色工作台）
+- .ai/phases/（阶段上下文）
+- review/（任务交接中心）
+
+### P01_errlens_app（主应用）
+- Taro 4 + React 18 脚手架，集成 shadcn/ui
+- NestJS 后端脚手架
+- 可运行的开发服务器（pnpm dev）
+- 基础页面路由
+
+### 测试基础设施
+- Jest 配置
+- 示例单元测试
+- 测试结果报告流程
+
+### 文档体系
+- 阶段追踪文档
+- 知识库基础
+- 人类仪表盘
+- 分享内容层
+
+## 范围外（延期至 Phase 2+）
+
+- 实际业务功能（登录、错题分析等）
+- P02 数据训练实现
+- P03 Web 后台实现
+- CI/CD 流水线配置
+- 生产部署
+
+## 项目依赖
+
+- P01 独立（可独立开发）
+- P02 依赖 P01 定义数据 Schema（Phase 2）
+- P03 依赖 P01 API 稳定（Phase 3）
@@ -0,0 +1,3 @@
+# Phase 2: MVP — 架构决策
+
+*（Phase 2 执行过程中由 Arch AI 填写）*
@@ -0,0 +1,3 @@
+# Phase 2: MVP — 完成检查清单
+
+*（Phase 2 接近完成时更新）*
@@ -0,0 +1,3 @@
+# Phase 2: MVP — 阶段决策
+
+*（Phase 2 执行过程中由 Arch AI 填写）*
@@ -0,0 +1,11 @@
+# Phase 2: MVP — 目标
+
+*（Phase 1 完成时由 Arch AI 填写）*
+
+## 阶段目标
+
+## 成功标准
+
+## 阶段 Owner
+
+## 下一阶段
@@ -0,0 +1,3 @@
+# Phase 2: MVP — 范围
+
+*（Phase 1 完成时由 Arch AI 填写）*
@@ -0,0 +1,3 @@
+# Phase 3: 功能完善 — 架构决策
+
+*（Phase 3 执行过程中由 Arch AI 填写）*
@@ -0,0 +1,3 @@
+# Phase 3: 功能完善 — 完成检查清单
+
+*（Phase 3 接近完成时更新）*
@@ -0,0 +1,3 @@
+# Phase 3: 功能完善 — 阶段决策
+
+*（Phase 3 执行过程中由 Arch AI 填写）*
@@ -0,0 +1,3 @@
+# Phase 3: 功能完善 — 目标
+
+*（Phase 2 完成时由 Arch AI 填写）*
@@ -0,0 +1,3 @@
+# Phase 3: 功能完善 — 范围
+
+*（Phase 2 完成时由 Arch AI 填写）*
@@ -0,0 +1,3 @@
+# Phase 4: 打磨发布 — 架构决策
+
+*（Phase 4 执行过程中由 Arch AI 填写）*
@@ -0,0 +1,3 @@
+# Phase 4: 打磨发布 — 完成检查清单
+
+*（Phase 4 接近完成时更新）*
@@ -0,0 +1,3 @@
+# Phase 4: 打磨发布 — 阶段决策
+
+*（Phase 4 执行过程中由 Arch AI 填写）*
@@ -0,0 +1,3 @@
+# Phase 4: 打磨发布 — 目标
+
+*（Phase 3 完成时由 Arch AI 填写）*
@@ -0,0 +1,3 @@
+# Phase 4: 打磨发布 — 范围
+
+*（Phase 3 完成时由 Arch AI 填写）*