AI Agent Team

🌟 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

如果看到线程列表输出，说明安装成功！🎉

🎯 两种初始化方式对比

💡 提示：大多数情况推荐使用全局初始化，除非你需要在不同项目间完全隔离线程数据。

❓ 常见问题

# 1. 执行 MCP 服务器配置
claude mcp add thread-manager node "/YOURSELFPROJECTPATH/.claude/skills/thread-manager/dist/index.js"

# 2. 重启 Claude Code
exit
claude

# 3. 验证
/threads

# 方法 1: 查看线程列表
/threads

# 方法 2: 查看当前线程
/thread info

# 方法 3: 创建测试线程
/pm-start "测试线程"

🧠 Thread Manager - AI 团队的记忆系统 ⭐ NEW in v2.0.0

🎉 v2.0.1 更新：语义搜索 & 离线模型

现在，Thread Manager 不仅能记住对话，还能理解对话！

• 语义搜索: 使用自然语言查找历史信息（"找一下关于登录逻辑的讨论"）。
• 离线优先: 内置向量模型，无需联网下载，国内环境安装成功率 100%。

查看 v2.0.1 详细发布说明 & 架构图

🚀 核心亮点

📊 Thread Manager vs 原生 Claude

🎮 基础使用

创建任务线程（自动初始化角色）

/pm-start "设计电商购物车功能"
  ↓ 自动创建产品线程
  ↓ AI 立即以产品经理身份分析需求
  ↓ 对话历史永久保存

多任务并行开发

/be-start "实现购物车 API"      # 线程 1: 后端开发
/fe-start "设计购物车UI"         # 线程 2: 前端开发
/qa-start "测试购物车功能"       # 线程 3: QA 测试

/threads                        # 查看所有线程进度

切换线程（完整上下文恢复）

/thread switch abc123
  ↓ AI 立即加载线程 abc123 的所有历史对话
  ↓ 文件变更、代码统计一并恢复
  ↓ 就像从未离开过这个任务

💡 核心命令

🔥 实际应用场景

多任务并行开发:

# 同时进行 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 - 智能软著材料生成工具

✨ 一键生成软件著作权申请材料，让软著申请变得简单高效！

🌟 核心功能特色

🎯 软著申请完全支持

核心功能

• ✅ 软件说明书：自动生成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+语言

💡 使用方法详解

简单三步，生成专业软著材料

1. 📊 扫描分析项目

   用户: "帮我生成软著"
   Claude: 自动扫描项目 → 分析源码 → 识别技术栈 → 生成文档
   

2. 📄 生成申请材料

   自动生成:
   - 软件说明书.html (符合要求的详细描述)
   - 源代码文档.html (60页，每页50行)
   - 版本信息自动识别 (从package.json、README等)
   

3. 🖨️ 导出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 - 智能桌面整理工具

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

🌟 核心功能特色

💡 实用整理场景

🛠️ 使用方法

简单三步，智能整理

1. 🏠 整理桌面

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

2. 📁 整理目录

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

3. 🔍 智能识别

   自动识别文件类型、软件版本、未知用途
   提供整理建议，确保安全可靠
   

📂 智能分类规则

• 应用程序: 开发工具、办公软件、设计工具、通讯工具、娱乐软件、系统工具
• 文档: 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 - 智能笔记可视化工具

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

🌟 核心功能特色

📝 使用方法详解

简单四步，创建精美笔记

1. 📝 提供内容

   skill: "drawnote"
   内容: "人工智能发展历程" 或具体笔记内容
   

2. 🎨 选择风格

   "请使用彩色手写笔记风格" 或 "请生成学习笔记风格的信息图"
   

3. 🤖 AI自动生成

   自动保存: drawnote_YYYYMMDD_HHMMSS.html
   

4. 📸 截图输出

   自动保存: drawnote_YYYYMMDD_HHMMSS.png
   

💡 实用应用场景

🎯 五种精美风格

1. 彩色手写笔记风格 ⭐ 推荐

   • 适用场景：学习笔记、读书总结、知识整理
   • 特点：温馨自然、易于记忆

2. 专业商务风格（默认）

   • 适用场景：商业报告、数据分析、项目演示
   • 特点：简洁专业、数据驱动

3. 科技创新风格

   • 适用场景：技术文档、产品介绍、创新展示
   • 特点：现代科技、未来感强

4. 自然清新风格

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

5. 现代简约风格

   • 适用场景：极简设计、艺术展示、高端品牌
   • 特点：简约大气、设计感强

📸 实际效果展示

上图为 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：手动安装

1. 克隆仓库

git clone https://github.com/peterfei/ai-agent-team.git
cd ai-agent-team

2. 安装智能体配置

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

3. 验证安装

# 测试智能体是否正常工作
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

添加新插件

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)

• 职责: 技术决策、团队协调、架构设计
• 专长: 系统架构、技术选型、团队管理
• 使用场景: 架构评审、技术选型、团队规划

💼 工作流程示例

完整产品开发流程

# 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的完整集成"

🔧 高级配置

自定义智能体

1. 创建智能体配置文件：

cp .claude/agents/product_manager.md .claude/agents/custom_agent.md

2. 编辑配置文件，修改角色和能力
3. 创建对应的快捷命令：

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 系统，提供多种安装方式：

安装方式

1. PowerShell安装（推荐）

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

2. 批处理安装

curl -fsSL https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.bat -o install.bat && install.bat

3. npm安装

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 -Command "irm 'https://raw.githubusercontent.com/peterfei/ai-agent-team/main/test-windows-compatibility.ps1' | iex"

常见问题

Q: PowerShell 执行策略限制怎么办？

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Q: 杀毒软件报误怎么办？ 将以下目录添加到白名单：

• %USERPROFILE%\.claude\
• 安装目录

Q: Node.js 安装失败怎么办？

• 手动下载安装 Node.js: https://nodejs.org/
• 或使用 winget: winget install OpenJS.NodeJS

❓ 常见问题

🤝 贡献指南

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

贡献方式

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 开源许可证。

🙏 致谢

• 感谢 Anthropic 提供强大的Claude Code平台
• 感谢所有贡献者和用户的支持和反馈
• 感谢开源社区的技术和灵感

📝 更新日志

查看详细的版本更新历史：

• CHANGELOG.md - 完整的版本更新记录
• v1.0.2 发布日志 - 最新版本的详细发布说明
• v1.0.1 发布日志 - 上一版本的发布说明

📞 联系我们

• 📧 Email: peterfeispace@gmail.com
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions