isos/team

Fork 0

Files

arno 34346be862

CI / lint (push) Successful in 6s

Details

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

2026-04-19 21:47:08 +08:00

6.7 KiB

Raw Permalink Blame History

Agent Team 分工及提示词

文档版本: 1.0.0 最后更新: 2026-04-19

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 角色总览

角色	代码目录	技术栈	负责里程碑
	`apps/<!-- 模块1 -->/`
	`apps/<!-- 模块2 -->/`
	`tests/`		所有里程碑
项目经理	`docs/`, 项目根目录	文档管理、进度追踪	所有里程碑

2.2 里程碑与角色映射

里程碑			测试
M1:	●	●	○
M2:	●		●
M3:		●	●

● 主要负责 ○ 配合测试

2.3 角色依赖关系

PM ──分发任务──→ <!-- 角色1 --> ──完成──→ 测试工程师
  │                  │
  ├──分发任务──→ <!-- 角色2 --> ──完成──→ 测试工程师
  │                  │
  └──────────进度跟踪 & 验收────────────┘

3. Agent

3.1 职责

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

5. Agent

6. 项目经理 Agent

6.1 职责

任务分析和分发
进度跟踪和协调
代码审查协调
验收检查
Agent 生命周期管理

6.2 完整提示词模板