feat(structure): 新增项目级目录 docs/、tools/、data/

- 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
This commit is contained in:
2026-05-23 21:43:21 +08:00
parent 3491827fbc
commit 456cda909b
10 changed files with 38 additions and 6 deletions
+6
View File
@@ -5,6 +5,9 @@
"responsibilities": [ "responsibilities": [
"编写业务代码", "编写业务代码",
"生成技术文档", "生成技术文档",
"维护项目级文档",
"维护开发工具",
"维护训练数据",
"定义验收标准", "定义验收标准",
"评估变更影响", "评估变更影响",
"维护共享资源" "维护共享资源"
@@ -12,6 +15,9 @@
"allowed_paths": [ "allowed_paths": [
"projects/*/src/", "projects/*/src/",
"projects/*/docs/", "projects/*/docs/",
"docs/",
"tools/",
"data/",
"shared/", "shared/",
"review/*/acceptance.md", "review/*/acceptance.md",
"review/*/impact.md" "review/*/impact.md"
+5 -2
View File
@@ -15,13 +15,16 @@
"review/*/feedback/" "review/*/feedback/"
], ],
"read_only_paths": [ "read_only_paths": [
"review/*/task.md" "review/*/task.md",
"docs/",
"data/"
], ],
"forbidden_paths": [ "forbidden_paths": [
"projects/*/src/", "projects/*/src/",
"projects/*/docs/", "projects/*/docs/",
"shared/", "shared/",
"review/*/impact.md" "review/*/impact.md",
"tools/"
], ],
"prompt_templates": { "prompt_templates": {
"testing": ".ai/prompts/testing/" "testing": ".ai/prompts/testing/"
+18 -4
View File
@@ -46,6 +46,14 @@ description: "Creates complete '1 Human + 2 AI' collaboration framework with dir
│ └── testing/ # 测试提示词 │ └── testing/ # 测试提示词
│ ├── README.md │ ├── README.md
│ └── bug-report.md # Bug 报告模板(BLOCKER/HIGH/MEDIUM/LOW │ └── 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/ ├── projects/
│ ├── P01_app/ │ ├── P01_app/
│ │ ├── src/ # Dev AI 工作区(前端 + 后端 + 配置) │ │ ├── src/ # Dev AI 工作区(前端 + 后端 + 配置)
@@ -344,6 +352,9 @@ cat > README.md << 'EOF'
│ └── prompts/ │ └── prompts/
│ ├── coding/ # 编码提示词模板 │ ├── coding/ # 编码提示词模板
│ └── testing/ # 测试提示词模板 │ └── testing/ # 测试提示词模板
├── docs/ # 项目级总体文档
├── tools/ # 开发工具脚本
├── data/ # 训练数据
├── projects/ # 项目代码 ├── projects/ # 项目代码
│ ├── P01_app/ # 主应用项目 │ ├── P01_app/ # 主应用项目
│ │ ├── src/ # 业务代码 (Dev AI) │ │ ├── src/ # 业务代码 (Dev AI)
@@ -1044,13 +1055,16 @@ skill 执行后:
--- ---
**Version**: 2.0 **Version**: 2.1
**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 v1**: **Changes from v2.0**:
- 权限体系从 ✅/❌ 升级为 R/W/RW/- 四态 - 新增项目级目录 docs/、tools/、data/
- 新增 read_only_paths、forbidden_paths 配置 - 权限矩阵新增 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 - 工作流从线性升级为 4 阶段 + retry + escalation
- 新增提示词模板(code-style.md、doc-template.md、bug-report.md - 新增提示词模板(code-style.md、doc-template.md、bug-report.md
- JSON 配置新增 description 语义定义 - JSON 配置新增 description 语义定义
+9
View File
@@ -25,6 +25,9 @@
**职责范围:** **职责范围:**
- ✅ 编写业务代码 (`projects/*/src/`) - ✅ 编写业务代码 (`projects/*/src/`)
- ✅ 生成技术文档 (`projects/*/docs/`) - ✅ 生成技术文档 (`projects/*/docs/`)
- ✅ 维护项目级文档 (`docs/`)
- ✅ 维护开发工具 (`tools/`)
- ✅ 维护训练数据 (`data/`)
- ✅ 定义验收标准 (`review/*/acceptance.md`) - ✅ 定义验收标准 (`review/*/acceptance.md`)
- ✅ 评估变更影响 (`review/*/impact.md`) - ✅ 评估变更影响 (`review/*/impact.md`)
- ✅ 维护共享资源 (`shared/`) - ✅ 维护共享资源 (`shared/`)
@@ -46,12 +49,15 @@
**可读但不可写:** **可读但不可写:**
- 👁 任务描述 (`review/*/task.md`) —— 只读,了解测试目标 - 👁 任务描述 (`review/*/task.md`) —— 只读,了解测试目标
- 👁 项目级文档 (`docs/`) —— 只读,了解系统架构
- 👁 训练数据 (`data/`) —— 只读,了解数据分布
**禁止操作:** **禁止操作:**
- ❌ 修改业务代码 (`projects/*/src/`) - ❌ 修改业务代码 (`projects/*/src/`)
- ❌ 修改技术文档 (`projects/*/docs/`) - ❌ 修改技术文档 (`projects/*/docs/`)
- ❌ 修改共享资源 (`shared/`) - ❌ 修改共享资源 (`shared/`)
- ❌ 修改影响评估 (`review/*/impact.md`) - ❌ 修改影响评估 (`review/*/impact.md`)
- ❌ 修改开发工具 (`tools/`)
### 人类负责人 ### 人类负责人
**职责范围:** **职责范围:**
@@ -124,6 +130,9 @@ Round 3: Dev 修复 → QA 复查 → 仍 1 个 HIGH → ⚠️ 升级给人类
| 目录路径 | Dev AI | QA AI | 人类 | | 目录路径 | Dev AI | QA AI | 人类 |
|---------|--------|-------|------| |---------|--------|-------|------|
| `.ai/` | `-` | `-` | `RW` | | `.ai/` | `-` | `-` | `RW` |
| `docs/` | `RW` | `R` | `RW` |
| `tools/` | `RW` | `-` | `RW` |
| `data/` | `RW` | `R` | `RW` |
| `shared/` | `RW` | `-` | `RW` | | `shared/` | `RW` | `-` | `RW` |
| `projects/*/src/` | `RW` | `-` | `RW` | | `projects/*/src/` | `RW` | `-` | `RW` |
| `projects/*/tests/` | `-` | `RW` | `RW` | | `projects/*/tests/` | `-` | `RW` | `RW` |
View File
View File
View File
View File
View File
View File