ai-agent-team
v2.0.1
Published
AI Agent Team - 拥有24/7专业AI开发团队：产品经理、前端开发、后端开发、测试工程师、DevOps工程师、技术负责人。全新Thread Manager让AI拥有记忆！支持任务线程管理、自动Git版本控制、完整上下文恢复。一键安装，开发效率飙升200%！集成drawnote、tidymydesktop、softcopyright、changelog-generator和thread-manager五大智能Skill。
Maintainers
peterfeiKeywords
Readme
AI Agent Team
🚀 拥有24/7专业AI开发团队：产品经理、前端开发、后端开发、测试工程师、DevOps工程师、技术负责人
💾 Thread Manager 让 AI 拥有记忆！ 语义搜索 | 任务线程管理 | 完整上下文恢复 | 自动 Git 版本控制
⚡ 只需 3 步完成安装 → 马上开始使用！
🌟 v2.0.1 核心亮点与架构概览
🚀 核心亮点
🌟 核心价值主张：认知能力升级
Thread Manager v2.0.1 实现了分层记忆架构，将简单的对话管理升级为具备认知能力的 AI 记忆系统：
- 30-50% 的上下文准确率提升 - 通过语义检索替代时间检索
- 跨线程知识复用 - AI可以学习和积累经验
- 10倍的检索效率 - 向量索引 vs 全表扫描
- 更自然的交互体验 - AI能"记住"用户的习惯和偏好
1. 🧠 Thread Manager 语义搜索
- 自然语言查询: 告别关键词，AI 理解意图，精准定位历史对话。
- 跨时间记忆: 轻松回溯数周前的讨论，无惧遗忘。
- 本地向量数据库: 所有消息本地向量化存储，确保数据隐私与高效检索。
2. 📦 内置模型 & 离线优先
- 内置嵌入模型:
Xenova/all-MiniLM-L6-v2模型直接打包，无需联网下载。 - 零配置开箱即用: 安装即用，国内网络环境安装成功率 100%。
3. 🛠️ 初始化与迁移优化
- 自动化构建:
init命令自动编译 TypeScript。 - 一键迁移:
npm run migrate脚本自动处理旧数据向量化。
🏗️ 架构概览
Thread Manager v2.0.1 引入了全新的向量检索层：
graph TD
User[用户] -->|自然语言查询| Agent[Claude AI 助手]
Agent -->|调用工具| MCP[Thread Manager MCP Server]
subgraph "Thread Manager Core"
MCP -->|解析请求| TM[Thread Manager]
TM -->|语义搜索| Search[Vector Search Engine]
TM -->|添加消息| MsgDAO[Messages DAO]
MsgDAO -->|生成向量| Embed[Embedding Service]
Embed -->|加载模型| LocalModel[📦 本地内置模型]
LocalModel -.->|Xenova/all-MiniLM-L6-v2| Embed
Search -->|查询| DB[(SQLite Database)]
MsgDAO -->|存储| DB
end
DB -->|返回结果| Search
Search -->|相关消息列表| TM
TM -->|格式化上下文| MCP
MCP -->|精准回复| Agent📦 安装指南
快速安装（3 步完成）
⚠️ 重要：v2.0.0 引入 Thread Manager 记忆系统，需要完成以下 3 个步骤才能使用完整功能！
┌─────────────────────────────────────────────────┐
│ 第 1 步: npm install -g ai-agent-team │
│ ↓ 安装 AI 智能体团队 │
└─────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────┐
│ 第 2 步: ai-agent-team init │
│ ↓ 初始化配置（全局或项目） │
└─────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────┐
│ 第 3 步: claude mcp add thread-manager │
│ ↓ 启用 Thread Manager MCP 服务器 │
└─────────────────────────────────────────────────┘
↓
✅ 安装完成！第 1 步：安装 AI Agent Team
npm install -g ai-agent-team第 2 步：初始化配置 ⭐ 必须执行
选择 A：全局初始化（推荐 - 所有项目共享）
ai-agent-team init这将在 ~/.claude/ 创建全局配置，所有项目都可使用 AI 智能体团队。
选择 B：项目本地初始化（项目独立配置）
cd your-project
ai-agent-team init这将在项目的 .claude/ 创建本地配置，仅当前项目可用。
第 3 步：启用 Thread Manager MCP 服务器 ⭐ 关键步骤
claude mcp add thread-manager node "/YOURSELFPROJECTPATH/.claude/skills/thread-manager/dist/index.js"
为什么需要这一步？
- Thread Manager 作为 MCP 服务器运行，提供持久化记忆功能
- 只需配置一次，永久生效
- 不执行此步骤将无法使用
/threads、/pm-start等线程管理命令
✅ 验证安装
重启 Claude Code 后测试：
# 1. 查看所有线程
/threads
# 2. 创建第一个任务线程
/pm-start "我的第一个任务"
# 3. 查看当前线程信息
/thread info如果看到线程列表输出，说明安装成功！🎉
🎯 两种初始化方式对比
| 特性 | 全局初始化 | 项目本地初始化 |
|------|-----------|---------------|
| 配置位置 | ~/.claude/ | ./.claude/ |
| 适用范围 | 所有项目 | 仅当前项目 |
| 团队协作 | 个人使用 | 可提交到 Git |
| 数据隔离 | 共享线程数据 | 项目独立线程 |
| 推荐场景 | 个人开发者 | 团队项目 |
💡 提示：大多数情况推荐使用全局初始化，除非你需要在不同项目间完全隔离线程数据。
❓ 常见问题
原因：未启用 Thread Manager MCP 服务器
解决：
# 1. 执行 MCP 服务器配置
claude mcp add thread-manager node "/YOURSELFPROJECTPATH/.claude/skills/thread-manager/dist/index.js"
# 2. 重启 Claude Code
exit
claude
# 3. 验证
/threads| 特性 | 全局初始化 | 项目初始化 |
|------|-----------|-----------|
| 配置位置 | ~/.claude/ | ./.claude/ |
| 线程数据 | 所有项目共享 | 项目独立 |
| 适用场景 | 个人开发 | 团队协作 |
推荐：个人使用选全局，团队项目选本地。
# 方法 1: 查看线程列表
/threads
# 方法 2: 查看当前线程
/thread info
# 方法 3: 创建测试线程
/pm-start "测试线程"如果以上命令正常工作，说明 Thread Manager 运行正常。
可以！Claude Code 会优先使用项目本地配置（./.claude/），如果不存在则使用全局配置（~/.claude/）。
这意味着你可以：
- 全局配置作为默认
- 特定项目使用独立配置
🧠 Thread Manager - AI 团队的记忆系统 ⭐ NEW in v2.0.0
🎉 v2.0.1 更新：语义搜索 & 离线模型
现在，Thread Manager 不仅能记住对话，还能理解对话！
- 语义搜索: 使用自然语言查找历史信息（"找一下关于登录逻辑的讨论"）。
- 离线优先: 内置向量模型，无需联网下载，国内环境安装成功率 100%。
🚀 核心亮点
💾 持久化记忆
- ✅ 语义搜索历史消息
- ✅ 对话永久保存
- ✅ 随时恢复上下文
- ✅ 多任务并行管理
🌿 Git 自动集成
- ✅ 自动创建任务分支
- ✅ 文件变更追踪
- ✅ 代码统计分析
- ✅ 完整版本控制
🎯 智能体快启
- ✅
/pm-start产品设计 - ✅
/fe-start前端开发 - ✅
/be-start后端开发 - ✅
/qa-start质量保证
📊 Thread Manager vs 原生 Claude
| 功能 | 原生 Claude | Thread Manager | 提升 | |------|------------|----------------|------| | 上下文记忆 | ❌ 重启丢失 | ✅ 永久保存 | ∞ | | 多任务管理 | ❌ 单线程 | ✅ 无限并行 | 10x+ | | 任务恢复 | ❌ 无法恢复 | ✅ 完整恢复 | 新增 | | 版本控制 | ⚠️ 手动 | ✅ 自动 | 3x | | 工作效率 | 100% | 200%+ | 2x |
🎮 基础使用
创建任务线程（自动初始化角色）
/pm-start "设计电商购物车功能"
↓ 自动创建产品线程
↓ AI 立即以产品经理身份分析需求
↓ 对话历史永久保存多任务并行开发
/be-start "实现购物车 API" # 线程 1: 后端开发
/fe-start "设计购物车UI" # 线程 2: 前端开发
/qa-start "测试购物车功能" # 线程 3: QA 测试
/threads # 查看所有线程进度切换线程（完整上下文恢复）
/thread switch abc123
↓ AI 立即加载线程 abc123 的所有历史对话
↓ 文件变更、代码统计一并恢复
↓ 就像从未离开过这个任务💡 核心命令
| 命令 | 功能 | 示例 |
|------|------|------|
| /threads | 查看所有线程 | 列出任务、消息数、文件变更 |
| /thread switch <id> | 切换线程 | 完整恢复历史上下文 |
| /pm-start "任务" | 产品经理线程 | 创建线程 + 需求分析 |
| /fe-start "任务" | 前端开发线程 | 创建线程 + UI 开发 |
| /be-start "任务" | 后端开发线程 | 创建线程 + API 开发 |
| /qa-start "任务" | QA 测试线程 | 创建线程 + 执行测试 |
🔥 实际应用场景
多任务并行开发:
# 同时进行 3 个功能开发
/pm-start "用户认证系统" # 线程 1: 产品设计
/be-start "支付接口集成" # 线程 2: 后端开发
/fe-start "数据可视化大屏" # 线程 3: 前端开发
# 随时切换，零上下文损失
/threads # 查看所有任务进度
/thread switch abc123 # 切换到认证系统长期项目管理:
# 项目周期 3 个月，AI 记住每一次对话
/pm-start "企业 ERP 系统设计"
# ... 3 个月后 ...
/thread switch abc123 # AI 完整恢复 3 个月前的上下文团队协作共享:
# 开发者 A
/pm-start "新功能设计" # 线程 ID: abc12345
# 开发者 B（另一台电脑）
clt abc12345 # 恢复 A 的完整上下文📝 Changelog Generator Skill - 智能变更日志生成器
# 1. 快速生成 HTML 格式变更日志
changelog-generate generate --all --format html
# 2. 发布新版本并创建 GitHub Release
changelog-generate release --github-release
# 3. 增量更新
changelog-generate update💡 为什么选择它？
- 零配置启动：内置最佳实践配置，开箱即用
- 完全自动化：从 Git 历史到 GitHub Release，一键完成
- 专业级输出：不仅是 Markdown，更能生成交互式 HTML 报告
- 高度可定制：通过 Handlebars 模板完全掌控输出格式
📜 SoftCopyright Skill - 智能软著材料生成工具
✨ 一键生成软件著作权申请材料，让软著申请变得简单高效！
🌟 核心功能特色
| 📋 智能项目分析 | 📄 HTML文档生成 | 🔄 版本自动识别 | 🖨️ 完美打印支持 | |-------------|--------------|--------------|-------------| | 自动识别项目类型、技术栈和架构模式 | 生成符合要求的软件说明书和源代码文档 | 从package.json等配置文件自动读取版本号 | 支持浏览器打印为PDF，页眉页脚自动添加 | | 支持README解析，无package.json时智能识别项目 | 每页50行代码，符合软著页数要求 | 支持多语言项目（JavaScript、Python、Java等） | 智能注释清理，只保留有效代码 |
🎯 软著申请完全支持
核心功能
- ✅ 软件说明书：自动生成2000-3000字详细说明书，包含项目概述、功能模块、技术架构等
- ✅ 源代码文档：自动生成60页源代码文档，每页50行，完全符合软著申请要求
- ✅ 智能页数控制：≤60页完整显示，>60页显示前30页+后30页，中间省略
- ✅ 注释自动清理：自动移除单行注释、多行注释、空白行、版权声明等
- ✅ 中文完美支持：原生HTML格式，中文显示无乱码，打印支持
技术规格
- 源码展示格式：每页50行，自动分页，行号显示
- 注释处理规则：
- 多行注释：
/\*(.|\r\n|\n)*?\*/ - 单行注释：
//.* - 空白行：
^\s*(?=\r?$)\n - 版权声明：自动移除copyright、author、license等
- 多行注释：
- 支持语言：JavaScript、Python、Java、C、C++、Go、Rust、Swift、Kotlin等20+语言
💡 使用方法详解
简单三步，生成专业软著材料
📊 扫描分析项目
用户: "帮我生成软著" Claude: 自动扫描项目 → 分析源码 → 识别技术栈 → 生成文档📄 生成申请材料
自动生成: - 软件说明书.html (符合要求的详细描述) - 源代码文档.html (60页，每页50行) - 版本信息自动识别 (从package.json、README等)🖨️ 导出PDF文档
浏览器打开HTML文件 → Cmd+P → 勾选"页眉和页脚" → 保存为PDF
高级功能
- 项目路径指定：支持任意目录的软著材料生成
- 输出目录自定义：可指定生成文件的保存位置
- README智能解析：没有package.json时，从README读取项目名称和版本
- 批量处理：支持多个项目同时生成软著材料
🎨 使用场景示例
Web开发项目
"帮我生成React电商系统的软著材料"
# 自动识别：
# - 项目类型：React + JavaScript前端
# - 技术栈：React、Redux、Webpack
# - 版本号：从package.json读取
# - 生成完整的软著申请文档后端项目
"生成Python Django项目的软著材料"
# 自动识别：
# - 项目类型：Python Django后端
# - 源码文件：.py、.html、.css等
# - 页数控制：按软著要求生成
# - 注释清理：移除Python注释和文档字符串🧹 TidyMyDesktop Skill - 智能桌面整理工具
✨ 让您的桌面和目录焕然一新！智能分类、版本去重、安全整理
🌟 核心功能特色
| 🎯 智能文件分类 | 🔄 版本自动去重 | 🔍 未知软件识别 | 🛡️ 安全整理保障 | |--------------|---------------|----------------|----------------| | 应用程序、文档、图片、视频等自动分类 | 识别软件版本号，保留最新版本，清理旧版本 | 通过网络搜索识别不熟悉软件的用途 | dry-run模式预览，用户确认后执行 | | 创建分类文件夹，整洁有序 | 智能比较版本新旧，避免误删 | 标记需要人工审核的项目 | 所有删除操作需要明确确认 |
💡 实用整理场景
| 🏠 桌面整理 | 📁 目录整理 | 🧹 版本清理 | 📊 整理报告 | |------------|------------|------------|------------| | 一键整理桌面，告别混乱文件 | 整理指定目录，提高工作效率 | 自动识别软件版本，清理冗余文件 | 生成详细报告，记录整理过程 |
🛠️ 使用方法
简单三步，智能整理
🏠 整理桌面
用户: "帮我整理桌面" Claude: 自动扫描 → 生成计划 → 用户确认 → 执行整理 → 生成报告📁 整理目录
用户: "帮我整理当前目录" Claude: 确认路径 → 扫描分析 → 生成计划 → 用户确认 → 整理执行🔍 智能识别
自动识别文件类型、软件版本、未知用途 提供整理建议，确保安全可靠
📂 智能分类规则
- 应用程序: 开发工具、办公软件、设计工具、通讯工具、娱乐软件、系统工具
- 文档: PDF文档、Word文档、Excel表格、文本文件
- 媒体文件: 图片（照片、截图、设计稿）、视频、音频
- 其他: 压缩包、代码项目、未分类文件
📸 实际效果展示
TidyMyDesktop Skill 实际整理效果截图 - 展示了智能分类和整理的结果
📝 v1.0.2 彩色手写笔记版本说明
AI Agent Team v1.0.2 彩色手写笔记风格版本说明 - 详细介绍新增的TidyMyDesktop功能和特性
⚡ 技术特性
- 跨平台支持: macOS、Windows、Linux
- Node.js驱动: 高性能文件操作
- 智能算法: 版本号识别（semver）
- 安全机制: dry-run模式，完整备份提醒
- 详细报告: Markdown格式，包含整理统计
🎨 DrawNote Skill - 智能笔记可视化工具
✨ 让您的笔记变得生动有趣！将文字内容转换为精美图片
🌟 核心功能特色
| 🎨 多彩风格模板 | 📋 内置模板系统 | 🤖 智能内容生成 | 🔗 无缝集成 | |--------------|--------------|--------------|----------| | 彩色手写笔记、专业商务、科技创新、自然清新等多种风格 | 内置提示词模板和样式模板，无需外部文件 | 基于AI大模型，自动分析内容并生成最适合的笔记结构 | 与Claude Code完美集成，一键生成，自动保存 |
📝 使用方法详解
简单四步，创建精美笔记
📝 提供内容
skill: "drawnote" 内容: "人工智能发展历程" 或具体笔记内容🎨 选择风格
"请使用彩色手写笔记风格" 或 "请生成学习笔记风格的信息图"🤖 AI自动生成
自动保存: drawnote_YYYYMMDD_HHMMSS.html📸 截图输出
自动保存: drawnote_YYYYMMDD_HHMMSS.png
💡 实用应用场景
| 📚 学习笔记总结 | 💼 商务报告可视化 | 🔧 技术文档整理 | 📊 知识梳理总结 | |--------------|----------------|--------------|---------------| | 荧光笔高亮、彩色标注等学习元素 | 数据分析、项目报告、战略规划 | 技术架构、API文档、开发指南 | 时间线、流程图、对比表等形式 |
🎯 五种精美风格
彩色手写笔记风格 ⭐ 推荐
- 适用场景：学习笔记、读书总结、知识整理
- 特点：温馨自然、易于记忆
专业商务风格（默认）
- 适用场景：商业报告、数据分析、项目演示
- 特点：简洁专业、数据驱动
科技创新风格
- 适用场景：技术文档、产品介绍、创新展示
- 特点：现代科技、未来感强
自然清新风格
- 适用场景：环保主题、健康生活、自然科学
- 特点：清新淡雅、亲和力强
现代简约风格
- 适用场景：极简设计、艺术展示、高端品牌
- 特点：简约大气、设计感强
📸 实际效果展示
上图为 AI Agent Team v1.0.1 的 DrawNote Skill 实际生成效果，展示了核心功能和应用场景的 2x2 网格布局
🚀 快速开始
✨ 核心特性
- 🎯 六大专业智能体 - 产品经理、前端开发、后端开发、测试工程师、DevOps工程师、技术负责人
- 📝 Changelog Generator Skill ⭐ NEW - 智能变更日志生成，自动版本管理，GitHub Release 集成
- 📜 SoftCopyright Skill - 智能软著材料生成，一键生成软件著作权申请文档
- 🧹 TidyMyDesktop Skill - 智能桌面整理，文件分类，版本去重，安全整理
- 🎨 DrawNote Skill - 智能笔记可视化，多彩风格模板，一键生成精美图片
- ⚡ 原生集成 - 完全基于Claude Code的原生智能体系统
- 🚀 一键安装 - 支持npm全局安装，自动配置智能体环境
- ⚡ 快捷命令 - 简化的命令行调用方式，提升开发效率
- 🔄 完整工作流 - 支持完整的产品开发流程和团队协作
- 📚 详细文档 - 包含使用指南、最佳实践和示例
- 🛠️ 易于扩展 - 模块化设计，支持自定义智能体
系统要求
- Claude Code (已安装并配置)
- Git
一键安装
方式1：npm安装（推荐）
npm install -g ai-agent-team方式2：Shell脚本安装 (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.sh | bash方式3：PowerShell安装 (Windows)
powershell -Command "irm 'https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.ps1' | iex"方式4：批处理安装 (Windows)
curl -fsSL https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.bat -o install.bat && install.bat方式5：手动安装
- 克隆仓库
git clone https://github.com/peterfei/ai-agent-team.git
cd ai-agent-team- 安装智能体配置
# 复制智能体配置到您的Claude配置目录
cp -r .claude/* ~/.claude/- 验证安装
# 测试智能体是否正常工作
claude -p "/agent product_manager '测试功能'"快速使用
🧹 TidyMyDesktop Skill 使用示例
# 整理桌面 - 最常用的功能
帮我整理桌面
# 整理当前目录
帮我整理当前目录
# 整理指定目录（会要求确认路径）
帮我整理下载文件夹
# 智能整理建议
帮我分析一下这个目录的文件结构，给出整理建议
# 安全预览整理计划
帮我看一下整理桌面会执行哪些操作，不要真的执行
# 针对特定类型文件整理
帮我整理桌面上的应用程序文件🎨 DrawNote Skill 使用示例
# 基础使用
请帮我创建一个关于"人工智能发展历程"的信息图
# 指定风格
请使用彩色手写笔记风格生成"机器学习算法分类"的信息图
# 复杂内容
请创建一个关于"微服务架构设计模式"的流程图，使用科技创新风格
# 学习笔记
请用专业商务风格创建"React Hooks"的技术文档
# 知识总结
请创建一个关于"Python数据结构"的学习总结，使用自然清新风格🤖 AI 智能体使用示例
# 产品经理 - 需求分析
/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-plugin/目录 - 更新
marketplaces.json配置 - 安装插件依赖
- 重启 Claude Code
📋 智能体角色
🎯 产品经理 (/pm)
- 职责: 产品规划、需求分析、用户研究、竞品分析
- 专长: 敏捷开发、路线图制定、利益相关者管理
- 使用场景: 功能需求分析、产品规划、用户体验设计
🎨 前端开发 (/fe)
- 职责: UI实现、组件开发、用户体验优化
- 专长: React/Vue/Angular、响应式设计、性能优化
- 使用场景: 页面开发、组件设计、前端架构
⚙️ 后端开发 (/be)
- 职责: API设计、数据库优化、服务器端逻辑
- 专长: Node.js/Python/Java、数据库设计、API架构
- 使用场景: API开发、数据库设计、系统集成
🧪 测试工程师 (/qa)
- 职责: 功能测试、自动化测试、质量保证
- 专长: 单元测试、集成测试、端到端测试
- 使用场景: 测试设计、自动化测试、缺陷管理
🔧 DevOps工程师 (/ops)
- 职责: 部署运维、基础设施、CI/CD流水线
- 专长: Docker、Kubernetes、云服务、监控告警
- 使用场景: 系统部署、运维监控、性能优化
👨💼 技术负责人 (/tl)
- 职责: 技术决策、团队协调、架构设计
- 专长: 系统架构、技术选型、团队管理
- 使用场景: 架构评审、技术选型、团队规划
💼 工作流程示例
完整产品开发流程
# 1. 需求分析阶段
/pm "分析用户认证系统需求，包括功能规格、用户故事和验收标准"
# 2. 技术设计阶段
/tl "设计用户认证系统的技术架构，包括前后端分离、JWT认证、数据库设计"
# 3. 后端开发阶段
/be "实现JWT认证API，包括登录、注册、token刷新功能"
# 4. 前端开发阶段
/fe "创建React登录组件，包含表单验证、错误处理和响应式设计"
# 5. 测试验证阶段
/qa "设计用户认证系统的完整测试用例，包括功能测试和安全测试"
# 6. 部署上线阶段
/ops "配置用户认证系统的生产环境部署，包括Docker容器化和CI/CD流水线"并行开发模式
# 需求定义
/pm "分析实时协作功能需求"
# 并行开发
/be "构建WebSocket实时协作API" &
/fe "创建协作编辑界面" &
# 等待前后端开发完成
wait
# 集成测试
/qa "测试实时协作端到端流程"
# 部署
/ops "部署协作功能到生产环境"🛠️ CLI工具
项目包含跨平台CLI工具，提供更友好的命令行界面：
macOS/Linux
# 使用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
# 使用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. 提供上下文信息
# 包含项目背景
/be "基于我们现有的Express.js用户系统，添加OAuth2集成功能"3. 迭代式开发
# 分阶段实施
/pm "第一阶段：设计用户认证的MVP功能"
/be "第一阶段：实现基础的注册和登录API"
/fe "第一阶段：创建简单的登录表单"4. 团队协作
# 确保智能体间的工作协调
/fe "基于产品需求文档和后端API设计，创建用户界面"
/qa "测试前端界面与后端API的完整集成"🔧 高级配置
自定义智能体
- 创建智能体配置文件：
cp .claude/agents/product_manager.md .claude/agents/custom_agent.md- 编辑配置文件，修改角色和能力
- 创建对应的快捷命令：
cp .claude/commands/pm.md .claude/commands/custom.md环境变量配置
# 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 系统，提供多种安装方式：
安装方式
- PowerShell安装（推荐）
powershell -Command "irm 'https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.ps1' | iex"- 批处理安装
curl -fsSL https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.bat -o install.bat && install.bat- npm安装
npm install -g ai-agent-teamWindows 特性
- ✅ PowerShell 5.0+ 支持
- ✅ Windows 10/11 兼容
- ✅ 批处理脚本兼容
- ✅ 中文路径支持
- ✅ 防火墙和杀毒软件兼容
系统要求
- Windows 10/11 或 Windows Server 2016+
- PowerShell 5.0 或更高版本
- Claude Code (已安装)
- 网络连接
兼容性测试
运行兼容性测试脚本检查您的系统：
powershell -Command "irm 'https://raw.githubusercontent.com/peterfei/ai-agent-team/main/test-windows-compatibility.ps1' | iex"常见问题
Q: PowerShell 执行策略限制怎么办？
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserQ: 杀毒软件报误怎么办？ 将以下目录添加到白名单：
%USERPROFILE%\.claude\- 安装目录
Q: Node.js 安装失败怎么办？
- 手动下载安装 Node.js: https://nodejs.org/
- 或使用 winget:
winget install OpenJS.NodeJS
❓ 常见问题
A: 为了解决国内网络环境下载模型慢或失败的问题，从 v2.0.1 版本开始，我们已将 Thread Manager 所需的向量嵌入模型 (Xenova/all-MiniLM-L6-v2) 直接内置到安装包中。
这确保了用户在安装 ai-agent-team 后，Thread Manager 的语义搜索功能可以完全离线运行，无需额外联网下载模型。
因此，安装包体积从大约 200KB 增加到 16-25MB 左右（取决于平台和打包工具），但这带来了更稳定、更快速的开箱即用体验。
A: 有针对性优化，不会造成浪费。
Thread Manager v2.0.1 采用分层记忆架构，极大优化了 Token 效率：
- 精准检索: 语义搜索允许 AI 精准提取只需的几条相关记忆，而不是加载整个对话历史，节省大量 Token。
- 任务隔离: 切换线程时会重置上下文窗口，移除不相关的历史对话，只保留当前任务的关键信息。
- 精简注入: 动态维护的
current-context.md只包含最近的少量关键消息摘要和元数据。 - 按需加载: 完整的历史记录存储在本地数据库中，只有在您主动搜索或请求时（Lazy Loading）才会检索。
- 检查Claude Code是否正确安装：
claude --version - 验证配置文件是否存在：
ls ~/.claude/agents/ - 测试基础功能：
claude -p "测试连接" - 重新安装配置：
./scripts/install.sh
- 提供详细的任务描述和上下文
- 分步骤分解复杂任务
- 明确指定技术栈和约束条件
- 提供示例和参考资料
智能体支持主流的编程语言和框架：
- 前端：React, Vue, Angular, Svelte等
- 后端：Node.js, Python, Java, Go, PHP等
- 数据库：MySQL, PostgreSQL, MongoDB, Redis等
- 云服务：AWS, Azure, GCP, 阿里云等
🤝 贡献指南
我们欢迎所有形式的贡献！
贡献方式
- 报告问题 - 在Issues中提交bug报告或功能建议
- 提交代码 - Fork项目并提交Pull Request
- 完善文档 - 改进文档质量和完整性
- 分享经验 - 分享使用案例和最佳实践
开发流程
- Fork项目 (在 https://github.com/peterfei/ai-agent-team)
- 创建功能分支：
git checkout -b feature/new-feature - 提交更改：
git commit -m 'Add new feature' - 推送分支：
git push origin feature/new-feature - 创建Pull Request
📄 许可证
本项目采用 MIT License 开源许可证。
🙏 致谢
- 感谢 Anthropic 提供强大的Claude Code平台
- 感谢所有贡献者和用户的支持和反馈
- 感谢开源社区的技术和灵感
📝 更新日志
查看详细的版本更新历史：
- CHANGELOG.md - 完整的版本更新记录
- v1.0.2 发布日志 - 最新版本的详细发布说明
- v1.0.1 发布日志 - 上一版本的发布说明
📞 联系我们
- 📧 Email: [email protected]
- 🐛 Issues: GitHub Issues
- 💬 Discussions: GitHub Discussions
⭐ 如果这个项目对您有帮助，请给我们一个Star！⭐
Made with ❤️ by AI Agent Team