# cursor-agent-team

**Repository Path**: thiswind/cursor-agent-team

## Basic Information

- **Project Name**: cursor-agent-team
- **Description**: Cursor AI Agent Team Framework: A three-agent collaboration system for AI-assisted work
- **Primary Language**: Shell
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-30
- **Last Updated**: 2026-01-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cursor AI 智能体团队框架

![框架横幅](banner.png)

一个用于 Cursor IDE 的三智能体协作系统，安装自定义命令并支持团队扩展。

## 概述

本框架会将三个核心 Cursor 命令（角色）安装到您的项目中：

- **`/discuss`** - 讨论伙伴：谋士，分析问题、探索想法、制定方案
- **`/crew`** - 万能打工人：执行者，严格按照方案执行任务
- **`/prompt_engineer`** - 提示词工程师：HR+培训师，创建新角色（新的 Cursor 命令）

有了这三个核心角色，团队就可以运作。提示词工程师可以根据需要创建更多角色，让团队得以扩展。

## 团队角色

### 讨论伙伴 (`/discuss`)
团队的谋士。参与讨论、分析问题、探索解决方案，并生成可执行方案。不直接修改项目文件，只提供策略和方案。

### 万能打工人 (`/crew`)
团队的执行者。接收讨论伙伴制定的方案，逐步执行。严格按照方案规范执行，不偏离。

### 提示词工程师 (`/prompt_engineer`)
团队的 HR 和培训师。创建和维护新角色（Cursor 命令）。当你需要新的专门角色时，提示词工程师帮助创建新的命令文件和规则文件。

## 工作流程

1. **制定方案**：使用 `/discuss` 探索想法并生成执行方案
2. **执行方案**：使用 `/crew` 执行方案
3. **扩展团队**：需要时使用 `/prompt_engineer` 创建新角色

## 附加功能

框架还包含扩展核心功能的附加功能：

### Spec-Kit 转换器 (`/spec_translator`)

用于 [Spec-Kit](https://github.com/github/spec-kit) 工作流集成的转换工具。将 `/discuss` 生成的执行方案转换为符合 spec-kit 格式的文档。

**用途**：当项目使用 Spec-Kit 进行规范驱动开发时，此工具会自动将 Plan 文件转换为三个 spec-kit 文档：
- `constitution.md` - 项目治理原则和开发指南
- `specify.md` - 需求规范文档
- `plan.md` - 技术实施计划

**使用方法**：
```
/spec_translator PLAN-B-001
```

**工作流集成**：
1. 使用 `/discuss` 为软件开发任务生成执行方案
2. 使用 `/spec_translator` 将方案转换为 spec-kit 文档
3. 使用 spec-kit 命令（clarify、tasks 等）继续开发

**注意**：这是附加功能，不是核心团队角色。它仅处理软件开发任务，会自动拒绝非软件开发方案。

有关 Spec-Kit 的更多信息，请访问 [Spec-Kit 仓库](https://github.com/github/spec-kit)。

## 使用示例

### 步骤 1：讨论并制定方案
```
/discuss
我想在论文中添加一个关于计算复杂度的新章节。
应该包含哪些内容？
```

讨论完成后，生成方案：
```
/discuss
讨论已经可以了，可以生成方案了
```

讨论伙伴生成方案：`PLAN-A-001`

### 步骤 2：执行方案
```
/crew PLAN-A-001
```

万能打工人逐步执行方案。

### 步骤 3：创建新角色（可选）
如果需要为特定任务创建专门角色：
```
/prompt_engineer
我需要一个生成图表标题的角色
```

提示词工程师创建：
- `.cursor/commands/figure_caption.md` - 新命令 `/figure_caption`
- `.cursor/rules/figure_caption_assistant.mdc` - 该角色的规则

现在你可以在 Cursor 中使用 `/figure_caption`，就像使用三个核心命令一样。

## 安装

### 步骤 1：添加 Git 子模块
```bash
git submodule add https://github.com/thiswind/cursor-agent-team.git cursor-agent-team
```

### 步骤 2：运行安装脚本
```bash
./cursor-agent-team/install.sh
```

这会将三个核心命令安装到 `.cursor/commands/`，规则安装到 `.cursor/rules/`。

### 更新
```bash
git submodule update --remote cursor-agent-team
./cursor-agent-team/install.sh
```

### 卸载
```bash
./cursor-agent-team/uninstall.sh
```

## 许可证

本项目采用 GNU 通用公共许可证 v3.0 (GPL-3.0) 许可。

详情请参阅 [LICENSE](LICENSE) 文件。

## 版本

当前版本：**v0.3.0**

版本历史请参阅 [CHANGELOG.md](CHANGELOG.md)。

## 贡献

欢迎贡献！请随时提交 Pull Request。

## 作者

**thiswind**

- GitHub: [@thiswind](https://github.com/thiswind)