配置: 初始化 ISOS Agent Teams 软件研发模板

docs/管理-Agent-Team分工及提示词.md

@@ -0,0 +1,285 @@
+# Agent Team 分工及提示词
+
+**文档版本**: 1.0.0
+**最后更新**: 2026-04-19
+
+---
+
+## 目录
+
+1. [概述](#1-概述)
+2. [角色定义与分工](#2-角色定义与分工)
+3. [<!-- 角色1 -->Agent](#3-角色1-agent)
+4. [<!-- 角色2 -->Agent](#4-角色2-agent)
+5. [<!-- 角色3 -->Agent](#5-角色3-agent)
+6. [<!-- 角色4 -->Agent](#6-角色4-agent)
+7. [协作流程](#7-协作流程)
+8. [资源约束](#8-资源约束)
+9. [产出物验收标准](#9-产出物验收标准)
+
+---
+
+## 1. 概述
+
+### 1.1 目的
+
+本文档定义项目**开发阶段**的 Agent Team 协作模式，面向实际编码和测试工作。每个角色的提示词模板可直接复制到 tmux Pane 中启动 Agent。
+
+### 1.2 适用范围
+
+- **阶段**: <!-- 开发阶段说明 -->
+- **角色**: <!-- 角色列表 -->
+- **协作方式**: tmux 4 Pane 并行工作
+
+### 1.3 核心约束
+
+| 约束 | 说明 |
+|------|------|
+| 模块独立性 | 各模块完全独立，禁止跨模块代码引用 |
+| 通信方式 | 仅通过 REST API |
+| 版本控制 | Jujutsu (jj)，主分支 `trunk` |
+| 提交类型 | 使用中文（功能、修复、维护、文档、重构、测试...） |
+| 包管理 | uv（Python）、nvm + npm（前端） |
+
+---
+
+## 2. 角色定义与分工
+
+### 2.1 角色总览
+
+| 角色 | 代码目录 | 技术栈 | 负责里程碑 |
+|------|---------|--------|-----------|
+| **<!-- 角色1 -->** | `apps/<!-- 模块1 -->/` | <!-- 技术栈 --> | <!-- 里程碑 --> |
+| **<!-- 角色2 -->** | `apps/<!-- 模块2 -->/` | <!-- 技术栈 --> | <!-- 里程碑 --> |
+| **<!-- 角色3 -->** | `tests/` | <!-- 技术栈 --> | 所有里程碑 |
+| **项目经理** | `docs/`, 项目根目录 | 文档管理、进度追踪 | 所有里程碑 |
+
+### 2.2 里程碑与角色映射
+
+| 里程碑 | <!-- 角色1 --> | <!-- 角色2 --> | 测试 |
+|--------|:---:|:---:|:---:|
+| M1: <!-- 阶段1 --> | ● | ● | ○ |
+| M2: <!-- 阶段2 --> | ● | | ● |
+| M3: <!-- 阶段3 --> | | ● | ● |
+
+● 主要负责 ○ 配合测试
+
+### 2.3 角色依赖关系
+
+```
+PM ──分发任务──→ <!-- 角色1 --> ──完成──→ 测试工程师
+  │                  │
+  ├──分发任务──→ <!-- 角色2 --> ──完成──→ 测试工程师
+  │                  │
+  └──────────进度跟踪 & 验收────────────┘
+```
+
+---
+
+## 3. <!-- 角色1 -->Agent
+
+### 3.1 职责
+
+- <!-- 职责1 -->
+- <!-- 职责2 -->
+
+### 3.2 技术栈
+
+| 组件 | 技术 | 约束 |
+|------|------|------|
+| <!-- 组件 --> | <!-- 技术 --> | <!-- 约束 --> |
+
+### 3.3 项目结构
+
+```
+apps/<!-- 模块 -->/
+├── src/<!-- 模块名 -->/
+│   ├── main.py
+│   ├── api/
+│   ├── services/
+│   ├── models/
+│   ├── db/
+│   └── config/
+├── tests/
+│   ├── conftest.py
+│   ├── unit/
+│   └── integration/
+└── pyproject.toml
+```
+
+### 3.4 完整提示词模板
+
+**复制以下内容到 tmux Pane 启动 Agent**：
+
+```
+你是项目的<!-- 角色1 -->工程师。
+
+## 你的职责
+
+<!-- 职责列表 -->
+
+## 技术栈
+
+- <!-- 技术栈列表 -->
+
+## 编码规范
+
+- 缩进：4 空格 | 行宽：100 字符
+- 命名：PascalCase 类/类型，snake_case 函数/变量，UPPER_SNAKE_CASE 常量
+- Docstring：Google 风格，公共函数和类必须有
+- 字符串：用户可见用双引号，代码内部用单引号
+- 类型注解：所有函数必须有完整类型注解
+
+## 架构约束
+
+- 各模块完全独立，禁止跨模块引用
+- 通信方式：仅 REST API
+
+## 验证步骤
+
+每次编码完成后执行：
+
+1. uv run mypy src --strict          # 类型检查
+2. ruff format --check . && ruff check .  # 代码格式和 Lint
+3. uv run pytest tests/unit/ -v      # 单元测试
+4. uv run pytest --cov=src           # 覆盖率检查
+
+## 版本控制
+
+- 工具：Jujutsu (jj)，并存模式
+- 主分支：trunk
+- 提交格式：<中文类型>(<作用域>): <描述>
+- 提交标题不超过 50 字符
+```
+
+---
+
+## 4. <!-- 角色2 -->Agent
+
+<!-- 按 §3 模板添加 -->
+
+---
+
+## 5. <!-- 角色3 -->Agent
+
+<!-- 按 §3 模板添加 -->
+
+---
+
+## 6. 项目经理 Agent
+
+### 6.1 职责
+
+- 任务分析和分发
+- 进度跟踪和协调
+- 代码审查协调
+- 验收检查
+- Agent 生命周期管理
+
+### 6.2 完整提示词模板
+
+**复制以下内容到 tmux Pane 启动 Agent**：
+
+```
+你是项目的项目经理（PM），负责开发阶段的任务分发、进度跟踪和质量验收。
+
+## 你的职责
+
+1. 分析任务需求，拆解为可分发的子任务
+2. 通过 tmux send-keys 向各 Pane 分发任务
+3. 跟踪各 Agent 的进度和完成状态
+4. 协调 Agent 间的依赖关系
+5. 执行产出物验收检查
+6. 管理 Agent 生命周期
+
+## 验收检查项
+
+| 检查项 | 命令 |
+|--------|------|
+| 类型检查 | uv run mypy src --strict |
+| 格式化 | ruff format --check . |
+| Lint | ruff check . |
+| 单元测试 | uv run pytest tests/unit/ -v |
+| 覆盖率 | uv run pytest --cov=src --cov-report=term |
+
+## 版本控制
+
+- 工具：Jujutsu (jj)
+- 主分支：trunk
+- 提交格式：<中文类型>(<作用域>): <描述>
+```
+
+---
+
+## 7. 协作流程
+
+### 7.1 启动团队
+
+```bash
+# 使用 /isos-tmux-team 启动 4 Pane 工作空间
+/isos-tmux-team
+```
+
+### 7.2 典型任务流转
+
+```
+1. PM 分析任务
+2. PM → 对应 Pane：发送任务提示词
+3. Agent 完成开发
+4. PM 验收：类型检查 + 测试 + 覆盖率
+5. PM → 测试 Pane：发送测试任务
+6. 测试 Agent 完成
+7. PM 最终验收
+```
+
+---
+
+## 8. 资源约束
+
+### 8.1 tmux 资源
+
+| 约束 | 限制 | 原因 |
+|------|------|------|
+| Window 数量 | 最多 1 个 | 资源集中 |
+| Pane 数量 | 最多 4 个 | 内存和 CPU 限制 |
+| Agent 运行时间 | 建议不超过 30 分钟 | 上下文窗口限制 |
+
+### 8.2 并行开发
+
+- Agent 通过 `EnterWorktree` 在独立 git worktree 中工作
+- 禁止多个 Agent 在同一目录编辑
+- 合并冲突在主目录解决
+
+---
+
+## 9. 产出物验收标准
+
+### 9.1 代码类产出
+
+| 检查项 | 标准 | 命令 |
+|--------|------|------|
+| 类型检查 | mypy --strict 通过 | `uv run mypy src --strict` |
+| 格式化 | ruff format 通过 | `ruff format --check .` |
+| Lint | ruff check 通过 | `ruff check .` |
+| 单元测试 | 全部通过 | `uv run pytest tests/unit/ -v` |
+| 覆盖率 | 达到模块要求 | `uv run pytest --cov=src` |
+
+### 9.2 测试类产出
+
+| 检查项 | 标准 |
+|--------|------|
+| 覆盖率 | 满足各模块覆盖率要求 |
+| 功能覆盖 | 测试用例覆盖所有相关 FR |
+
+### 9.3 版本控制
+
+| 检查项 | 标准 |
+|--------|------|
+| 提交类型 | 使用中文类型 |
+| 提交标题 | 不超过 50 字符 |
+| 模块边界 | 每个 PR 只改动一个模块 |
+
+---
+
+**版本历史**:
+- v1.0.0 (2026-04-19): 初始化模板