# ai-agent-team

**Repository Path**: wckjlu/ai-agent-team

## Basic Information

- **Project Name**: ai-agent-team
- **Description**: No description available
- **Primary Language**: Shell
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-04-07
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Agent Team

<div align="center">

![AI Agent Team](https://img.shields.io/badge/AI_Agent_Team-Claude%20Code-blue)
![License](https://img.shields.io/badge/License-MIT-green)
![Version](https://img.shields.io/badge/Version-1.0.2-orange)
![npm](https://img.shields.io/npm/dw/ai-agent-team)
![GitHub stars](https://img.shields.io/github/stars/peterfei/ai-agent-team?style=social)

**🚀 拥有24/7专业AI开发团队：产品经理、前端开发、后端开发、测试工程师、DevOps工程师、技术负责人**

`npm install -g ai-agent-team` 一键安装，开发效率飙升200%！

</div>

## 🧹 TidyMyDesktop Skill - 智能桌面整理工具

> **✨ 让您的桌面和目录焕然一新！智能分类、版本去重、安全整理**

### 🌟 核心功能特色

| 🎯 智能文件分类 | 🔄 版本自动去重 | 🔍 未知软件识别 | 🛡️ 安全整理保障 |
|--------------|---------------|----------------|----------------|
| **应用程序**、文档、图片、视频等自动分类 | 识别**软件版本号**，保留最新版本，清理旧版本 | 通过**网络搜索**识别不熟悉软件的用途 | **dry-run模式**预览，用户确认后执行 |
| 创建**分类文件夹**，整洁有序 | 智能比较版本新旧，避免误删 | 标记**需要人工审核**的项目 | 所有删除操作需要**明确确认** |

### 💡 实用整理场景

| 🏠 桌面整理 | 📁 目录整理 | 🧹 版本清理 | 📊 整理报告 |
|------------|------------|------------|------------|
| **一键整理桌面**，告别混乱文件 | **整理指定目录**，提高工作效率 | **自动识别软件版本**，清理冗余文件 | **生成详细报告**，记录整理过程 |

### 🛠️ 使用方法

#### 简单三步，智能整理

1. **🏠 整理桌面**
   ```bash
   用户: "帮我整理桌面"
   Claude: 自动扫描 → 生成计划 → 用户确认 → 执行整理 → 生成报告
   ```

2. **📁 整理目录**
   ```bash
   用户: "帮我整理当前目录"
   Claude: 确认路径 → 扫描分析 → 生成计划 → 用户确认 → 整理执行
   ```

3. **🔍 智能识别**
   ```bash
   自动识别文件类型、软件版本、未知用途
   提供整理建议，确保安全可靠
   ```

### 📂 智能分类规则

- **应用程序**: 开发工具、办公软件、设计工具、通讯工具、娱乐软件、系统工具
- **文档**: PDF文档、Word文档、Excel表格、文本文件
- **媒体文件**: 图片（照片、截图、设计稿）、视频、音频
- **其他**: 压缩包、代码项目、未分类文件

### 📸 实际效果展示

![TidyMyDesktop 实际使用效果](examples/tidymydesktop.png)

*TidyMyDesktop Skill 实际整理效果截图 - 展示了智能分类和整理的结果*

#### 📝 v1.0.2 彩色手写笔记版本说明

![AI Agent Team v1.0.2 版本说明](drawnote_ai_agent_team_v1.0.2.png)

*AI Agent Team v1.0.2 彩色手写笔记风格版本说明 - 详细介绍新增的TidyMyDesktop功能和特性*

### ⚡ 技术特性

- **跨平台支持**: macOS、Windows、Linux
- **Node.js驱动**: 高性能文件操作
- **智能算法**: 版本号识别（semver）
- **安全机制**: dry-run模式，完整备份提醒
- **详细报告**: Markdown格式，包含整理统计

---

## 🎨 DrawNote Skill - 智能笔记可视化工具

> **✨ 让您的笔记变得生动有趣！将文字内容转换为精美图片**

### 🌟 核心功能特色

| 🎨 多彩风格模板 | 📋 内置模板系统 | 🤖 智能内容生成 | 🔗 无缝集成 |
|--------------|--------------|--------------|----------|
| **彩色手写笔记**、专业商务、科技创新、自然清新等多种风格 | 内置**提示词模板**和**样式模板**，无需外部文件 | 基于**AI大模型**，自动分析内容并生成最适合的笔记结构 | 与**Claude Code**完美集成，一键生成，自动保存 |

### 📝 使用方法详解

#### 简单四步，创建精美笔记

1. **📝 提供内容**
   ```bash
   skill: "drawnote"
   内容: "人工智能发展历程" 或具体笔记内容
   ```

2. **🎨 选择风格**
   ```bash
   "请使用彩色手写笔记风格" 或 "请生成学习笔记风格的信息图"
   ```

3. **🤖 AI自动生成**
   ```bash
   自动保存: drawnote_YYYYMMDD_HHMMSS.html
   ```

4. **📸 截图输出**
   ```bash
   自动保存: drawnote_YYYYMMDD_HHMMSS.png
   ```

### 💡 实用应用场景

| 📚 学习笔记总结 | 💼 商务报告可视化 | 🔧 技术文档整理 | 📊 知识梳理总结 |
|--------------|----------------|--------------|---------------|
| **荧光笔高亮**、彩色标注等学习元素 | **数据分析**、项目报告、战略规划 | **技术架构**、API文档、开发指南 | **时间线**、流程图、对比表等形式 |

### 🎯 五种精美风格

1. **彩色手写笔记风格** ⭐ 推荐
   - 适用场景：学习笔记、读书总结、知识整理
   - 特点：温馨自然、易于记忆

2. **专业商务风格**（默认）
   - 适用场景：商业报告、数据分析、项目演示
   - 特点：简洁专业、数据驱动

3. **科技创新风格**
   - 适用场景：技术文档、产品介绍、创新展示
   - 特点：现代科技、未来感强

4. **自然清新风格**
   - 适用场景：环保主题、健康生活、自然科学
   - 特点：清新淡雅、亲和力强

5. **现代简约风格**
   - 适用场景：极简设计、艺术展示、高端品牌
   - 特点：简约大气、设计感强

### 📸 实际效果展示

![DrawNote 2x2 Grid Example](drawnote_20251111_172200_2x2.png)

*上图为 AI Agent Team v1.0.1 的 DrawNote Skill 实际生成效果，展示了核心功能和应用场景的 2x2 网格布局*

---

## 🚀 快速开始

- 🎯 **六大专业智能体** - 产品经理、前端开发、后端开发、测试工程师、DevOps工程师、技术负责人
- 🧹 **TidyMyDesktop Skill** - 智能桌面整理，文件分类，版本去重，安全整理
- 🎨 **DrawNote Skill** - 智能笔记可视化，多彩风格模板，一键生成精美图片
- ⚡ **原生集成** - 完全基于Claude Code的原生智能体系统
- 🚀 **一键安装** - 支持npm全局安装，自动配置智能体环境
- ⚡ **快捷命令** - 简化的命令行调用方式，提升开发效率
- 🔄 **完整工作流** - 支持完整的产品开发流程和团队协作
- 📚 **详细文档** - 包含使用指南、最佳实践和示例
- 🛠️ **易于扩展** - 模块化设计，支持自定义智能体

## 🚀 快速开始

### 系统要求

- Claude Code (已安装并配置)
- Git

### 一键安装

#### 方式1：npm安装（推荐）
```bash
npm install -g ai-agent-team
```

#### 方式2：Shell脚本安装 (macOS/Linux)
```bash
curl -fsSL https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.sh | bash
```

#### 方式3：PowerShell安装 (Windows)
```powershell
powershell -Command "irm 'https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.ps1' | iex"
```

#### 方式4：批处理安装 (Windows)
```cmd
curl -fsSL https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.bat -o install.bat && install.bat
```

#### 方式5：手动安装

1. **克隆仓库**
```bash
git clone https://github.com/peterfei/ai-agent-team.git
cd ai-agent-team
```

2. **安装智能体配置**
```bash
# 复制智能体配置到您的Claude配置目录
cp -r .claude/* ~/.claude/
```

3. **验证安装**
```bash
# 测试智能体是否正常工作
claude -p "/agent product_manager '测试功能'"
```

### 快速使用

#### 🧹 TidyMyDesktop Skill 使用示例

```bash
# 整理桌面 - 最常用的功能
帮我整理桌面

# 整理当前目录
帮我整理当前目录

# 整理指定目录（会要求确认路径）
帮我整理下载文件夹

# 智能整理建议
帮我分析一下这个目录的文件结构，给出整理建议

# 安全预览整理计划
帮我看一下整理桌面会执行哪些操作，不要真的执行

# 针对特定类型文件整理
帮我整理桌面上的应用程序文件
```

#### 🎨 DrawNote Skill 使用示例

```bash
# 基础使用
请帮我创建一个关于"人工智能发展历程"的信息图

# 指定风格
请使用彩色手写笔记风格生成"机器学习算法分类"的信息图

# 复杂内容
请创建一个关于"微服务架构设计模式"的流程图，使用科技创新风格

# 学习笔记
请用专业商务风格创建"React Hooks"的技术文档

# 知识总结
请创建一个关于"Python数据结构"的学习总结，使用自然清新风格
```

#### 🤖 AI 智能体使用示例

```bash
# 产品经理 - 需求分析
/pm "设计用户认证系统"

# 前端开发 - UI实现
/fe "创建登录页面组件"

# 后端开发 - API开发
/be "实现JWT认证接口"

# 测试工程师 - 质量保证
/qa "测试用户认证流程"

# 运维工程师 - 部署运维
/ops "部署到生产环境"

# 技术负责人 - 架构设计
/tl "评估系统架构"
```

## 🎨 DrawNote Skill - 核心特色功能

DrawNote Skill 是 AI Agent Team v1.0.2 的核心特色功能之一，提供专业的智能笔记与流程图绘制能力。

### 🚀 核心功能

- 📝 **学习笔记可视化** - 将文字内容转化为精美的视觉笔记
- 🗺️ **知识梳理与总结** - 自动生成思维导图和信息图
- 📊 **流程图绘制** - 快速创建专业流程图和架构图
- 💡 **概念解释图表** - 复杂概念可视化呈现

### 🎯 技术特点

- **基于 Playwright** - 高质量截图引擎，自动生成 HTML 和 PNG 双格式文件
- **智能布局算法** - 自适应内容，确保最佳的视觉效果
- **内置模板系统** - 无需外部文件，使用更便捷
- **无缝集成** - 与 Claude Code 完美集成，一键生成

### 🛠️ 扩展功能

项目还支持更多 Claude Code 插件扩展，欢迎贡献更多技能！

**详细文档**: 查看 [.claude/skills/drawnote/SKILL.md](.claude/skills/drawnote/SKILL.md)

### 添加新插件

1. 将插件复制到 `.claude-plugin/` 目录
2. 更新 `marketplaces.json` 配置
3. 安装插件依赖
4. 重启 Claude Code

## 📋 智能体角色

### 🎯 产品经理 (`/pm`)
- **职责**: 产品规划、需求分析、用户研究、竞品分析
- **专长**: 敏捷开发、路线图制定、利益相关者管理
- **使用场景**: 功能需求分析、产品规划、用户体验设计

### 🎨 前端开发 (`/fe`)
- **职责**: UI实现、组件开发、用户体验优化
- **专长**: React/Vue/Angular、响应式设计、性能优化
- **使用场景**: 页面开发、组件设计、前端架构

### ⚙️ 后端开发 (`/be`)
- **职责**: API设计、数据库优化、服务器端逻辑
- **专长**: Node.js/Python/Java、数据库设计、API架构
- **使用场景**: API开发、数据库设计、系统集成

### 🧪 测试工程师 (`/qa`)
- **职责**: 功能测试、自动化测试、质量保证
- **专长**: 单元测试、集成测试、端到端测试
- **使用场景**: 测试设计、自动化测试、缺陷管理

### 🔧 DevOps工程师 (`/ops`)
- **职责**: 部署运维、基础设施、CI/CD流水线
- **专长**: Docker、Kubernetes、云服务、监控告警
- **使用场景**: 系统部署、运维监控、性能优化

### 👨‍💼 技术负责人 (`/tl`)
- **职责**: 技术决策、团队协调、架构设计
- **专长**: 系统架构、技术选型、团队管理
- **使用场景**: 架构评审、技术选型、团队规划

## 💼 工作流程示例

### 完整产品开发流程

```bash
# 1. 需求分析阶段
/pm "分析用户认证系统需求，包括功能规格、用户故事和验收标准"

# 2. 技术设计阶段
/tl "设计用户认证系统的技术架构，包括前后端分离、JWT认证、数据库设计"

# 3. 后端开发阶段
/be "实现JWT认证API，包括登录、注册、token刷新功能"

# 4. 前端开发阶段
/fe "创建React登录组件，包含表单验证、错误处理和响应式设计"

# 5. 测试验证阶段
/qa "设计用户认证系统的完整测试用例，包括功能测试和安全测试"

# 6. 部署上线阶段
/ops "配置用户认证系统的生产环境部署，包括Docker容器化和CI/CD流水线"
```

### 并行开发模式

```bash
# 需求定义
/pm "分析实时协作功能需求"

# 并行开发
/be "构建WebSocket实时协作API" &
/fe "创建协作编辑界面" &

# 等待前后端开发完成
wait

# 集成测试
/qa "测试实时协作端到端流程"

# 部署
/ops "部署协作功能到生产环境"
```

## 🛠️ CLI工具

项目包含跨平台CLI工具，提供更友好的命令行界面：

### macOS/Linux
```bash
# 使用CLI工具调用智能体
./.claude/agents/cli.sh pm "设计用户认证系统"
./.claude/agents/cli.sh 前端 "创建登录页面"
./.claude/agents/cli.sh backend "实现JWT API"
./.claude/agents/cli.sh 测试 "测试认证流程"
./.claude/agents/cli.sh 运维 "部署到生产环境"
```

### Windows PowerShell
```powershell
# 使用CLI工具调用智能体
.\.claude\agents\cli.ps1 pm "设计用户认证系统"
.\.claude\agents\cli.ps1 fe "创建登录页面"
.\.claude\agents\cli.ps1 be "实现JWT API"
.\.claude\agents\cli.ps1 qa "测试认证流程"
.\.claude\agents\cli.ps1 ops "部署到生产环境"
```

CLI工具特性：
- 🎨 彩色输出界面
- 🔍 智能体名称映射（支持中英文）
- 💡 下一步建议
- ❌ 错误处理和帮助信息
- 📊 调试模式支持

## 📁 项目结构

```
ai-agent-team/
├── .claude/
│   ├── agents/                  # 智能体配置文件
│   │   ├── product_manager.md   # 产品经理智能体
│   │   ├── frontend_dev.md      # 前端开发智能体
│   │   ├── backend_dev.md       # 后端开发智能体
│   │   ├── qa_engineer.md       # 测试工程师智能体
│   │   ├── devops_engineer.md   # 运维工程师智能体
│   │   ├── tech-leader.md       # 技术负责人智能体
│   │   └── cli.sh              # CLI工具脚本
│   ├── commands/               # 快捷命令配置
│   │   ├── pm.md              # 产品经理快捷命令
│   │   ├── fe.md              # 前端开发快捷命令
│   │   ├── be.md              # 后端开发快捷命令
│   │   ├── qa.md              # 测试工程师快捷命令
│   │   ├── ops.md             # 运维工程师快捷命令
│   │   ├── tl.md              # 技术负责人快捷命令
│   │   └── README.md          # 命令说明文档
│   ├── skills/               # 智能技能集合
│   │   ├── drawnote/         # DrawNote智能笔记技能
│   │   │   ├── scripts/      # 脚本文件
│   │   │   ├── styles/       # 风格模板
│   │   │   ├── SKILL.md      # 技能说明
│   │   │   └── package.json  # 依赖配置
│   │   └── tidymydesktop/    # TidyMyDesktop桌面整理技能
│   │       ├── scripts/      # 整理脚本（scan, organize, classify）
│   │       ├── tidy-*        # 可执行工具脚本
│   │       ├── SKILL.md      # 技能说明文档
│   │       ├── TEST_REPORT.md # 测试报告
│   │       └── package.json  # 依赖配置
│   ├── CLAUDE.md              # 项目说明文档
│   └── settings.local.json   # 本地配置文件
├── docs/                      # 文档目录
│   └── BEST_PRACTICES.md      # 最佳实践指南
├── examples/                  # 示例项目和截图
│   ├── web-app/               # Web应用开发示例
│   └── tidymydesktop.png      # TidyMyDesktop效果截图
├── scripts/                   # 辅助脚本
│   └── install.sh            # 安装脚本
├── bin/                       # 可执行文件
│   └── ai-agent-team.js      # CLI工具
├── install.sh                 # Shell安装脚本 (macOS/Linux)
├── install.ps1                # PowerShell安装脚本 (Windows)
├── install.bat                # 批处理安装脚本 (Windows)
├── test-windows-compatibility.ps1  # Windows兼容性测试脚本
├── package.json               # npm包配置
├── README.md                  # 项目说明
├── LICENSE                    # 开源许可证
├── CONTRIBUTING.md            # 贡献指南
└── CHANGELOG.md               # 更新日志

## 📦 npm包信息

- **包名**: `ai-agent-team`
- **版本**: 1.0.2
- **安装**: `npm install -g ai-agent-team`
- **npm页面**: https://www.npmjs.com/package/ai-agent-team

## 🎯 使用场景

### 1. 个人开发者
- 快速原型开发
- 全栈项目开发
- 技术学习参考

### 2. 初创团队
- MVP快速开发
- 团队协作规范
- 技术选型指导

### 3. 企业开发
- 标准化开发流程
- 新人培训
- 最佳实践推广

### 4. 教育培训
- 编程教学辅助
- 项目实战指导
- 团队协作培训

## 📈 最佳实践

### 1. 清晰的任务描述
```bash
# 好的示例
/pm "为电商网站设计购物车功能，包括添加商品、数量调整、价格计算和结算流程"

# 避免模糊描述
/pm "做个购物车"
```

### 2. 提供上下文信息
```bash
# 包含项目背景
/be "基于我们现有的Express.js用户系统，添加OAuth2集成功能"
```

### 3. 迭代式开发
```bash
# 分阶段实施
/pm "第一阶段：设计用户认证的MVP功能"
/be "第一阶段：实现基础的注册和登录API"
/fe "第一阶段：创建简单的登录表单"
```

### 4. 团队协作
```bash
# 确保智能体间的工作协调
/fe "基于产品需求文档和后端API设计，创建用户界面"
/qa "测试前端界面与后端API的完整集成"
```

## 🔧 高级配置

### 自定义智能体

1. 创建智能体配置文件：
```bash
cp .claude/agents/product_manager.md .claude/agents/custom_agent.md
```

2. 编辑配置文件，修改角色和能力
3. 创建对应的快捷命令：
```bash
cp .claude/commands/pm.md .claude/commands/custom.md
```

### 环境变量配置
```bash
# Claude Code配置
export CLAUDE_API_KEY="your-api-key"
export CLAUDE_MODEL="claude-3-sonnet"

# 智能体配置
export AGENT_TIMEOUT=300
export AGENT_MAX_TOKENS=4000
```

## 💻 Windows 支持

ai-agent-team 全面支持 Windows 系统，提供多种安装方式：

### 安装方式

1. **PowerShell安装（推荐）**
```powershell
powershell -Command "irm 'https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.ps1' | iex"
```

2. **批处理安装**
```cmd
curl -fsSL https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.bat -o install.bat && install.bat
```

3. **npm安装**
```cmd
npm install -g ai-agent-team
```

### Windows 特性

- ✅ PowerShell 5.0+ 支持
- ✅ Windows 10/11 兼容
- ✅ 批处理脚本兼容
- ✅ 中文路径支持
- ✅ 防火墙和杀毒软件兼容

### 系统要求

- Windows 10/11 或 Windows Server 2016+
- PowerShell 5.0 或更高版本
- Claude Code (已安装)
- 网络连接

### 兼容性测试

运行兼容性测试脚本检查您的系统：

```powershell
powershell -Command "irm 'https://raw.githubusercontent.com/peterfei/ai-agent-team/main/test-windows-compatibility.ps1' | iex"
```

### 常见问题

**Q: PowerShell 执行策略限制怎么办？**
```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

**Q: 杀毒软件报误怎么办？**
将以下目录添加到白名单：
- `%USERPROFILE%\.claude\`
- 安装目录

**Q: Node.js 安装失败怎么办？**
- 手动下载安装 Node.js: https://nodejs.org/
- 或使用 winget: `winget install OpenJS.NodeJS`

## ❓ 常见问题

<details>
<summary>智能体无响应怎么办？</summary>

1. 检查Claude Code是否正确安装：`claude --version`
2. 验证配置文件是否存在：`ls ~/.claude/agents/`
3. 测试基础功能：`claude -p "测试连接"`
4. 重新安装配置：`./scripts/install.sh`
</details>

<details>
<summary>如何提高任务完成质量？</summary>

1. 提供详细的任务描述和上下文
2. 分步骤分解复杂任务
3. 明确指定技术栈和约束条件
4. 提供示例和参考资料
</details>

<details>
<summary>支持哪些编程语言和框架？</summary>

智能体支持主流的编程语言和框架：
- 前端：React, Vue, Angular, Svelte等
- 后端：Node.js, Python, Java, Go, PHP等
- 数据库：MySQL, PostgreSQL, MongoDB, Redis等
- 云服务：AWS, Azure, GCP, 阿里云等
</details>

## 🤝 贡献指南

我们欢迎所有形式的贡献！

### 贡献方式

1. **报告问题** - 在Issues中提交bug报告或功能建议
2. **提交代码** - Fork项目并提交Pull Request
3. **完善文档** - 改进文档质量和完整性
4. **分享经验** - 分享使用案例和最佳实践

### 开发流程

1. Fork项目 (在 https://github.com/peterfei/ai-agent-team)
2. 创建功能分支：`git checkout -b feature/new-feature`
3. 提交更改：`git commit -m 'Add new feature'`
4. 推送分支：`git push origin feature/new-feature`
5. 创建Pull Request

## 📄 许可证

本项目采用 [MIT License](LICENSE) 开源许可证。

## 🙏 致谢

- 感谢 [Anthropic](https://anthropic.com) 提供强大的Claude Code平台
- 感谢所有贡献者和用户的支持和反馈
- 感谢开源社区的技术和灵感

## 📝 更新日志

查看详细的版本更新历史：
- **[CHANGELOG.md](CHANGELOG.md)** - 完整的版本更新记录
- **[v1.0.2 发布日志](RELEASE_NOTES_1.0.2.md)** - 最新版本的详细发布说明
- **[v1.0.1 发布日志](RELEASE_NOTES_1.0.1.md)** - 上一版本的发布说明

## 📞 联系我们

- 📧 Email: [peterfeispace@gmail.com](mailto:peterfeispace@gmail.com)
- 🐛 Issues: [GitHub Issues](https://github.com/peterfei/ai-agent-team/issues)
- 💬 Discussions: [GitHub Discussions](https://github.com/peterfei/ai-agent-team/discussions)

---

<div align="center">

**⭐ 如果这个项目对您有帮助，请给我们一个Star！⭐**

Made with ❤️ by AI Agent Team

</div>