From 456cda909be088e36c3d1f6e1f9a85374150a830 Mon Sep 17 00:00:00 2001
From: hwd32 <tupingr@qq.com>
Date: Sat, 23 May 2026 21:43:21 +0800
Subject: [PATCH] =?UTF-8?q?feat(structure):=20=E6=96=B0=E5=A2=9E=E9=A1=B9?=
 =?UTF-8?q?=E7=9B=AE=E7=BA=A7=E7=9B=AE=E5=BD=95=20docs/=E3=80=81tools/?=
 =?UTF-8?q?=E3=80=81data/?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- docs/ 项目级总体文档（产品需求、系统架构、开发规范、部署运维、变更日志）
- tools/ 开发工具脚本
- data/ 训练数据
- AGENTS.md 权限矩阵新增三个目录的权限定义
- coder.json Dev AI 新增 docs/、tools/、data/ 可写路径
- tester.json QA AI 新增 docs/、data/ 只读路径，tools/ 禁止路径
- ai-collab-setup/SKILL.md 目录结构同步更新到 v2.1
---
 .ai/config/coder.json                 |  6 ++++++
 .ai/config/tester.json                |  7 +++++--
 .trae/skills/ai-collab-setup/SKILL.md | 22 ++++++++++++++++++----
 AGENTS.md                             |  9 +++++++++
 docs/01_产品需求/.gitkeep             |  0
 docs/02_系统架构/.gitkeep             |  0
 docs/03_开发规范/.gitkeep             |  0
 docs/04_部署运维/.gitkeep             |  0
 docs/05_变更日志/.gitkeep             |  0
 tools/.gitkeep                        |  0
 10 files changed, 38 insertions(+), 6 deletions(-)
 create mode 100644 docs/01_产品需求/.gitkeep
 create mode 100644 docs/02_系统架构/.gitkeep
 create mode 100644 docs/03_开发规范/.gitkeep
 create mode 100644 docs/04_部署运维/.gitkeep
 create mode 100644 docs/05_变更日志/.gitkeep
 create mode 100644 tools/.gitkeep

diff --git a/.ai/config/coder.json b/.ai/config/coder.json
index 74a7f71..ea52033 100644
--- a/.ai/config/coder.json
+++ b/.ai/config/coder.json
@@ -5,6 +5,9 @@
   "responsibilities": [
     "编写业务代码",
     "生成技术文档",
+    "维护项目级文档",
+    "维护开发工具",
+    "维护训练数据",
     "定义验收标准",
     "评估变更影响",
     "维护共享资源"
@@ -12,6 +15,9 @@
   "allowed_paths": [
     "projects/*/src/",
     "projects/*/docs/",
+    "docs/",
+    "tools/",
+    "data/",
     "shared/",
     "review/*/acceptance.md",
     "review/*/impact.md"
diff --git a/.ai/config/tester.json b/.ai/config/tester.json
index 4dc107f..8acaf67 100644
--- a/.ai/config/tester.json
+++ b/.ai/config/tester.json
@@ -15,13 +15,16 @@
     "review/*/feedback/"
   ],
   "read_only_paths": [
-    "review/*/task.md"
+    "review/*/task.md",
+    "docs/",
+    "data/"
   ],
   "forbidden_paths": [
     "projects/*/src/",
     "projects/*/docs/",
     "shared/",
-    "review/*/impact.md"
+    "review/*/impact.md",
+    "tools/"
   ],
   "prompt_templates": {
     "testing": ".ai/prompts/testing/"
diff --git a/.trae/skills/ai-collab-setup/SKILL.md b/.trae/skills/ai-collab-setup/SKILL.md
index 2978969..7e1eea7 100644
--- a/.trae/skills/ai-collab-setup/SKILL.md
+++ b/.trae/skills/ai-collab-setup/SKILL.md
@@ -46,6 +46,14 @@ description: "Creates complete '1 Human + 2 AI' collaboration framework with dir
 │       └── testing/               # 测试提示词
 │           ├── README.md
 │           └── bug-report.md      # Bug 报告模板（BLOCKER/HIGH/MEDIUM/LOW）
+├── docs/                        # 项目级总体文档（Dev AI 编写，QA AI 只读）
+│   ├── 01_产品需求/
+│   ├── 02_系统架构/
+│   ├── 03_开发规范/
+│   ├── 04_部署运维/
+│   └── 05_变更日志/
+├── tools/                       # 开发工具脚本（Dev AI 维护）
+├── data/                        # 训练数据（Dev AI 维护，QA AI 只读）
 ├── projects/
 │   ├── P01_app/
 │   │   ├── src/                   # Dev AI 工作区（前端 + 后端 + 配置）
@@ -344,6 +352,9 @@ cat > README.md << 'EOF'
 │   └── prompts/
 │       ├── coding/                # 编码提示词模板
 │       └── testing/               # 测试提示词模板
+├── docs/                        # 项目级总体文档
+├── tools/                       # 开发工具脚本
+├── data/                        # 训练数据
 ├── projects/                      # 项目代码
 │   ├── P01_app/                   # 主应用项目
 │   │   ├── src/                   # 业务代码 (Dev AI)
@@ -1044,13 +1055,16 @@ skill 执行后：
 
 ---
 
-**Version**: 2.0  
+**Version**: 2.1  
 **Created**: 2026-05-23  
 **Updated**: 2026-05-23  
 **Based On**: ErrLens AI Programming Project  
-**Changes from v1**: 
-- 权限体系从 ✅/❌ 升级为 R/W/RW/- 四态
-- 新增 read_only_paths、forbidden_paths 配置
+**Changes from v2.0**: 
+- 新增项目级目录 docs/、tools/、data/
+- 权限矩阵新增 docs/ (Dev:RW, QA:R)、tools/ (Dev:RW)、data/ (Dev:RW, QA:R)
+- Dev AI 职责新增：维护项目级文档、开发工具、训练数据
+- QA AI 只读路径新增 docs/、data/
+- QA AI 禁止路径新增 tools/
 - 工作流从线性升级为 4 阶段 + retry + escalation
 - 新增提示词模板（code-style.md、doc-template.md、bug-report.md）
 - JSON 配置新增 description 语义定义
diff --git a/AGENTS.md b/AGENTS.md
index 208a03a..7e19eed 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -25,6 +25,9 @@
 **职责范围：**
 - ✅ 编写业务代码 (`projects/*/src/`)
 - ✅ 生成技术文档 (`projects/*/docs/`)
+- ✅ 维护项目级文档 (`docs/`)
+- ✅ 维护开发工具 (`tools/`)
+- ✅ 维护训练数据 (`data/`)
 - ✅ 定义验收标准 (`review/*/acceptance.md`)
 - ✅ 评估变更影响 (`review/*/impact.md`)
 - ✅ 维护共享资源 (`shared/`)
@@ -46,12 +49,15 @@
 
 **可读但不可写：**
 - 👁 任务描述 (`review/*/task.md`) —— 只读，了解测试目标
+- 👁 项目级文档 (`docs/`) —— 只读，了解系统架构
+- 👁 训练数据 (`data/`) —— 只读，了解数据分布
 
 **禁止操作：**
 - ❌ 修改业务代码 (`projects/*/src/`)
 - ❌ 修改技术文档 (`projects/*/docs/`)
 - ❌ 修改共享资源 (`shared/`)
 - ❌ 修改影响评估 (`review/*/impact.md`)
+- ❌ 修改开发工具 (`tools/`)
 
 ### 人类负责人
 **职责范围：**
@@ -124,6 +130,9 @@ Round 3: Dev 修复 → QA 复查 → 仍 1 个 HIGH → ⚠️ 升级给人类
 | 目录路径 | 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` |
diff --git a/docs/01_产品需求/.gitkeep b/docs/01_产品需求/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/docs/02_系统架构/.gitkeep b/docs/02_系统架构/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/docs/03_开发规范/.gitkeep b/docs/03_开发规范/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/docs/04_部署运维/.gitkeep b/docs/04_部署运维/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/docs/05_变更日志/.gitkeep b/docs/05_变更日志/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/tools/.gitkeep b/tools/.gitkeep
new file mode 100644
index 0000000..e69de29