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:
@@ -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"
|
||||||
|
|||||||
@@ -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/"
|
||||||
|
|||||||
@@ -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 语义定义
|
||||||
|
|||||||
@@ -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` |
|
||||||
|
|||||||
Reference in New Issue
Block a user