Files

T

tupingr 4184a6d0b5 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

3.9 KiB

Raw Blame History

AI 角色定义与权限约定

如果你是 AI，请直接跳转到你的角色工作台：

Arch AI → .ai/roles/arch/card.md

Dev AI → .ai/roles/dev/card.md

QA AI → .ai/roles/qa/card.md

如果你是人类，请看 DASHBOARD.md + ROADMAP.md。

本文档是权限矩阵的唯一权威参考。角色工作台中的权限描述为摘要，如有冲突以本文档为准。

团队架构

1 人类 + 3 AI 协作模式：

Arch AI — 需求分析、架构设计、技术选型、跨模块协调
Dev AI — 代码编写、文档生成、Bug 修复
QA AI — 测试设计、测试执行、质量反馈
人类 — 需求输入、最终决策、成果验收

工作流（简化版）

需求分析(Arch) → 架构设计(Arch) → 开发实现(Dev) → 测试验证(QA) → 人类验收
                                        ↑              │
                                        └── Bug修复 ──┘  (最多3轮)

缺陷修复循环：最多 3 轮。第 3 轮仍有 BLOCKER/HIGH → 升级给人类裁决。

详细工作流配置：.ai/config/workflow.json

角色职责

Arch AI

可写：需求分析、架构设计、技术选型、跨模块协调、架构文档、验收标准、影响评估、共享资源、开发工具、训练数据、业务代码
只读：AI 配置、测试代码、测试报告、测试反馈
指导 Dev AI 和 QA AI 工作，分配任务队列

Dev AI

可写：业务代码、技术文档、项目级文档、开发工具、训练数据、共享资源、验收标准、影响评估
只读：任务描述、测试反馈
禁止：测试代码、测试报告

QA AI

可写：测试用例、测试报告、验收标准补充、测试反馈
只读：业务代码、技术文档、项目级文档、训练数据、共享资源、任务描述
禁止：AI 配置、开发工具、影响评估

目录权限矩阵

图例：- = 禁止 R = 只读 W = 可写（含读） RW = 读写

目录路径	Arch AI	Dev AI	QA AI	人类
`.ai/`	`R`	`-`	`-`	`RW`
`docs/`	`RW`	`RW`	`R`	`RW`
`tools/`	`RW`	`RW`	`-`	`RW`
`data/`	`RW`	`RW`	`R`	`RW`
`shared/`	`RW`	`RW`	`R`	`RW`
`projects/*/src/`	`RW`	`RW`	`R`	`RW`
`projects/*/tests/`	`R`	`-`	`RW`	`RW`
`projects/*/docs/`	`RW`	`RW`	`R`	`RW`
`review/*/task.md`	`RW`	`R`	`R`	`RW`
`review/*/acceptance.md`	`RW`	`RW`	`RW`	`RW`
`review/*/impact.md`	`RW`	`RW`	`-`	`RW`
`review/*/feedback/`	`R`	`R`	`RW`	`RW`
`reports/`	`R`	`-`	`RW`	`RW`
`.github/`	`-`	`-`	`-`	`RW`

优先级：forbidden > read_only > allowed。未出现在表中的路径默认禁止所有 AI。

命名规范

任务编号

P{项目编号}-{任务序号}，如 P01-001

分支命名

feature/P01-001-short-desc    # 功能开发
bugfix/P01-001-short-desc     # Bug修复
test/P01-001-short-desc       # 测试用例

提交信息

feat(P01-001): 简短描述
fix(P01-001): 简短描述
docs(P01-001): 简短描述
test(P01-001): 简短描述

AI 配置文件索引

文件	说明
`.ai/config/architect.json`	Arch AI 配置（权限、职责）
`.ai/config/coder.json`	Dev AI 配置（权限、职责）
`.ai/config/tester.json`	QA AI 配置（权限、职责）
`.ai/config/workflow.json`	工作流配置（阶段、触发器）
`.ai/prompts/architecture/`	架构设计提示词模板
`.ai/prompts/coding/`	编码提示词模板
`.ai/prompts/testing/`	测试提示词模板
`.ai/roles/`	AI 角色工作台（日常入口）
`.ai/phases/`	阶段上下文
`.ai/knowledge/`	知识沉淀

3.9 KiB Raw Blame History