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
+163 -59
View File
@@ -1,18 +1,18 @@
---
name: "ai-collab-setup"
description: "Creates complete '1 Human + 2 AI' collaboration framework with directory structure and AI constitution. Invoke when starting a new AI-assisted programming project."
description: "Creates complete '1 Human + 3 AI' collaboration framework with directory structure and AI constitution. Invoke when starting a new AI-assisted programming project."
---
# AI 协作框架快速搭建
## 功能
一键创建"1 人+2AICoder+Tester"协作框架,包括:
一键创建"1 人+3AIArch+Coder+Tester"协作框架,包括:
- 完整的目录结构
- AI 角色定义与权限约定(AGENTS.md)—— R/W/RW/- 四态权限体系
- AI 配置文件(含 read_only_paths、forbidden_paths、description
- 提示词模板(code-style.md、doc-template.md、bug-report.md
- 工作流配置(4 阶段 + retry + escalation
- 工作流配置(5 阶段 + retry + escalation
- 示例任务模板
- README 文档
@@ -35,6 +35,7 @@ description: "Creates complete '1 Human + 2 AI' collaboration framework with dir
├── .gitignore
├── .ai/
│ ├── config/
│ │ ├── architect.json # Arch AI 配置(含 read_only_paths
│ │ ├── coder.json # Dev AI 配置(含 read_only_paths
│ │ ├── tester.json # QA AI 配置(含 read_only_paths
│ │ └── workflow.json # 工作流配置(含 retry + escalation
@@ -138,22 +139,46 @@ cat > AGENTS.md << 'EOF'
┌─────────────────────────────────────────────┐
│ 人类负责人 │
│ 需求分析 · 架构设计 · 最终决策 │
└───────────────────┬─────────────────────────┘
┌───────────┴───────────┐
┌───────────────┐ ┌───────────────┐
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/`)
@@ -206,21 +231,31 @@ cat > AGENTS.md << 'EOF'
## 工作流程
```
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 需求分析 │ ───→ │ 开发实现 │ ───→ │ 测试验证 │ ───→ │ 验收确认 │
│ (人类) │ │ (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. 架构设计阶段**
- Arch AI 设计系统架构,技术选型
- 输出: `docs/02_系统架构/`、`review/{task_id}/impact.md`、`review/{task_id}/acceptance.md`
**3. 开发实现阶段**
- Dev AI 读取任务描述和验收标准,编写代码 + 文档
- 输出: `projects/*/src/`, `projects/*/docs/`
**4. 测试验证阶段**
**2. 开发实现阶段**
- Dev AI 读取任务描述,编写代码 + 文档
@@ -262,22 +297,22 @@ Round 3: Dev 修复 → QA 复查 → 仍 1 个 HIGH → ⚠️ 升级给人类
> **图例**`-` = 无权访问 &nbsp;&nbsp; `R` = 只读 &nbsp;&nbsp; `W` = 可写(含读) &nbsp;&nbsp; `RW` = 读写
| 目录路径 | Dev AI | QA AI | 人类 |
|---------|--------|-------|------|
| `.ai/` | `-` | `-` | `RW` |
| `docs/` | `RW` | `R` | `RW` |
| `tools/` | `RW` | `-` | `RW` |
| `data/` | `RW` | `R` | `RW` |
| `shared/` | `RW` | `R` | `RW` |
| `projects/*/src/` | `RW` | `R` | `RW` |
| `projects/*/tests/` | `-` | `RW` | `RW` |
| `projects/*/docs/` | `RW` | `R` | `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`。禁止规则永远优先。
>
@@ -334,6 +369,7 @@ test(P01-001): 添加登录测试用例
| 文件 | 说明 |
|------|------|
| `.ai/config/architect.json` | Arch AI 配置(权限、职责) |
| `.ai/config/coder.json` | Dev AI 配置(权限、职责) |
| `.ai/config/tester.json` | QA AI 配置(权限、职责) |
| `.ai/config/workflow.json` | 工作流配置(阶段、触发器) |
@@ -345,7 +381,7 @@ EOF
cat > README.md << 'EOF'
# AI 协作项目
一个"人+2AI"协作模式的 AI 辅助编程项目仓库。
一个"人+3AI"协作模式的 AI 辅助编程项目仓库。
---
@@ -358,6 +394,7 @@ cat > README.md << 'EOF'
├── .gitignore
├── .ai/ # AI协作核心配置
│ ├── config/
│ │ ├── architect.json # Arch AI 配置
│ │ ├── coder.json # Dev AI 配置
│ │ ├── tester.json # QA AI 配置
│ │ └── workflow.json # 工作流配置
@@ -399,6 +436,7 @@ cat > README.md << 'EOF'
| 角色 | 是谁 | 干什么 | 不干什么 |
|------|------|--------|----------|
| **人类负责人** | 你 | 下指令、审阅、做决策、定验收标准 | 不写代码、不写测试 |
| **Arch AI** | Claude/TRAE/元宝等 | 需求分析、架构设计、技术选型、跨模块协调 | 不写测试 |
| **Dev AI** | Claude/TRAE/元宝等 | 写业务代码+文档、修bug、写impact | 不动tests/、不跑测试 |
| **QA AI** | 扣子编程AI | 写测试、跑测试、写反馈 | 不动src/、不改业务代码 |
@@ -406,9 +444,9 @@ cat > README.md << 'EOF'
## 工作流程
1. **你**在 `review/active/P01-001/` 下写 `task.md`(要做什么)
2. **你或Dev AI**补充 `acceptance.md`(怎么算做完了)
3. **Dev AI** 在 `projects/P01_app/src/` 写代码,在 `docs/` 写文档,写 `impact.md`
1. **Arch AI** 分析需求,输出 `docs/01_产品需求/PRD.md` 和 `review/active/P01-001/task.md`
2. **Arch AI** 设计架构,输出 `docs/02_系统架构/`、`acceptance.md`、`impact.md`
3. **Dev AI** 在 `projects/P01_app/src/` 写代码,在 `docs/` 写文档
4. **你**审一眼,没问题就触发QA AI
5. **QA AI** 读 `task.md` + `acceptance.md` + `impact.md`,按 `ENVIRONMENT.md` 准备环境,在 `tests/` 写测试并执行,写 `feedback/round1.md`
6. **有bug** → 你看反馈 → 让Dev AI修 → 回到步骤3round2
@@ -482,6 +520,49 @@ data/
EOF
# 5. 创建 AI 配置文件(新版:含 read_only_paths、forbidden_paths、description
cat > .ai/config/architect.json << 'EOF'
{
"name": "Arch AI",
"role": "架构设计师",
"description": "allowed_paths = 可写路径(含读);read_only_paths = 只读路径;不在二者中的路径禁止访问。详细权限见 AGENTS.md 权限矩阵。",
"responsibilities": [
"需求分析和产品规划",
"系统架构设计",
"技术选型和评估",
"跨模块协调和集成",
"编写架构文档",
"定义验收标准",
"评估变更影响",
"维护共享资源",
"维护开发工具",
"维护训练数据",
"指导 Dev AI 和 QA AI 工作"
],
"allowed_paths": [
"docs/",
"shared/",
"projects/*/src/",
"projects/*/docs/",
"review/*/acceptance.md",
"review/*/impact.md",
"review/*/task.md",
"tools/",
"data/"
],
"read_only_paths": [
".ai/",
"projects/*/tests/",
"reports/",
"review/*/feedback/"
],
"forbidden_paths": [],
"prompt_templates": {
"architecture": ".ai/prompts/architecture/",
"documentation": ".ai/prompts/architecture/"
}
}
EOF
cat > .ai/config/coder.json << 'EOF'
{
"name": "Dev AI",
@@ -534,13 +615,19 @@ cat > .ai/config/tester.json << 'EOF'
"review/*/feedback/"
],
"read_only_paths": [
"review/*/task.md"
],
"forbidden_paths": [
"projects/*/src/",
"projects/*/docs/",
"docs/",
"data/",
"shared/",
"review/*/impact.md"
"review/*/task.md",
"review/*/acceptance.md"
],
"forbidden_paths": [
".ai/",
"tools/",
"review/*/impact.md",
"review/*/feedback/"
],
"prompt_templates": {
"testing": ".ai/prompts/testing/"
@@ -551,18 +638,24 @@ EOF
cat > .ai/config/workflow.json << 'EOF'
{
"workflow": "human-ai-collaboration",
"roles": ["human", "dev-ai", "qa-ai"],
"roles": ["human", "arch-ai", "dev-ai", "qa-ai"],
"stages": [
{
"name": "需求分析",
"actor": "human",
"output": "review/{task_id}/task.md"
"actor": "arch-ai",
"output": ["docs/01_产品需求/PRD.md", "review/{task_id}/task.md"]
},
{
"name": "架构设计",
"actor": "arch-ai",
"input": ["docs/01_产品需求/PRD.md", "review/{task_id}/task.md"],
"output": ["docs/02_系统架构/", "review/{task_id}/impact.md", "review/{task_id}/acceptance.md"]
},
{
"name": "开发实现",
"actor": "dev-ai",
"input": "review/{task_id}/task.md",
"output": ["projects/*/src/", "projects/*/docs/", "review/{task_id}/impact.md", "review/{task_id}/acceptance.md"]
"input": ["review/{task_id}/task.md", "review/{task_id}/acceptance.md"],
"output": ["projects/*/src/", "projects/*/docs/"]
},
{
"name": "测试验证",
@@ -594,6 +687,8 @@ cat > .ai/config/workflow.json << 'EOF'
EOF
# 6. 创建提示词模板
mkdir -p .ai/prompts/architecture
cat > .ai/prompts/coding/README.md << 'EOF'
# Dev AI 提示词库
@@ -611,6 +706,15 @@ cat > .ai/prompts/testing/README.md << 'EOF'
| [bug-report.md](bug-report.md) | 测试反馈 / Bug 报告模板与格式规范 |
EOF
cat > .ai/prompts/architecture/README.md << 'EOF'
# Arch AI 提示词库
| 文件 | 说明 |
|------|------|
| [architecture-design.md](architecture-design.md) | 架构设计模板与规范 |
| [tech-selection.md](tech-selection.md) | 技术选型评估模板 |
EOF
cat > .ai/prompts/coding/code-style.md << 'EOF'
# Dev AI 代码风格规范
@@ -1067,13 +1171,13 @@ skill 执行后:
---
**Version**: 2.2
**Version**: 3.0
**Created**: 2026-05-23
**Updated**: 2026-05-23
**Based On**: ErrLens AI Programming Project
**Changes from v2.1**:
- 新增 resume-context Skill(接着干)- 解决多电脑切换时的上下文同步
- 新增 docs/PROJECT_CONTEXT.md 项目整体上下文
- 新增 docs/DECISIONS.md 架构决策记录(ADR
- 新增 docs/06_开发日志/ 按日期记录讨论内容
- 新增根目录 ENVIRONMENT.md 开发环境配置
**Changes from v2.2**:
- 新增 Arch AI(架构AI)角色,形成"1 人+3AI"协作模式
- 新增 .ai/config/architect.json 配置文件
- 新增架构设计阶段,工作流从 4 阶段扩展为 5 阶段
- 权限矩阵增加 Arch AI 列
- 新增 .ai/prompts/architecture/ 提示词目录