Claude Code Agents

一个为 Claude Code 设计的企业级软件研发智能体插件，覆盖完整的软件开发生命周期。

🎯 核心特性

• 80+ 专业智能体：覆盖前后端、算法、测试、产品、设计、营销、销售、客服等领域
• 三层架构：专家级 → VP级 → 自动协调，智能选择最合适的agent组合
• 部门配色体系：7大部门视觉分类，UI友好的颜色标识（查看配色方案）
• Agent Teams 兼容：支持在 Claude Code Agent Teams 中使用，实现多角色并行协作
• Claude Code 插件：通过marketplace安装，按需加载，优化token使用
• 即插即用：一键安装，自动更新

🚀 快速开始

安装

通过 Claude Code marketplace 安装（推荐）

# 1. 添加市场（仅首次需要）
claude plugin marketplace add zhiliyouxian/claude-plugins-marketplace

# 2. 安装插件
claude plugin install software-dev-agents@zhiliyouxian

# 可选：指定安装范围
claude plugin install software-dev-agents@zhiliyouxian -s project  # 团队共享（推荐）
claude plugin install software-dev-agents@zhiliyouxian -s user     # 个人使用（默认）
claude plugin install software-dev-agents@zhiliyouxian -s local    # 项目本地（不提交到git）

开发者模式（用于本地开发和调试）

# 克隆仓库
git clone https://github.com/longkeyy/software-dev-agents.git

# 使用本地目录
claude --plugin-dir ./software-dev-agents

更新

# 更新市场索引
claude plugin marketplace update zhiliyouxian

# 更新插件到最新版本
claude plugin update software-dev-agents@zhiliyouxian

# 或者一次性更新所有插件
claude plugin update --all

卸载

# 卸载插件
claude plugin uninstall software-dev-agents@zhiliyouxian

# 可选：指定卸载范围
claude plugin uninstall software-dev-agents@zhiliyouxian -s project

# 如需完全移除市场
claude plugin marketplace remove zhiliyouxian

使用

基础使用：Claude 会根据您的问题自动选择合适的智能体

# 技术问题 → 自动调用技术专家
claude "优化这段 Go 代码的性能"
claude "React 组件重构建议"

# 跨团队协作 → 调用相关 VP
claude "设计微服务架构"
claude "新产品从设计到上线的完整方案"

高级用法：结合 Agent Teams 实现多角色并行协作（实验性功能）

# 1. 启用 Agent Teams（在 ~/.claude/settings.json 中）
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

# 2. 创建协作团队
claude
> "Create an agent team for implementing user authentication:
   - Use product-manager agent for requirements analysis
   - Use golang-expert agent for backend implementation
   - Use react-expert agent for frontend development
   - Use automation-expert agent for testing"

详细说明见 Agent Teams 使用指南

🏗️ 架构设计

三层智能体架构

层级	职责	示例
专家级	解决具体技术问题	golang-expert, react-expert, ml-researcher
VP级	跨团队协调和战略决策	vp-technology, vp-product, vp-creative
自动组合	复杂项目多VP协作	产品+技术+营销联合规划

部门覆盖

🏢 完整组织架构（80个agents，7个部门）

🔧 技术部门 (62个) - 蓝色 #2563eb
│   ├── 前端 (React/Vue/Angular/Flutter/iOS/Android/RN/鸿蒙)
│   ├── 后端 (Go/Java/Python/Node.js)
│   ├── 算法 (ML/CV/NLP/推荐/搜索/风控)
│   ├── 数据 (DBA/ETL/BI/大数据)
│   ├── 测试 (自动化/性能/安全)
│   ├── 架构 (系统/安全/数据/AI)
│   └── 基础设施 (DevOps/云/网络)

📋 产品部门 (4个) - 紫色 #9333ea
│   PM/BA/PO/产品战略

🎨 创意部门 (7个) - 粉色 #ec4899
│   UX/UI/视觉/交互/内容/叙事

📢 营销部门 (4个) - 橙色 #f97316
│   品牌/数字/增长/社媒

💼 销售部门 (3个) - 绿色 #10b981
│   销售/企业销售/售前

🤝 客户服务 (3个) - 青色 #06b6d4
│   支持/技术支持/成功

👔 VP级协调 (6个) - 金色 #eab308
│   技术/产品/创意/营销/销售/客户VP

详细配色方案和设计理念见 docs/agent-colors.md

📁 项目结构

software-dev-agents/
├── .claude-plugin/
│   └── plugin.json              # 插件配置
├── agents/
│   ├── departments/             # 80个专家级智能体（按部门分类）
│   │   ├── engineering/         # 技术部门（前后端、算法、测试、架构等）
│   │   ├── product/             # 产品部门（PM、BA、PO）
│   │   ├── creative/            # 创意部门（UX、UI、内容）
│   │   ├── marketing/           # 营销部门（品牌、数字、增长）
│   │   ├── sales/               # 销售部门（销售、企业销售、售前）
│   │   └── customer-service/    # 客户服务（支持、成功）
│   └── workflows/               # 6个VP级协调者
├── skills/
│   └── workflow-coordinator/    # 研发流程协调技能
│       └── SKILL.md
├── scripts/
│   ├── optimize-agents.py       # Agent description优化工具
│   └── add-agent-colors.py      # Agent颜色管理工具
├── docs/
│   └── agent-colors.md          # 部门配色方案文档
├── install.sh                   # 安装脚本（已弃用，使用marketplace安装）
└── uninstall.sh                 # 卸载脚本（已弃用，使用plugin命令）

🔧 管理操作

查看插件状态

在 Claude Code 中使用 /plugin 命令查看已安装插件：

# 启动 Claude Code 后使用交互式界面
claude

# 在 Claude 中输入：
/plugin

或使用 CLI 命令：

# 列出所有已安装插件
claude plugin list

# 查看插件详情
claude plugin info software-dev-agents@zhiliyouxian

检查插件文件位置

# 插件缓存目录
ls -la ~/.claude/plugin-cache/

# 用户配置
cat ~/.claude/settings.json | grep software-dev-agents

# 项目配置
cat .claude/settings.json | grep software-dev-agents

更新与维护

# 更新市场和插件
claude plugin marketplace update zhiliyouxian
claude plugin update software-dev-agents@zhiliyouxian

# 禁用插件（不卸载）
claude plugin disable software-dev-agents@zhiliyouxian

# 重新启用
claude plugin enable software-dev-agents@zhiliyouxian

🎯 智能选择机制

场景	自动选择
单一技术问题	对应领域专家
跨团队协作	相关VP协调
复杂项目	多VP组合

🔧 自定义智能体

Agent 文件格式

---
name: agent-identifier
description: |
  Use this agent when... [简洁描述使用场景，< 600字符]
color: "#2563eb"
---

[详细的系统提示词]

字段说明

• name: 唯一标识符（kebab-case，无空格）
• description: 简洁描述使用场景（< 600字符，避免冗长examples）
• color: 部门配色（可选，见 配色方案）

创建新Agent

1. 在 agents/departments/ 相应子目录创建 .md 文件
2. 包含 YAML frontmatter（必需：name、description，可选：color）
3. 编写详细的系统提示词

优化工具：

# 优化description长度
python3 scripts/optimize-agents.py --dry-run

# 添加部门颜色
python3 scripts/add-agent-colors.py --dry-run

或使用 ClaudeAgent-Creator 自动生成。

📚 相关文档

项目文档

• 部门配色方案 - Agent视觉标识体系
• Agent Teams 使用指南 - 多角色并行协作指南
• 工作流程协调技能 - 研发流程协调

Claude Code 官方文档

• Claude Code 文档
• 插件系统参考
• 子智能体文档
• Agent Teams 文档

📜 许可证

MIT License

🙏 致谢

感谢所有贡献者！

---

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