ai_soc_sw/.trae/skills/ai-collab-setup/SKILL.md

---
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."
---

# AI 协作框架快速搭建

## 功能

一键创建"1 人+2AI（Coder+Tester）"协作框架，包括：
- 完整的目录结构
- AI 角色定义与权限约定（AGENTS.md）
- AI 配置文件
- 示例任务模板
- README 文档

## 使用方法

在新项目根目录执行：

```bash
# 调用此 skill
# skill 会自动创建所有必要的目录和文件
```

## 创建的内容

### 目录结构
```
.
├── AGENTS.md                      # AI 宪法（角色定义 + 权限约定）
├── README.md                      # 项目说明
├── .gitignore
├── .ai/
│   ├── config/
│   │   ├── coder.json             # Dev AI 配置
│   │   ├── tester.json            # QA AI 配置
│   │   └── workflow.json          # 工作流配置
│   └── prompts/
│       ├── coding/                # 编码提示词
│       └── testing/               # 测试提示词
├── projects/
│   ├── P01_app/
│   │   ├── src/                   # Dev AI 工作区
│   │   ├── tests/                 # QA AI 工作区
│   │   ├── docs/
│   │   └── ENVIRONMENT.md
│   └── P02_training/
│       ├── src/
│       ├── tests/
│       ├── docs/
│       └── ENVIRONMENT.md
├── review/
│   ├── active/                    # 活跃任务
│   │   ├── P01-001/
│   │   │   ├── task.md
│   │   │   ├── acceptance.md
│   │   │   ├── impact.md
│   │   │   └── feedback/
│   │   ├── P01-002/
│   │   └── CROSS-001/
│   └── archived/                  # 归档任务
│       └── 2026-Q2/
├── shared/
│   ├── scripts/
│   ├── templates/
│   └── utils/
├── reports/
│   ├── test-results/
│   └── quality-reports/
└── .github/workflows/
```

### 核心文件

**AGENTS.md** - AI 宪法：
- 三个角色定义（人类、Dev AI、QA AI）
- 权限矩阵
- 工作流程（8 个步骤）
- 沟通规范
- 命名规范

**AI 配置文件**：
- `.ai/config/coder.json` - Dev AI 权限和职责
- `.ai/config/tester.json` - QA AI 权限和职责
- `.ai/config/workflow.json` - 工作流配置

**示例任务**：
- `review/active/P01-001/` - 示例任务（包含 task、acceptance、impact、feedback）
- `review/active/CROSS-001/` - 跨项目任务示例

## 执行命令

```bash
# 1. 创建目录结构
mkdir -p .ai/{config,prompts/{coding,testing}} \
  projects/{P01_app,P02_training}/{src,tests,docs} \
  review/{active/{P01-001, P01-002, CROSS-001},archived/2026-Q2}/feedback \
  shared/{scripts,templates,utils} \
  reports/{test-results,quality-reports} \
  .github/workflows

# 2. 创建 AGENTS.md
cat > AGENTS.md << 'EOF'
# AI 角色定义与权限约定

## 团队架构

| 角色 | 是谁 | 干什么 | 不干什么 |
|------|------|--------|----------|
| 人类 | 你 | 下指令、审阅、做决策 | 不写代码、不写测试 |
| Dev AI | Claude/TRAE 等 | 写代码 + 文档、修 bug | 不动 tests/、不跑测试 |
| QA AI | 扣子编程 AI | 写测试、跑测试、写反馈 | 不动 src/、不改业务代码 |

## 目录权限矩阵

| 目录 | Dev AI | QA AI | 人类 |
|------|--------|-------|------|
| projects/*/src/ | ✅ | ❌ | ✅ |
| projects/*/tests/ | ❌ | ✅ | ✅ |
| projects/*/docs/ | ✅ | ❌ | ✅ |
| review/*/task.md | ❌ | ❌ | ✅ |
| review/*/acceptance.md | ✅ | ✅ | ✅ |
| review/*/impact.md | ✅ | ❌ | ✅ |
| review/*/feedback/ | ❌ | ✅ | ✅ |
| shared/ | ✅ | ❌ | ✅ |
| reports/ | ❌ | ✅ | ✅ |

## 工作流程

1. 人类创建 task.md
2. Dev AI 写代码、文档、impact.md
3. 人类审核
4. QA AI 写测试、执行、写 feedback
5. 人类确认或返回修改

## 任务状态

TODO → IN_PROGRESS → REVIEW → DONE → ARCHIVED
EOF

# 3. 创建 README.md
cat > README.md << 'EOF'
# AI 协作项目

## 目录结构

详见 AGENTS.md

## 快速开始

1. 在 review/active/ 下创建任务目录
2. 编写 task.md
3. Dev AI 开始工作
EOF

# 4. 创建 AI 配置
cat > .ai/config/coder.json << 'EOF'
{
  "name": "Dev AI",
  "role": "代码开发者",
  "allowed_paths": ["projects/*/src/", "projects/*/docs/", "shared/"],
  "forbidden_paths": ["projects/*/tests/", "reports/"]
}
EOF

cat > .ai/config/tester.json << 'EOF'
{
  "name": "QA AI",
  "role": "测试工程师",
  "allowed_paths": ["projects/*/tests/", "reports/"],
  "forbidden_paths": ["projects/*/src/", "shared/"]
}
EOF

cat > .ai/config/workflow.json << 'EOF'
{
  "workflow": "human-ai-collaboration",
  "roles": ["human", "dev-ai", "qa-ai"],
  "stages": [
    {"name": "需求分析", "actor": "human"},
    {"name": "开发实现", "actor": "dev-ai"},
    {"name": "测试执行", "actor": "qa-ai"},
    {"name": "验收确认", "actor": "human"}
  ]
}
EOF

# 5. 创建示例任务
cat > review/active/P01-001/task.md << 'EOF'
# P01-001 - 示例任务

## 任务信息
- 任务编号：P01-001
- 项目：P01_app
- 状态：TODO

## 任务描述
这是一个示例任务，展示任务单的结构。

## 交付物
- src/example.js
- tests/example.test.js
EOF

cat > review/active/P01-001/acceptance.md << 'EOF'
# P01-001 - 验收标准

## 功能验收
- [ ] 功能点 1
- [ ] 功能点 2

## 测试覆盖要求
- 单元测试覆盖率：>= 80%
EOF

cat > review/active/P01-001/impact.md << 'EOF'
# P01-001 - 变更影响范围

## 修改的文件
| 文件路径 | 修改类型 | 影响等级 |
|---------|---------|---------|
| src/example.js | 新增 | HIGH |

## 需要回归测试的场景
- 场景 1
EOF

cat > review/active/P01-001/feedback/round1.md << 'EOF'
# P01-001 - 第一轮测试反馈

## 测试结果
- 通过：0
- 失败：0

## 反馈
待执行测试
EOF

# 6. 创建项目环境文件
cat > projects/P01_app/ENVIRONMENT.md << 'EOF'
# P01_app - 环境准备

## 依赖
- Node.js >= 20.x
- npm >= 10.x

## 安装
npm install
EOF

cat > projects/P02_training/ENVIRONMENT.md << 'EOF'
# P02_training - 环境准备

## 依赖
- Python >= 3.10
- PyTorch >= 2.0

## 安装
pip install -r requirements.txt
EOF
```

## 使用场景

**何时调用此 skill：**
- ✅ 启动新的 AI 辅助编程项目
- ✅ 需要建立标准化的 AI 协作流程
- ✅ 团队开始使用"1 人+2AI"模式

**不适用场景：**
- ❌ 纯人工开发项目
- ❌ 已有现成的协作框架

## 后续步骤

skill 执行后：
1. 检查 `review/active/P01-001/` 示例任务
2. 根据实际需求修改 `AGENTS.md`
3. 创建第一个真实任务
4. 开始协作开发

---

**Version**: 1.0  
**Created**: 2026-05-22  
**Based On**: ErrLens AI Programming Project