tupingr
6992f59cd2
核心变化： - 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>
120 lines
4.1 KiB
Markdown
120 lines
4.1 KiB
Markdown
# 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/` | 知识沉淀 |
|