universal

---

🚀 概述

这个仓库包含了一套强大的专业AI代理集合，旨在增强您的Claude Code开发体验。每个代理都具备深度领域专业知识和严格的边界约束，能够高效地处理特定的技术栈和开发任务。

🎯 核心特性

• Claude Code插件系统: 完全集成Claude Code官方插件架构
• 简易安装: 通过 /plugin 命令安装或手动复制到 ~/.claude/
• 增强任务评估: 6级 (0-5) 复杂度评估与超智能分析 (ultrathink模式)
• 28+个专业代理: 全面覆盖现代开发技术栈，配备严格的角色边界
• 项目专属代理: /initx 命令可创建专为您项目需求定制的自定义代理
• 代理边界系统: ALLOWED/FORBIDDEN模式防止职责蔓延，确保精准执行
• 依赖感知执行: 智能依赖检测与基于阶段的执行策略
• 多技术栈支持: Vue.js、React、Go、Rust、Python、Android、Java、安全分析等
• 生产就绪: 经过实战测试的配置，为真实世界开发优化
• 性能优化: 简单任务3倍速度提升，复杂协调2倍可靠性提升

🛠 快速开始

安装

您可以通过两种方式安装此集合：

• 插件安装：更方便，但命令较长（如 /universal:ai）
• 手动安装（推荐）：需要手动复制文件，但命令简洁（如 /ai）

方法1: 插件安装

1. 添加marketplace到Claude Code:

   claude
   

   /plugin marketplace add Toskysun/sub-agents
   

2. 安装插件:

   /plugin install universal@sub-agents
   

3. 重启Claude Code以激活代理

4. 验证安装:

   /universal:ai list
   /universal:initx --preview
   /help
   

   💡 提示: 插件安装后命令需要加命名空间前缀 /universal:。如果您希望使用更简洁的 /ai 和 /initx 命令，建议使用方法2: 手动安装。

5. （可选）安装CLAUDE.md配置:

   ⚠️ 注意: 插件系统无法自动安装 CLAUDE.md，您需要手动复制：

   # 全局配置（推荐）
   curl -o ~/.claude/CLAUDE.md https://raw.githubusercontent.com/Toskysun/sub-agents/master/CLAUDE.md
   
   # 或者项目专属配置
   curl -o ./CLAUDE.md https://raw.githubusercontent.com/Toskysun/sub-agents/master/CLAUDE.md
   

方法2: 手动安装（推荐）

1. 克隆仓库:

   git clone https://github.com/Toskysun/sub-agents.git
   cd sub-agents
   

2. 复制到Claude Code目录:

   # Linux/Mac
   cp -r * ~/.claude/
   
   # Windows
   copy * %USERPROFILE%\.claude\
   

3. 重启Claude Code或重新加载配置

创建项目专属代理（可选）

安装后，您可以为特定项目创建自定义代理：

# 导航到您的项目目录
cd your_project

# 分析并为您的项目创建自定义代理
/initx

使用示例

💡 注意: 以下示例使用简洁命令格式（手动安装）。如使用插件安装，请将 /ai 替换为 /universal:ai，将 /initx 替换为 /universal:initx。

全局代理任务（随时可用）:

/ai "创建一个Vue.js仪表板组件"
/ai "构建一个FastAPI认证服务"
/ai "设计一个Material Design移动界面"
/ai "优化Go微服务性能"

项目专属代理任务（运行 /initx 后）:

/ai "优化结账流程"           # 使用 vue-ecommerce-developer
/ai "实现支付网关"           # 使用 payment-integration-specialist
/ai "添加库存警报"           # 使用 postgres-inventory-architect
/ai "部署到生产环境"         # 使用 aws-deployment-specialist

多代理协调:

/ai "构建一个全栈电商平台"
/ai "创建一个带测试的React组件库"
/ai "开发一个带API集成的安全Android应用"

团队管理:

/ai list          # 显示所有可用代理（全局+项目）
/ai info react    # 获取React专家详情
/initx --preview  # 预览您项目的自定义代理

🤖 可用代理

🧠 分析型代理 (禁止代码执行)

严格约束：只能分析和报告，不能执行代码或实现解决方案。

• technical-solution-architect: 设计技术解决方案并创建实施路线图
• technical-researcher: 调研技术并提供研究报告
• code-review-expert: 分析代码质量并识别问题（无法修复问题）

💻 开发型代理 (域专属执行)

严格约束：只能在特定技术领域内执行代码。

前端专家

• vue-developer: Vue.js 3、组合式API、Nuxt.js、Pinia（仅Vue生态系统）
• react-developer: React 18、Next.js、Redux Toolkit、Server Components（仅React生态系统）
• frontend-developer: 通用前端开发和UI框架

后端专家

• backend-developer: 多栈API开发（FastAPI/Spring Boot/Node.js）- 仅服务端
• go-architect: Go微服务、分布式系统、云原生
• rust-architect: 系统编程、性能优化、内存安全
• flask-expert: Python Flask Web应用和REST API
• fastapi-expert: 异步Python API、自动文档生成
• java-developer: 企业级Java开发和Spring Boot
• spring-architect: Spring生态系统、微服务架构

移动端与设计

• android-developer: 原生Android应用、Kotlin、架构组件
• mobile-ui-designer: 移动端UX/UI、响应式设计、平台指南
• google-ui-designer: Material Design 3、无障碍性、设计系统

基础设施与DevOps

• devops-engineer: Docker容器化和部署（仅基础设施）
• infrastructure-developer: 构建工具、CI/CD管道、自动化脚本

🔐 安全与分析专家

• android-hooking-expert: Frida、动态分析、运行时操控
• xposed-developer: Xposed模块、系统级修改
• reverse-engineer: 静态分析、反编译、漏洞研究
• malware-analyst: 威胁检测、行为分析、事件响应

🌙 自动化与脚本

• lua-developer: 游戏脚本、自动化、OpenResty Web开发

🔧 质量型代理 (分析和指导)

严格约束：提供指导和协调但不能实现解决方案。

• qa-engineer: 测试策略和质量分析（无法编写生产代码）
• test-expert: 测试框架设计和策略（无法实现业务逻辑）
• task-dispatch-director: 纯粹协调（⚠️ 绝不调用自身）

🚀 项目专属代理系统 (/initx)

🎯 为您的项目创建定制AI团队

除了全局代理外，您可以使用 /initx 命令创建项目专属代理，完全针对您的具体需求进行定制。

核心优势:

• 10倍开发速度: 定制代理理解您的特定业务逻辑和技术栈
• 零学习成本: 代理预配置了您的项目模式和约定
• 智能协作: 代理了解您项目独特的集成点和依赖关系
• 领域专业: 深入了解您的特定需求和约束