feat(arch-ai): 新增 Arch AI(架构AI)角色,升级为'1 人+3AI'协作模式

新增:
- .ai/config/architect.json - Arch AI 配置文件(最高 AI 权限)
- .ai/prompts/architecture/ - 架构设计提示词目录

修改:
- AGENTS.md: 新增 Arch AI 角色定义,权限矩阵增加 Arch AI 列
- workflow.json: 工作流从 4 阶段扩展为 5 阶段(新增架构设计阶段)
- ai-collab-setup/SKILL.md: 全面支持 3 角色架构,版本升至 v3.0
- resume-context/SKILL.md: 架构模式改为 Arch AI,版本升至 v3.0

工作流变更:
需求分析(Arch AI) → 架构设计(Arch AI) → 开发实现(Dev AI) → 测试验证(QA AI) → 验收确认(人类)
This commit is contained in:
2026-05-23 22:28:45 +08:00
parent da14b96f22
commit 490af832ea
5 changed files with 298 additions and 115 deletions
+68 -41
View File
@@ -5,22 +5,46 @@
┌─────────────────────────────────────────────┐
│ 人类负责人 │
│ 需求分析 · 架构设计 · 最终决策 │
└───────────────────┬─────────────────────────┘
┌───────────┴───────────┐
┌───────────────┐ ┌───────────────┐
Dev AI │ │ QA AI │
代码编写 │ │ 测试设计 │
文档生成 │ │ 测试执行 │
影响评估 │ │ 质量保障 │
└───────────────┘ └───────────────┘
└───────────────┬───────────┬─────────────────┘
┌───────────┴──┐ ┌────┴────────────┐
▼ ▼
┌───────────────┐ ┌──────────────┐ ┌───────────────┐
Arch AI │ Dev AI │ │ QA AI │
需求分析 │ 代码编写 │ 测试设计 │
架构设计 │ 文档生成 │ 测试执行 │
技术选型 │ 影响评估 │ 质量保障 │
│ 跨模块协调 │ └────────────── └───────────────┘
└───────────────┘
```
---
## 角色职责
### Arch AI (架构AI)
**职责范围:**
- ✅ 需求分析和产品规划
- ✅ 系统架构设计
- ✅ 技术选型和评估
- ✅ 跨模块协调和集成
- ✅ 编写架构文档 (`docs/`)
- ✅ 定义验收标准 (`review/*/acceptance.md`)
- ✅ 评估变更影响 (`review/*/impact.md`)
- ✅ 维护共享资源 (`shared/`)
- ✅ 维护开发工具 (`tools/`)
- ✅ 维护训练数据 (`data/`)
- ✅ 指导 Dev AI 和 QA AI 工作
**可读但不可写:**
- 👁 AI 配置文件 (`.ai/`) —— 只读,了解团队规则
- 👁 测试代码 (`projects/*/tests/`) —— 只读,了解测试覆盖
- 👁 测试报告 (`reports/`) —— 只读,了解质量状况
- 👁 测试反馈 (`review/*/feedback/`) —— 只读,了解问题
**禁止操作:**
- ❌ 无(架构 AI 拥有最高 AI 权限)
### Dev AI (编码AI)
**职责范围:**
- ✅ 编写业务代码 (`projects/*/src/`)
@@ -76,28 +100,31 @@
## 工作流程
```
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 需求分析 │ ───→ │ 开发实现 │ ───→ │ 测试验证 │ ───→ │ 验收确认 │
│ (人类) │ │ (Dev AI) │ │ (QA AI) │ │ (人类) │
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
↑ │
│ Bug → 修复 │
└──────────────────────┘
(最多 2 轮)
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 需求分析 │ ───→ │ 架构设计 │ ───→ │ 开发实现 │ ───→ │ 测试验证 │ ───→ │ 验收确认 │
│ (Arch AI) │ │ (Arch AI) │ │ (Dev AI) │ │ (QA AI) │ │ (人类) │
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
↑ │
│ Bug → 修复 │
└──────────────────────┘
(最多 2 轮)
```
### 详细流程说明
**1. 需求分析阶段**
- 人类负责人创建任务单
- 输出: `review/{task_id}/task.md`
- Arch AI 分析用户需求,输出产品规划
- 输出: `docs/01_产品需求/PRD.md``review/{task_id}/task.md`
**2. 开发实现阶段**
- Dev AI 读取任务描述,编写代码 + 文档
- 同时输出验收标准和变更影响范围
- 输出: `projects/*/src/`, `projects/*/docs/`, `review/{task_id}/impact.md`, `review/{task_id}/acceptance.md`
**2. 架构设计阶段**
- Arch AI 设计系统架构,技术选型
- 输出: `docs/02_系统架构/``review/{task_id}/impact.md``review/{task_id}/acceptance.md`
**3. 测试验证阶段**
**3. 开发实现阶段**
- Dev AI 读取任务描述和验收标准,编写代码 + 文档
- 输出: `projects/*/src/`, `projects/*/docs/`
**4. 测试验证阶段**
- QA AI 根据验收标准编写测试,执行测试,生成报告
- 测试反馈写入 `review/{task_id}/feedback/round{round}.md`
- 输出: `projects/*/tests/`, `reports/test-results/`, `review/{task_id}/feedback/`
@@ -132,22 +159,22 @@ Round 3: Dev 修复 → QA 复查 → 仍 1 个 HIGH → ⚠️ 升级给人类
> **图例**`-` = 无权访问    `R` = 只读    `W` = 可写(含读)    `RW` = 读写
| 目录路径 | Dev AI | QA AI | 人类 |
|---------|--------|-------|------|
| `.ai/` | `-` | `-` | `RW` |
| `docs/` | `RW` | `R` | `RW` |
| `tools/` | `RW` | `-` | `RW` |
| `data/` | `RW` | `R` | `RW` |
| `shared/` | `RW` | `-` | `RW` |
| `projects/*/src/` | `RW` | `-` | `RW` |
| `projects/*/tests/` | `-` | `RW` | `RW` |
| `projects/*/docs/` | `RW` | `-` | `RW` |
| `review/*/task.md` | `R` | `R` | `RW` |
| `review/*/acceptance.md` | `RW` | `RW` | `RW` |
| `review/*/impact.md` | `RW` | `-` | `RW` |
| `review/*/feedback/` | `R` | `RW` | `RW` |
| `reports/` | `-` | `RW` | `RW` |
| `.github/` | `-` | `-` | `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`。禁止规则永远优先。
>