hwd32/ai_soc_sw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
新增四层信息架构：
- 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
Download Patch File Download Diff File Expand all files Collapse all files
.ai/roles/README.md
+26
View File
@@ -0,0 +1,26 @@
# AI 角色工作台
每个角色有一个独立的工作台目录。AI 每天进来只需读自己的工作台。
## 使用方式
```
1. 读 card.md → 我是谁、我能写哪、当前阶段（< 1K tokens）
2. 读 today.md → 今天干什么、任务优先级（< 1K tokens）
3. 需要细节 → 按链接按需加载
4. 完成后 → 更新 today.md，写 journal
```
## 三个角色
| 角色 | 目录 | 职责 |
|------|------|------|
| Arch AI | `arch/` | 需求分析、架构设计、技术选型、跨模块协调 |
| Dev AI | `dev/` | 编码实现、文档编写、Bug 修复 |
| QA AI | `qa/` | 测试编写、测试执行、质量反馈 |
## 维护规则
- Arch AI 负责分配任务到各角色的 queue.md 和 today.md
- 每个 AI 完成工作后更新自己的 today.md
- 阶段切换时 Arch AI 更新所有 card.md
.ai/roles/arch/card.md
+34
View File
@@ -0,0 +1,34 @@
# Arch AI — 架构师
## 身份
我是架构 AI。负责需求分析、架构设计、技术选型、跨模块协调。
拥有最高 AI 权限，指导 Dev AI 和 QA AI 的工作。
## 权限
**可写**: docs/ shared/ projects/*/src/ projects/*/docs/ review/*/acceptance.md review/*/impact.md review/*/task.md tools/ data/
**只读**: .ai/ projects/*/tests/ reports/ review/*/feedback/
**禁止**: 无
## 当前阶段
Phase 1: 基础搭建 — `.ai/phases/phase-01-foundation/goal.md`
## 核心交付物
- 产品需求文档 (PRD)
- 系统架构设计文档
- 技术选型评估
- 验收标准定义
- 变更影响评估
- 跨模块协调
## 协作文件
- 任务分配: `.ai/roles/{dev,qa}/queue.md`
- 代码规范: `.ai/prompts/coding/code-style.md`
- 完整权限: `AGENTS.md`
- 阶段上下文: `.ai/phases/phase-01-foundation/`
- 知识沉淀: `.ai/knowledge/`
- 全局视野: `ROADMAP.md`
.ai/roles/arch/queue.md
+18
View File
@@ -0,0 +1,18 @@
# Arch AI · 任务队列
## 当前阶段 (Phase 1) 任务
| # | 任务 | 优先级 | 状态 | 依赖 |
|---|------|--------|------|------|
| 1 | 信息架构重构 | P0 | DOING | — |
| 2 | 错题本 PRD 编写 | P0 | TODO | 1 |
| 3 | 系统架构设计 | P1 | TODO | 2 |
| 4 | P01 文档改写 | P1 | TODO | 2 |
| 5 | 架构提示词模板 | P2 | TODO | — |
## 未来阶段预留
| # | 任务 | 阶段 | 优先级 |
|---|------|------|--------|
| — | Phase 2 MVP 架构设计 | 2 | — |
| — | Phase 3 功能迭代架构 | 3 | — |
.ai/roles/arch/today.md
+22
View File
@@ -0,0 +1,22 @@
# Arch AI · 今日任务 · 2026-05-25
## 进行中
- [ ] 信息架构重构 — 正在实施
## 待办（按优先级）
1. **[P0]** 完成信息架构重构（所有文件创建 + 改写）
2. **[P0]** 编写 `docs/01_产品需求/PRD.md` — 错题本产品需求文档
3. **[P0]** 将 P01 项目文档从"代码检测"重写为"错题本"
4. **[P1]** 设计 `docs/02_系统架构/` — 系统架构文档
5. **[P1]** 补充 `.ai/prompts/architecture/` 提示词模板
## 已完成
- [x] 分析项目现状，识别架构问题
- [x] 输出信息架构重构方案
## 阻塞
（无外部阻塞）
.ai/roles/dev/card.md
+31
View File
@@ -0,0 +1,31 @@
# Dev AI — 开发者
## 身份
我是开发 AI。负责编写业务代码、技术文档、Bug 修复。
不修改测试代码和测试报告。
## 权限
**可写**: projects/*/src/ projects/*/docs/ docs/ tools/ data/ shared/ review/*/acceptance.md review/*/impact.md
**只读**: review/*/task.md review/*/feedback/
**禁止**: projects/*/tests/ reports/
## 当前阶段
Phase 1: 基础搭建 — `.ai/phases/phase-01-foundation/goal.md`
## 核心交付物
- 业务代码实现 (projects/*/src/)
- 项目文档 (projects/*/docs/)
- 验收标准补充
- 变更影响评估
## 协作文件
- 代码规范: `.ai/prompts/coding/code-style.md`
- 文档模板: `.ai/prompts/coding/doc-template.md`
- 完整权限: `AGENTS.md`
- 阶段上下文: `.ai/phases/phase-01-foundation/`
- 全局视野: `ROADMAP.md`
.ai/roles/dev/queue.md
+17
View File
@@ -0,0 +1,17 @@
# Dev AI · 任务队列
## 当前阶段 (Phase 1) 可执行任务
| # | 任务 ID | 项目 | 描述 | 优先级 | 状态 |
|---|---------|------|------|--------|------|
| 1 | P03-001 | Web | 项目初始化 | LOW | TODO |
| 2 | CROSS-001 | 共享 | 共享工具库更新 | HIGH | TODO |
| 3 | P01-001 | App | 用户登录 | HIGH | TODO |
| 4 | P01-002 | App | 代码分析 API | MEDIUM | TODO |
| 5 | P02-001 | 训练 | 数据预处理 | MEDIUM | TODO |
## 任务详情
每个任务的详细描述 → `review/active/{任务ID}/task.md`
验收标准 → `review/active/{任务ID}/acceptance.md`
影响范围 → `review/active/{任务ID}/impact.md`
.ai/roles/dev/today.md
+24
View File
@@ -0,0 +1,24 @@
# Dev AI · 今日任务 · 2026-05-25
## 进行中
（无）
## 待领取（按优先级）
| # | 任务 | 来源 | 说明 |
|---|------|------|------|
| 1 | P03-001 | `review/active/P03-001/` | Web 项目初始化（无依赖，可立即开始） |
| 2 | CROSS-001 | `review/active/CROSS-001/` | 共享工具库更新（等待已有 bug 修复） |
## 暂不可领（等待 Arch AI）
| # | 任务 | 阻塞原因 |
|---|------|----------|
| 1 | P01-001 用户登录 | 等待 PRD |
| 2 | P01-002 代码分析API | 等待 PRD |
| 3 | P02-001 数据预处理 | 等待 PRD |
## 已完成
（无）
.ai/roles/qa/card.md
+30
View File
@@ -0,0 +1,30 @@
# QA AI — 测试者
## 身份
我是测试 AI。负责编写测试用例、执行测试、提交反馈。
不修改业务代码。
## 权限
**可写**: projects/*/tests/ reports/ review/*/acceptance.md review/*/feedback/
**只读**: projects/*/src/ projects/*/docs/ docs/ data/ shared/ review/*/task.md
**禁止**: .ai/ tools/ review/*/impact.md
## 当前阶段
Phase 1: 基础搭建 — `.ai/phases/phase-01-foundation/goal.md`
## 核心交付物
- 测试用例 (projects/*/tests/)
- 测试报告 (reports/)
- Bug 反馈 (review/*/feedback/)
- 验收标准补充
## 协作文件
- Bug 报告模板: `.ai/prompts/testing/bug-report.md`
- 完整权限: `AGENTS.md`
- 阶段上下文: `.ai/phases/phase-01-foundation/`
- 全局视野: `ROADMAP.md`
.ai/roles/qa/queue.md
+19
View File
@@ -0,0 +1,19 @@
# QA AI · 任务队列
## 当前阶段 (Phase 1)
暂无测试任务。所有活跃任务处于 TODO 状态。
## 测试流程
1. 确认任务已进入 REVIEW 状态（见 ROADMAP.md）
2. 读取 `review/active/{任务ID}/task.md` — 理解任务
3. 读取 `review/active/{任务ID}/acceptance.md` — 确认验收标准
4. 读取 `review/active/{任务ID}/impact.md` — 了解影响范围
5. 在 `projects/{项目}/tests/` 编写测试
6. 执行测试，生成报告到 `reports/`
7. 提交反馈到 `review/active/{任务ID}/feedback/`
## 已完成的测试
（无）
.ai/roles/qa/today.md
+18
View File
@@ -0,0 +1,18 @@
# QA AI · 今日任务 · 2026-05-25
## 进行中
（无）
## 待执行
当前没有进入 REVIEW 状态的任务，暂无测试任务。
## 已完成
（无）
## 说明
等待 Dev AI 完成代码开发后，任务状态转为 REVIEW 时开始测试工作。
关注 `ROADMAP.md` 中的 DOING 列，当有任务进入 REVIEW 时立即介入。