hwd32/ai_soc_sw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
新增:
- .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:
hwd32
2026-05-23 22:28:45 +08:00
parent da14b96f22
commit 490af832ea
5 changed files with 298 additions and 115 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.ai/config/architect.json
+38
View File
@@ -0,0 +1,38 @@
{
"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/"
}
}
.ai/config/workflow.json
+11 -5
View File
@@ -1,17 +1,23 @@
{ {
"workflow": "human-ai-collaboration", "workflow": "human-ai-collaboration",
"roles": ["human", "dev-ai", "qa-ai"], "roles": ["human", "arch-ai", "dev-ai", "qa-ai"],
"stages": [ "stages": [
{ {
"name": "需求分析", "name": "需求分析",
"actor": "human", "actor": "arch-ai",
"output": "review/{task_id}/task.md" "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": "开发实现", "name": "开发实现",
"actor": "dev-ai", "actor": "dev-ai",
"input": "review/{task_id}/task.md", "input": ["review/{task_id}/task.md", "review/{task_id}/acceptance.md"],
"output": ["projects/*/src/", "projects/*/docs/", "review/{task_id}/impact.md", "review/{task_id}/acceptance.md"] "output": ["projects/*/src/", "projects/*/docs/"]
}, },
{ {
"name": "测试验证", "name": "测试验证",
.trae/skills/ai-collab-setup/SKILL.md
+159 -55
View File
@@ -1,18 +1,18 @@
--- ---
name: "ai-collab-setup" 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 协作框架快速搭建 # AI 协作框架快速搭建
## 功能 ## 功能
一键创建"1 人+2AI（Coder+Tester）"协作框架，包括： 一键创建"1 人+3AI（Arch+Coder+Tester）"协作框架，包括：
- 完整的目录结构 - 完整的目录结构
- AI 角色定义与权限约定（AGENTS.md）—— R/W/RW/- 四态权限体系 - AI 角色定义与权限约定（AGENTS.md）—— R/W/RW/- 四态权限体系
- AI 配置文件（含 read_only_paths、forbidden_paths、description） - AI 配置文件（含 read_only_paths、forbidden_paths、description）
- 提示词模板（code-style.md、doc-template.md、bug-report.md） - 提示词模板（code-style.md、doc-template.md、bug-report.md）
- 工作流配置（4 阶段 + retry + escalation） - 工作流配置（5 阶段 + retry + escalation）
- 示例任务模板 - 示例任务模板
- README 文档 - README 文档
@@ -35,6 +35,7 @@ description: "Creates complete '1 Human + 2 AI' collaboration framework with dir
├── .gitignore ├── .gitignore
├── .ai/ ├── .ai/
│ ├── config/ │ ├── config/
│ │ ├── architect.json # Arch AI 配置（含 read_only_paths）
│ │ ├── coder.json # Dev AI 配置（含 read_only_paths） │ │ ├── coder.json # Dev AI 配置（含 read_only_paths）
│ │ ├── tester.json # QA AI 配置（含 read_only_paths） │ │ ├── tester.json # QA AI 配置（含 read_only_paths）
│ │ └── workflow.json # 工作流配置（含 retry + escalation） │ │ └── 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) ### Dev AI (编码AI)
**职责范围：** **职责范围：**
- ✅ 编写业务代码 (`projects/*/src/`) - ✅ 编写业务代码 (`projects/*/src/`)
@@ -206,10 +231,10 @@ cat > AGENTS.md << 'EOF'
## 工作流程 ## 工作流程
``` ```
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 需求分析 │ ───→ │ 开发实现 │ ───→ │ 测试验证 │ ───→ │ 验收确认 │ │ 需求分析 │ ───→ │ 架构设计 │ ───→ │ 开发实现 │ ───→ │ 测试验证 │ ───→ │ 验收确认 │
│ (人类) │ │ (Dev AI) │ │ (QA AI) │ │ (人类) │ │ (Arch AI) │ │ (Arch AI) │ │ (Dev AI) │ │ (QA AI) │ │ (人类) │
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
↑ │ ↑ │
│ Bug → 修复 │ │ Bug → 修复 │
└──────────────────────┘ └──────────────────────┘
@@ -219,8 +244,18 @@ cat > AGENTS.md << 'EOF'
### 详细流程说明 ### 详细流程说明
**1. 需求分析阶段** **1. 需求分析阶段**
- 人类负责人创建任务单 - Arch AI 分析用户需求，输出产品规划
- 输出: `review/{task_id}/task.md` - 输出: `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. 开发实现阶段** **2. 开发实现阶段**
- Dev AI 读取任务描述，编写代码 + 文档 - Dev AI 读取任务描述，编写代码 + 文档
@@ -262,22 +297,22 @@ Round 3: Dev 修复 → QA 复查 → 仍 1 个 HIGH → ⚠️ 升级给人类
> **图例**：`-` = 无权访问 &nbsp;&nbsp; `R` = 只读 &nbsp;&nbsp; `W` = 可写（含读） &nbsp;&nbsp; `RW` = 读写 > **图例**：`-` = 无权访问 &nbsp;&nbsp; `R` = 只读 &nbsp;&nbsp; `W` = 可写（含读） &nbsp;&nbsp; `RW` = 读写
| 目录路径 | Dev AI | QA AI | 人类 | | 目录路径 | Arch AI | Dev AI | QA AI | 人类 |
|---------|--------|-------|------| |---------|---------|--------|-------|------|
| `.ai/` | `-` | `-` | `RW` | | `.ai/` | `R` | `-` | `-` | `RW` |
| `docs/` | `RW` | `R` | `RW` | | `docs/` | `RW` | `RW` | `R` | `RW` |
| `tools/` | `RW` | `-` | `RW` | | `tools/` | `RW` | `RW` | `-` | `RW` |
| `data/` | `RW` | `R` | `RW` | | `data/` | `RW` | `RW` | `R` | `RW` |
| `shared/` | `RW` | `R` | `RW` | | `shared/` | `RW` | `RW` | `R` | `RW` |
| `projects/*/src/` | `RW` | `R` | `RW` | | `projects/*/src/` | `RW` | `RW` | `R` | `RW` |
| `projects/*/tests/` | `-` | `RW` | `RW` | | `projects/*/tests/` | `R` | `-` | `RW` | `RW` |
| `projects/*/docs/` | `RW` | `R` | `RW` | | `projects/*/docs/` | `RW` | `RW` | `R` | `RW` |
| `review/*/task.md` | `R` | `R` | `RW` | | `review/*/task.md` | `RW` | `R` | `R` | `RW` |
| `review/*/acceptance.md` | `RW` | `RW` | `RW` | | `review/*/acceptance.md` | `RW` | `RW` | `RW` | `RW` |
| `review/*/impact.md` | `RW` | `-` | `RW` | | `review/*/impact.md` | `RW` | `RW` | `-` | `RW` |
| `review/*/feedback/` | `R` | `RW` | `RW` | | `review/*/feedback/` | `R` | `R` | `RW` | `RW` |
| `reports/` | `-` | `RW` | `RW` | | `reports/` | `R` | `-` | `RW` | `RW` |
| `.github/` | `-` | `-` | `RW` | | `.github/` | `-` | `-` | `-` | `RW` |
> **解析优先级**：当同一条路径被多个规则匹配时，`forbidden > read_only > allowed`。禁止规则永远优先。 > **解析优先级**：当同一条路径被多个规则匹配时，`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/coder.json` | Dev AI 配置（权限、职责） |
| `.ai/config/tester.json` | QA AI 配置（权限、职责） | | `.ai/config/tester.json` | QA AI 配置（权限、职责） |
| `.ai/config/workflow.json` | 工作流配置（阶段、触发器） | | `.ai/config/workflow.json` | 工作流配置（阶段、触发器） |
@@ -345,7 +381,7 @@ EOF
cat > README.md << 'EOF' cat > README.md << 'EOF'
# AI 协作项目 # AI 协作项目
一个"人+2AI"协作模式的 AI 辅助编程项目仓库。 一个"人+3AI"协作模式的 AI 辅助编程项目仓库。
--- ---
@@ -358,6 +394,7 @@ cat > README.md << 'EOF'
├── .gitignore ├── .gitignore
├── .ai/ # AI协作核心配置 ├── .ai/ # AI协作核心配置
│ ├── config/ │ ├── config/
│ │ ├── architect.json # Arch AI 配置
│ │ ├── coder.json # Dev AI 配置 │ │ ├── coder.json # Dev AI 配置
│ │ ├── tester.json # QA AI 配置 │ │ ├── tester.json # QA AI 配置
│ │ └── workflow.json # 工作流配置 │ │ └── workflow.json # 工作流配置
@@ -399,6 +436,7 @@ cat > README.md << 'EOF'
| 角色 | 是谁 | 干什么 | 不干什么 | | 角色 | 是谁 | 干什么 | 不干什么 |
|------|------|--------|----------| |------|------|--------|----------|
| **人类负责人** | 你 | 下指令、审阅、做决策、定验收标准 | 不写代码、不写测试 | | **人类负责人** | 你 | 下指令、审阅、做决策、定验收标准 | 不写代码、不写测试 |
| **Arch AI** | Claude/TRAE/元宝等 | 需求分析、架构设计、技术选型、跨模块协调 | 不写测试 |
| **Dev AI** | Claude/TRAE/元宝等 | 写业务代码+文档、修bug、写impact | 不动tests/、不跑测试 | | **Dev AI** | Claude/TRAE/元宝等 | 写业务代码+文档、修bug、写impact | 不动tests/、不跑测试 |
| **QA AI** | 扣子编程AI | 写测试、跑测试、写反馈 | 不动src/、不改业务代码 | | **QA AI** | 扣子编程AI | 写测试、跑测试、写反馈 | 不动src/、不改业务代码 |
@@ -406,9 +444,9 @@ cat > README.md << 'EOF'
## 工作流程 ## 工作流程
1. **你**在 `review/active/P01-001/` 下写 `task.md`（要做什么） 1. **Arch AI** 分析需求，输出 `docs/01_产品需求/PRD.md` 和 `review/active/P01-001/task.md`
2. **你或Dev AI**补充 `acceptance.md`（怎么算做完了） 2. **Arch AI** 设计架构，输出 `docs/02_系统架构/`、`acceptance.md`、`impact.md`
3. **Dev AI** 在 `projects/P01_app/src/` 写代码，在 `docs/` 写文档，写 `impact.md` 3. **Dev AI** 在 `projects/P01_app/src/` 写代码，在 `docs/` 写文档
4. **你**审一眼，没问题就触发QA AI 4. **你**审一眼，没问题就触发QA AI
5. **QA AI** 读 `task.md` + `acceptance.md` + `impact.md`，按 `ENVIRONMENT.md` 准备环境，在 `tests/` 写测试并执行，写 `feedback/round1.md` 5. **QA AI** 读 `task.md` + `acceptance.md` + `impact.md`，按 `ENVIRONMENT.md` 准备环境，在 `tests/` 写测试并执行，写 `feedback/round1.md`
6. **有bug** → 你看反馈 → 让Dev AI修 → 回到步骤3（round2） 6. **有bug** → 你看反馈 → 让Dev AI修 → 回到步骤3（round2）
@@ -482,6 +520,49 @@ data/
EOF EOF
# 5. 创建 AI 配置文件（新版：含 read_only_paths、forbidden_paths、description） # 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' cat > .ai/config/coder.json << 'EOF'
{ {
"name": "Dev AI", "name": "Dev AI",
@@ -534,13 +615,19 @@ cat > .ai/config/tester.json << 'EOF'
"review/*/feedback/" "review/*/feedback/"
], ],
"read_only_paths": [ "read_only_paths": [
"review/*/task.md"
],
"forbidden_paths": [
"projects/*/src/", "projects/*/src/",
"projects/*/docs/", "projects/*/docs/",
"docs/",
"data/",
"shared/", "shared/",
"review/*/impact.md" "review/*/task.md",
"review/*/acceptance.md"
],
"forbidden_paths": [
".ai/",
"tools/",
"review/*/impact.md",
"review/*/feedback/"
], ],
"prompt_templates": { "prompt_templates": {
"testing": ".ai/prompts/testing/" "testing": ".ai/prompts/testing/"
@@ -551,18 +638,24 @@ EOF
cat > .ai/config/workflow.json << 'EOF' cat > .ai/config/workflow.json << 'EOF'
{ {
"workflow": "human-ai-collaboration", "workflow": "human-ai-collaboration",
"roles": ["human", "dev-ai", "qa-ai"], "roles": ["human", "arch-ai", "dev-ai", "qa-ai"],
"stages": [ "stages": [
{ {
"name": "需求分析", "name": "需求分析",
"actor": "human", "actor": "arch-ai",
"output": "review/{task_id}/task.md" "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": "开发实现", "name": "开发实现",
"actor": "dev-ai", "actor": "dev-ai",
"input": "review/{task_id}/task.md", "input": ["review/{task_id}/task.md", "review/{task_id}/acceptance.md"],
"output": ["projects/*/src/", "projects/*/docs/", "review/{task_id}/impact.md", "review/{task_id}/acceptance.md"] "output": ["projects/*/src/", "projects/*/docs/"]
}, },
{ {
"name": "测试验证", "name": "测试验证",
@@ -594,6 +687,8 @@ cat > .ai/config/workflow.json << 'EOF'
EOF EOF
# 6. 创建提示词模板 # 6. 创建提示词模板
mkdir -p .ai/prompts/architecture
cat > .ai/prompts/coding/README.md << 'EOF' cat > .ai/prompts/coding/README.md << 'EOF'
# Dev AI 提示词库 # Dev AI 提示词库
@@ -611,6 +706,15 @@ cat > .ai/prompts/testing/README.md << 'EOF'
| [bug-report.md](bug-report.md) | 测试反馈 / Bug 报告模板与格式规范 | | [bug-report.md](bug-report.md) | 测试反馈 / Bug 报告模板与格式规范 |
EOF 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' cat > .ai/prompts/coding/code-style.md << 'EOF'
# Dev AI 代码风格规范 # Dev AI 代码风格规范
@@ -1067,13 +1171,13 @@ skill 执行后：
--- ---
**Version**: 2.2 **Version**: 3.0
**Created**: 2026-05-23 **Created**: 2026-05-23
**Updated**: 2026-05-23 **Updated**: 2026-05-23
**Based On**: ErrLens AI Programming Project **Based On**: ErrLens AI Programming Project
**Changes from v2.1**: **Changes from v2.2**:
- 新增 resume-context Skill（接着干）- 解决多电脑切换时的上下文同步 - 新增 Arch AI（架构AI）角色，形成"1 人+3AI"协作模式
- 新增 docs/PROJECT_CONTEXT.md 项目整体上下文 - 新增 .ai/config/architect.json 配置文件
- 新增 docs/DECISIONS.md 架构决策记录（ADR） - 新增架构设计阶段，工作流从 4 阶段扩展为 5 阶段
- 新增 docs/06_开发日志/ 按日期记录讨论内容 - 权限矩阵增加 Arch AI 列
- 新增根目录 ENVIRONMENT.md 开发环境配置 - 新增 .ai/prompts/architecture/ 提示词目录
.trae/skills/resume-context/SKILL.md
+17 -9
View File
@@ -30,7 +30,7 @@ description: "Loads project context and syncs conversation history. Invoke when
``` ```
开发/dev/coder → Dev AI 开发/dev/coder → Dev AI
测试/test/qa → QA AI 测试/test/qa → QA AI
架构/arch → 人类负责人（全权限） 架构/arch → Arch AI（架构设计师）
``` ```
### 2. 读取项目上下文 ### 2. 读取项目上下文
@@ -48,6 +48,15 @@ description: "Loads project context and syncs conversation history. Invoke when
根据识别的角色，读取对应的配置文件： 根据识别的角色，读取对应的配置文件：
**Arch AI**：
```
.ai/config/architect.json
```
- 读取 `allowed_paths`、`read_only_paths`、`forbidden_paths`
- 读取 `responsibilities`
- 读取 `prompt_templates`
- **拥有最高 AI 权限**，可以进行架构设计和跨模块修改
**Dev AI**： **Dev AI**：
``` ```
.ai/config/coder.json .ai/config/coder.json
@@ -64,11 +73,6 @@ description: "Loads project context and syncs conversation history. Invoke when
- 读取 `responsibilities` - 读取 `responsibilities`
- 读取 `prompt_templates` - 读取 `prompt_templates`
**架构模式（人类负责人）**：
- 读取 `AGENTS.md` 中"人类负责人"职责
- **不受宪法约束**，可以修改所有目录
- 拥有最终决策权
### 4. 读取最新开发日志 ### 4. 读取最新开发日志
```powershell ```powershell
@@ -172,16 +176,20 @@ Get-ChildItem "docs/06_开发日志/" -Filter "*.md" | Sort-Object Name -Descend
## 注意事项 ## 注意事项
1. **角色必须明确**：用户必须指定"开发"、"测试"或"架构"，否则询问用户 1. **角色必须明确**：用户必须指定"开发"、"测试"或"架构"，否则询问用户
2. **架构模式特殊**：架构模式下 AI 拥有最高权限，不受宪法约束，可以修改所有目录 2. **架构模式**：架构模式对应 Arch AI，拥有最高 AI 权限，可以进行架构设计和跨模块修改
3. **不要修改文档**：此 skill 只读取上下文，不修改任何文件（除非用户明确要求） 3. **不要修改文档**：此 skill 只读取上下文，不修改任何文件（除非用户明确要求）
4. **关注最新内容**：优先读取最新的开发日志 4. **关注最新内容**：优先读取最新的开发日志
5. **识别阻塞点**：注意 PROJECT_CONTEXT.md 中的"待解决问题" 5. **识别阻塞点**：注意 PROJECT_CONTEXT.md 中的"待解决问题"
6. **权限意识**：开发/测试模式下严格遵循 AGENTS.md 中的权限约定 6. **权限意识**：开发/测试/架构模式下严格遵循 AGENTS.md 中的权限约定
--- ---
**Version**: 2.0 **Version**: 3.0
**Created**: 2026-05-23 **Created**: 2026-05-23
**Updated**: 2026-05-23 **Updated**: 2026-05-23
**Based On**: ErrLens AI Programming Project **Based On**: ErrLens AI Programming Project
**Purpose**: 解决用户多电脑切换时的上下文同步问题，明确 AI 角色和权限 **Purpose**: 解决用户多电脑切换时的上下文同步问题，明确 AI 角色和权限
**Changes from v2.0**:
- 架构模式从"人类负责人"改为"Arch AI（架构设计师）"
- 新增 .ai/config/architect.json 配置读取
- 支持"1 人+3AI"协作模式
AGENTS.md
+64 -37
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) ### Dev AI (编码AI)
**职责范围：** **职责范围：**
- ✅ 编写业务代码 (`projects/*/src/`) - ✅ 编写业务代码 (`projects/*/src/`)
@@ -76,10 +100,10 @@
## 工作流程 ## 工作流程
``` ```
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 需求分析 │ ───→ │ 开发实现 │ ───→ │ 测试验证 │ ───→ │ 验收确认 │ │ 需求分析 │ ───→ │ 架构设计 │ ───→ │ 开发实现 │ ───→ │ 测试验证 │ ───→ │ 验收确认 │
│ (人类) │ │ (Dev AI) │ │ (QA AI) │ │ (人类) │ │ (Arch AI) │ │ (Arch AI) │ │ (Dev AI) │ │ (QA AI) │ │ (人类) │
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
↑ │ ↑ │
│ Bug → 修复 │ │ Bug → 修复 │
└──────────────────────┘ └──────────────────────┘
@@ -89,15 +113,18 @@
### 详细流程说明 ### 详细流程说明
**1. 需求分析阶段** **1. 需求分析阶段**
- 人类负责人创建任务单 - Arch AI 分析用户需求，输出产品规划
- 输出: `review/{task_id}/task.md` - 输出: `docs/01_产品需求/PRD.md`、`review/{task_id}/task.md`
**2. 开发实现阶段** **2. 架构设计阶段**
- Dev AI 读取任务描述，编写代码 + 文档 - Arch AI 设计系统架构，技术选型
- 同时输出验收标准和变更影响范围 - 输出: `docs/02_系统架构/`、`review/{task_id}/impact.md`、`review/{task_id}/acceptance.md`
- 输出: `projects/*/src/`, `projects/*/docs/`, `review/{task_id}/impact.md`, `review/{task_id}/acceptance.md`
**3. 测试验证阶段** **3. 开发实现阶段**
- Dev AI 读取任务描述和验收标准，编写代码 + 文档
- 输出: `projects/*/src/`, `projects/*/docs/`
**4. 测试验证阶段**
- QA AI 根据验收标准编写测试，执行测试，生成报告 - QA AI 根据验收标准编写测试，执行测试，生成报告
- 测试反馈写入 `review/{task_id}/feedback/round{round}.md` - 测试反馈写入 `review/{task_id}/feedback/round{round}.md`
- 输出: `projects/*/tests/`, `reports/test-results/`, `review/{task_id}/feedback/` - 输出: `projects/*/tests/`, `reports/test-results/`, `review/{task_id}/feedback/`
@@ -132,22 +159,22 @@ Round 3: Dev 修复 → QA 复查 → 仍 1 个 HIGH → ⚠️ 升级给人类
> **图例**：`-` = 无权访问 &nbsp;&nbsp; `R` = 只读 &nbsp;&nbsp; `W` = 可写（含读） &nbsp;&nbsp; `RW` = 读写 > **图例**：`-` = 无权访问 &nbsp;&nbsp; `R` = 只读 &nbsp;&nbsp; `W` = 可写（含读） &nbsp;&nbsp; `RW` = 读写
| 目录路径 | Dev AI | QA AI | 人类 | | 目录路径 | Arch AI | Dev AI | QA AI | 人类 |
|---------|--------|-------|------| |---------|---------|--------|-------|------|
| `.ai/` | `-` | `-` | `RW` | | `.ai/` | `R` | `-` | `-` | `RW` |
| `docs/` | `RW` | `R` | `RW` | | `docs/` | `RW` | `RW` | `R` | `RW` |
| `tools/` | `RW` | `-` | `RW` | | `tools/` | `RW` | `RW` | `-` | `RW` |
| `data/` | `RW` | `R` | `RW` | | `data/` | `RW` | `RW` | `R` | `RW` |
| `shared/` | `RW` | `-` | `RW` | | `shared/` | `RW` | `RW` | `R` | `RW` |
| `projects/*/src/` | `RW` | `-` | `RW` | | `projects/*/src/` | `RW` | `RW` | `R` | `RW` |
| `projects/*/tests/` | `-` | `RW` | `RW` | | `projects/*/tests/` | `R` | `-` | `RW` | `RW` |
| `projects/*/docs/` | `RW` | `-` | `RW` | | `projects/*/docs/` | `RW` | `RW` | `R` | `RW` |
| `review/*/task.md` | `R` | `R` | `RW` | | `review/*/task.md` | `RW` | `R` | `R` | `RW` |
| `review/*/acceptance.md` | `RW` | `RW` | `RW` | | `review/*/acceptance.md` | `RW` | `RW` | `RW` | `RW` |
| `review/*/impact.md` | `RW` | `-` | `RW` | | `review/*/impact.md` | `RW` | `RW` | `-` | `RW` |
| `review/*/feedback/` | `R` | `RW` | `RW` | | `review/*/feedback/` | `R` | `R` | `RW` | `RW` |
| `reports/` | `-` | `RW` | `RW` | | `reports/` | `R` | `-` | `RW` | `RW` |
| `.github/` | `-` | `-` | `RW` | | `.github/` | `-` | `-` | `-` | `RW` |
> **解析优先级**：当同一条路径被多个规则匹配时，`forbidden > read_only > allowed`。禁止规则永远优先。 > **解析优先级**：当同一条路径被多个规则匹配时，`forbidden > read_only > allowed`。禁止规则永远优先。
> >