Initial commit: 1人+2AI协作框架 - 完整目录结构和AI宪法

2026-05-22 15:27:36 +08:00
commit 837d067928
30 changed files with 1498 additions and 0 deletions
@@ -0,0 +1,287 @@
+---
+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