Files

T

tupingr 6992f59cd2 refactor(arch): 信息架构升级 — 三层四角色控制面板 + 跨平台 task 交接协议

核心变化：
- dashboard.md 替代 DASHBOARD + ROADMAP，人类+Arch AI 唯一入口
- DECISIONS.md 人类决策入口，≤3 条待决策
- .ai/tasks/ 14 个独立 task 文件（Coder 8 + Tester 6），弱模型自包含可独立执行
- 旧 today/queue 归档，每个角色启动 ≤2 个文件
- ADR-012 跨平台「高模型指挥小模型」协作架构落地
- 知识库补全：L-002~005、P-004~005、ADR-011~012
- Arch AI 上下文资源管理硬约束写入 principles.md

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-26 15:17:06 +08:00

4.1 KiB

Raw Blame History

AI 角色定义与权限约定

如果你是 AI，请直接跳转到你的角色入口：

Arch AI → dashboard.md 全文

Dev AI → .ai/roles/dev/card.md → 对应 .ai/tasks/active/P01-XXX.md

QA AI → .ai/roles/qa/card.md → 对应 .ai/tasks/active/T01-XXX.md

如果你是人类，请看 dashboard.md 顶部「人类区」。

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

架构说明: 旧入口（DASHBOARD.md / ROADMAP.md / roles//today.md / roles//queue.md）已归档至 .ai/archive/。详见 ADR-012。

团队架构

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/`	知识沉淀

4.1 KiB Raw Blame History