wshobson/agents
GitHub: wshobson/agents
一个生产就绪的 Claude Code 插件生态系统,通过 112 个专业代理、146 个技能和 16 个工作流编排器实现智能化的软件开发与多代理协作。
Stars: 29891 | Forks: 3276
# Claude Code 插件:编排与自动化
[](https://smithery.ai/skills?ns=wshobson&utm_source=github&utm_medium=badge)
一个全面的生产就绪系统,结合了 **112 个专业 AI 代理**、**16 个多代理工作流编排器**、**146 个代理技能** 和 **79 个开发工具**,组织成 **72 个专注于单一用途的插件**,专为 [Claude Code](https://docs.claude.com/en/docs/claude-code/overview) 设计。
## 概述
这个统一的存储库提供了现代软件开发中智能自动化和多代理编排所需的一切:
- **72 个专注插件** — 针对最小 token 使用量和可组合性优化的细粒度、单一用途插件
- **112 个专业代理** — 在架构、语言、基础设施、质量、数据/AI、文档、业务运营和 SEO 方面拥有深厚知识的领域专家
- **146 个代理技能** — 具有渐进式披露功能的模块化知识包,用于专业技能
- **16 个工作流编排器** — 用于复杂操作(如全栈开发、安全加固、ML 流水线和事件响应)的多代理协调系统
- **79 个开发工具** — 优化的实用程序,包括项目脚手架、安全扫描、测试自动化和基础设施设置
### 核心特性
- **细粒度插件架构**:72 个专注于减少 token 使用的插件
- **全面的工具集**:79 个开发工具,包括测试生成、脚手架和安全扫描
- **100% 代理覆盖**:所有插件都包含专业代理
- **代理技能**:146 个专业技能,遵循渐进式披露和 token 效率原则
- **清晰的组织**:23 个类别,每个类别包含 1-6 个插件,易于发现
- **高效设计**:平均每个插件 3.4 个组件(遵循 Anthropic 的 2-8 模式)
### 工作原理
每个插件都完全隔离,拥有自己的代理、命令和技能:
- **只安装你需要的** — 每个插件仅加载其特定的代理、命令和技能
- **最小化 token 使用** — 不必要的资源不会加载到上下文中
- **混合搭配** — 组合多个插件以实现复杂的工作流
- **清晰的边界** — 每个插件都有一个单一、专注的目的
- **渐进式披露** — 技能仅在激活时加载知识
**示例**:安装 `python-development` 会加载 3 个 Python 代理、1 个脚手架工具,并提供 16 个技能(约 1000 个 token),而不是整个市场。
## 快速开始
### 步骤 1:添加市场
将此市场添加到 Claude Code:
```
/plugin marketplace add wshobson/agents
```
这将使所有 72 个插件可供安装,但**不会将任何代理或工具**加载到您的上下文中。
### 步骤 2:安装插件
浏览可用的插件:
```
/plugin
```
安装所需的插件:
```
# Essential 开发插件
/plugin install python-development # Python with 16 specialized skills
/plugin install javascript-typescript # JS/TS with 4 specialized skills
/plugin install backend-development # Backend APIs with 3 architecture skills
# 基础设施与运维
/plugin install kubernetes-operations # K8s with 4 deployment skills
/plugin install cloud-infrastructure # AWS/Azure/GCP with 4 cloud skills
# 安全与质量
/plugin install security-scanning # SAST with security skill
/plugin install comprehensive-review # Multi-perspective code analysis
# Full-stack 编排
/plugin install full-stack-orchestration # Multi-agent workflows
```
每个已安装的插件**仅将其特定的代理、命令和技能**加载到 Claude 的上下文中。
### 插件 vs 代理
您安装的是**插件**,其中捆绑了代理:
| Plugin | Agents |
| ----------------------- | ------------------------------------------------- |
| `comprehensive-review` | architect-review, code-reviewer, security-auditor |
| `javascript-typescript` | javascript-pro, typescript-pro |
| `python-development` | python-pro, django-pro, fastapi-pro |
| `blockchain-web3` | blockchain-developer |
```
# ❌ 错误 - 无法直接安装 agents
/plugin install typescript-pro
# ✅ 正确 - 安装该 plugin
/plugin install javascript-typescript@claude-code-workflows
```
### 故障排除
**"Plugin not found"** → 使用插件名称,而不是代理名称。添加 `@claude-code-workflows` 后缀。
**插件未加载** → 清除缓存并重新安装:
```
rm -rf ~/.claude/plugins/cache/claude-code-workflows && rm ~/.claude/plugins/installed_plugins.json
```
## 文档
### 核心指南
- **[插件参考](docs/plugins.md)** — 所有 72 个插件的完整目录
- **[代理参考](docs/agents.md)** — 按类别组织的所有 112 个代理
- **[代理技能](docs/agent-skills.md)** — 具有渐进式披露功能的 146 个专业技能
- **[使用指南](docs/usage.md)** — 命令、工作流和最佳实践
- **[架构](docs/architecture.md)** — 设计原则和模式
### 快速链接
- [安装说明](#quick-start) — 2 步快速上手
- [必备插件](docs/plugins.md#quick-start---essential-plugins) — 立即提升生产力的顶级插件
- [命令参考](docs/usage.md#command-reference-by-category) — 按类别组织的所有斜杠命令
- [多代理工作流](docs/usage.md#multi-agent-workflow-examples) — 预配置的编排示例
- [模型配置](docs/agents.md#model-configuration) — Haiku/Sonnet 混合编排
## 最新动态
### Agent Teams 插件 (新)
使用 Claude Code 的实验性 Agent Teams 功能编排多代理团队以进行并行工作流:
```
/plugin install agent-teams@claude-code-workflows
```
- **7 个团队预设** — `review`、`debug`、`feature`、`fullstack`、`research`、`security`、`migration`
- **并行代码审查** — `/team-review src/ --reviewers security,performance,architecture`
- **假设驱动的调试** — `/team-debug "API returns 500" --hypotheses 3`
- **并行功能开发** — `/team-feature "Add OAuth2 auth" --plan-first`
- **研究团队** — 跨代码库和网络资源的并行调查
- **安全审计** — 4 个审查员涵盖 OWASP、身份验证、依赖项和机密信息
- **迁移支持** — 具有并行流和正确性验证的协调迁移
包括 4 个专业代理、7 个命令和 6 个技能以及参考文档。
[→ 查看 agent-teams 文档](plugins/agent-teams/README.md)
### Conductor 插件 — 上下文驱动开发
通过结构化的 **Context → Spec & Plan → Implement** 工作流,将 Claude Code 转变为项目管理工具:
```
/plugin install conductor@claude-code-workflows
```
- **交互式设置** — `/conductor:setup` 创建产品愿景、技术栈、工作流规则和风格指南
- **基于轨道的开发** — `/conductor:new-track` 生成规格说明和分阶段实施计划
- **TDD 工作流** — `/conductor:implement` 通过验证检查点执行任务
- **语义回滚** — `/conductor:revert` 按逻辑单元(轨道、阶段或任务)撤销工作
- **状态持久化** — 通过持久的项目上下文跨会话恢复设置
- **3 个技能** — 上下文驱动开发、轨道管理、工作流模式
[→ 查看 Conductor 文档](plugins/conductor/README.md)
### 代理技能 (跨 21 个插件的 146 个技能)
遵循 Anthropic 渐进式披露架构的专业知识包:
**语言开发:**
- **Python**(5 个技能):async 模式、测试、打包、性能、UV 包管理器
- **JavaScript/TypeScript**(4 个技能):高级类型、Node.js 模式、测试、现代 ES6+
**基础设施与 DevOps:**
- **Kubernetes**(4 个技能):manifests、Helm charts、GitOps、安全策略
- **云基础设施**(4 个技能):Terraform、多云、混合网络、成本优化
- **CI/CD**(4 个技能):流水线设计、GitHub Actions、GitLab CI、secrets 管理
**开发与架构:**
- **后端**(3 个技能):API 设计、架构模式、微服务
- **LLM 应用**(8 个技能):LangGraph、prompt engineering、RAG、评估、embeddings、相似度搜索、向量调优、混合搜索
**区块链与 Web3**(4 个技能):DeFi 协议、NFT 标准、Solidity 安全、Web3 测试
**项目管理:**
- **Conductor**(3 个技能):上下文驱动开发、轨道管理、工作流模式
**以及更多**:框架迁移、可观测性、支付处理、ML 运维、安全扫描
[→ 查看完整技能文档](docs/agent-skills.md)
### 三层模型策略
针对最佳性能和成本的策略性模型分配:
| 层级 | 模型 | 代理数 | 用例 |
| ---------- | ------- | ------ | ----------------------------------------------------------------------------------------------- |
| **Tier 1** | Opus 4.6 | 42 | 关键架构、安全、所有代码审查、生产编码(语言专家、框架) |
| **Tier 2** | Inherit | 42 | 复杂任务 - 用户选择模型 (AI/ML、后端、前端/移动端、专业化) |
| **Tier 3** | Sonnet | 51 | 智能支持 (文档、测试、调试、网络、API 文档、DX、遗留系统、支付) |
| **Tier 4** | Haiku | 18 | 快速操作任务 (SEO、部署、简单文档、销售、内容、搜索) |
**为什么关键代理使用 Opus 4.6?**
- SWE-bench 得分 80.8%(行业领先)
- 复杂任务减少 65% 的 token
- 最适合架构决策和安全审计
**Tier 2 灵活性 (`inherit`):**
标记为 `inherit` 的代理使用您会话的默认模型,让您平衡成本和能力:
- 启动会话时通过 `claude --model opus` 或 `claude --model sonnet` 设置
- 如果未指定默认值,则回退到 Sonnet 4.6
- 适合希望控制成本的前端/移动端开发人员
- AI/ML 工程师可以为复杂的模型工作选择 Opus
**成本考量:**
- **Opus 4.6**:每百万输入/输出 token $5/$25 — 关键工作的高级选择
- **Sonnet 4.6**:每百万 token $3/$15 — 性能/成本平衡
- **Haiku 4.5**:每百万 token $1/$5 — 快速、经济高效的操作
- Opus 在复杂任务上减少 65% 的 token 通常可以抵消较高的费率
- 对于大量使用的场景,使用 `inherit` 层来控制成本
编排模式结合模型以提高效率:
```
Opus (architecture) → Sonnet (development) → Haiku (deployment)
```
[→ 查看模型配置详情](docs/agents.md#model-configuration)
## 热门用例
### 全栈功能开发
```
/full-stack-orchestration:full-stack-feature "user authentication with OAuth2"
```
协调 7 个以上的代理:backend-architect → database-architect → frontend-developer → test-automator → security-auditor → deployment-engineer → observability-engineer
[→ 查看所有工作流示例](docs/usage.md#multi-agent-workflow-examples)
### 安全加固
```
/security-scanning:security-hardening --level comprehensive
```
使用 SAST、依赖项扫描和代码审查进行多代理安全评估。
### 使用现代工具进行 Python 开发
```
/python-development:python-scaffold fastapi-microservice
```
创建具有 async 模式的生产就绪 FastAPI 项目,激活技能:
- `async-python-patterns` — AsyncIO 和并发
- `python-testing-patterns` — pytest 和 fixtures
- `uv-package-manager` — 快速依赖管理
### Kubernetes 部署
```
# 自动激活 k8s 技能
"Create production Kubernetes deployment with Helm chart and GitOps"
```
使用具有 4 个专业技能的 kubernetes-architect 代理进行生产级配置。
[→ 查看完整使用指南](docs/usage.md)
## 插件分类
**24 个类别,72 个插件:**
- 🎨 **开发** (4) — 调试、后端、前端、多平台
- 📚 **文档** (3) — 代码文档、API 规范、图表、C4 架构
- 🔄 **工作流** (5) — git、全栈、TDD、**Conductor**(上下文驱动开发)、**Agent Teams**(多代理编排)
- ✅ **测试** (2) — 单元测试、TDD 工作流
- 🔍 **质量** (2) — 综合审查、性能
- 🤖 **AI 与 ML** (4) — LLM 应用、代理编排、上下文、MLOps
- 📊 **数据** (2) — 数据工程、数据验证
- 🗄️ **数据库** (2) — 数据库设计、迁移
- 🚨 **运维** (4) — 事件响应、诊断、分布式调试、可观测性
- ⚡ **性能** (2) — 应用性能、数据库/云优化
- ☁️ **基础设施** (5) — 部署、验证、Kubernetes、云、CI/CD
- 🔒 **安全** (4) — 扫描、合规性、后端/API、前端/移动端
- 💻 **语言** (7) — Python、JS/TS、系统、JVM、脚本、函数式、嵌入式
- 🔗 **区块链** (1) — 智能合约、DeFi、Web3
- 💰 **金融** (1) — 量化交易、风险管理
- 💳 **支付** (1) — Stripe、PayPal、计费
- 🎮 **游戏** (1) — Unity、Minecraft 插
- 📢 **营销** (4) — SEO 内容、技术 SEO、SEO 分析、内容营销
- 💼 **商业** (3) — 分析、HR/法律、客户/销售
- 以及更多...
[→ 查看完整插件目录](docs/plugins.md)
## 架构亮点
### 细粒度设计
- **单一职责** — 每个插件做好一件事
- **最小 token 使用** — 平均每个插件 3.4 个组件
- **可组合** — 混合搭配以实现复杂的工作流
- **100% 覆盖** — 所有 112 个代理均可通过插件访问
### 渐进式披露 (技能)
为了 token 效率的三层架构:
1. **元数据** — 名称和激活标准(始终加载)
2. **指令** — 核心指导(激活时加载)
3. **资源** — 示例和模板(按需加载)
### 存储库结构
```
claude-agents/
├── .claude-plugin/
│ └── marketplace.json # 72 plugins
├── plugins/
│ ├── python-development/
│ │ ├── agents/ # 3 Python experts
│ │ ├── commands/ # Scaffolding tool
│ │ └── skills/ # 5 specialized skills
│ ├── kubernetes-operations/
│ │ ├── agents/ # K8s architect
│ │ ├── commands/ # Deployment tools
│ │ └── skills/ # 4 K8s skills
│ └── ... (65 more plugins)
├── docs/ # Comprehensive documentation
└── README.md # This file
```
[→ 查看架构详情](docs/architecture.md)
## 贡献
要添加新的代理、技能或命令:
1. 在 `plugins/` 中确定或创建适当的插件目录
2. 在相应的子目录中创建 `.md` 文件:
- `agents/` — 用于专业代理
- `commands/` — 用于工具和工作流
- `skills/` — 用于模块化知识包
3. 遵循命名约定(小写、连字符分隔)
4. 编写清晰的激活标准和全面的内容
5. 更新 `.claude-plugin/marketplace.json` 中的插件定义
有关详细指南,请参阅 [架构文档](docs/architecture.md)。
## 资源
### 文档
- [Claude Code 文档](https://docs.claude.com/en/docs/claude-code/overview)
- [插件指南](https://docs.claude.com/en/docs/claude-code/plugins)
- [Subagents 指南](https://docs.claude.com/en/docs/claude-code/sub-agents)
- [代理技能指南](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview)
- [斜杠命令参考](https://docs.claude.com/en/docs/claude-code/slash-commands)
### 此存储库
- [插件参考](docs/plugins.md)
- [代理参考](docs/agents.md)
- [代理技能指南](docs/agent-skills.md)
- [使用指南](docs/usage.md)
- [架构](docs/architecture.md)
## 许可证
MIT 许可证 — 详情请参阅 [LICENSE](LICENSE) 文件。
## Star 历史
[](https://www.star-history.com/#wshobson/agents&type=date&legend=top-left)
标签:AI辅助编程, Anthropic, CIS基准, Claude, Claude Code, CVE检测, DLL 劫持, GitHub Advanced Security, JS文件枚举, Linux 内核安全, MCP, PyRIT, Python, RAG, Scaffolding, Smithery, TypeScript, 人工智能, 代码生成, 代码重构, 低代码, 可视化界面, 响应式代理, 多智能体系统, 大语言模型, 子域名突变, 安全加固, 安全扫描, 安全插件, 工作流自动化, 开发框架, 技能包, 数据管道, 无后门, 日志审计, 时序注入, 智能运维, 机器学习管道, 测试自动化, 渗透测试工具, 漏洞利用检测, 生产力工具, 用户模式Hook绕过, 编排引擎, 自动化开发, 请求拦截, 软件工程, 逆向工具, 项目管理