⚡

代理工厂 agent-factory

一个全面的系统，用于生成生产就绪的 Claude Code 代理和子代理，增强 YAML 前置内容、工具访问模式和 MCP 集成支持，遵循经过验证的生产模式。

低代码开发 0 次安装 0 次浏览 更新于 3/5/2026

name: agent-factory description: Claude Code 代理生成系统，创建定制代理和子代理，增强 YAML 前置内容、工具访问模式和 MCP 集成支持，遵循经过验证的生产模式

代理工厂

一个全面的系统，用于生成生产就绪的 Claude Code 代理和子代理。这项技能提供模板、标准和生成工具，以创建可以与 Claude Code 的代理系统集成的定制代理。

这项技能做什么

这项技能帮助您为任何领域或工作流程创建定制的 Claude Code 代理。它生成 Claude Code 可以自动发现并在相关时调用的适当格式化的代理文件。

功能

  1. 生成定制代理 - 为任何领域（前端、后端、测试、产品等）创建专门的代理
  2. 增强 YAML 前置内容 - 丰富的元数据，包括颜色编码、字段分类、专业水平
  3. 工具访问指导 - 根据代理类型推荐最佳工具配置
  4. MCP 集成 - 建议相关的 MCP 服务器工具以增强能力
  5. 执行模式分配 - 确保安全地进行并行/顺序执行
  6. 验证 - 根据最佳实践检查代理配置

支持的代理类型

战略代理（轻量级，平行安全）

  • 目的：规划、研究、分析
  • 工具：仅限读取、写入、搜索
  • 执行：可以并行运行 4-5 个代理
  • 颜色：蓝色
  • 示例：产品规划师、市场研究员、架构师

实施代理（全工具，协调）

  • 目的：代码编写、功能构建
  • 工具：读取、写入、编辑、Bash、搜索、全局
  • 执行：协调 2-3 个代理
  • 颜色：绿色
  • 示例：前端开发人员、后端开发人员、API 构建者

质量代理（重 Bash，仅顺序）

  • 目的：测试、验证、审查
  • 工具：读取、写入、编辑、Bash、搜索、全局
  • 执行：一次运行一个代理（永不并行）
  • 颜色：红色
  • 示例：测试运行器、代码审查员、安全审计员

协调代理（轻量级，编排）

  • 目的：管理其他代理，验证集成
  • 工具：读取、写入、搜索
  • 执行：编排其他代理
  • 颜色：紫色
  • 示例：全栈协调员、工作流管理器

增强 YAML 前置内容

每个生成的代理都包括丰富的元数据：

---
name: agent-name-kebab-case
description: 何时调用此代理
tools: 读取, 写入, 编辑  # 逗号分隔
model: sonnet  # sonnet|opus|haiku|inherit
color: green  # 视觉分类
field: frontend  # 领域区域
expertise: expert  # beginner|intermediate|expert
mcp_tools: mcp__playwright  # MCP 集成
---

字段分类

开发：frontend, backend, fullstack, mobile, devops 质量：testing, security, performance 战略：product, architecture, research, design 领域：data, ai, content, finance, infrastructure

颜色编码

  • 蓝色：战略/规划代理
  • 绿色：实施/开发代理
  • 红色：质量/测试代理
  • 紫色：协调/编排代理
  • 橙色：领域特定专家

专业水平

  • 初学者：简单、专注的任务
  • 中级：中等复杂度的工作流程
  • 专家：高级、复杂的操作

如何使用

快速开始

  1. 打开提示模板：documentation/templates/AGENTS_FACTORY_PROMPT.md
  2. 滚动到底部 - 查找模板变量
  3. 填写您的详细信息：
    AGENT_NAME: my-custom-agent
DESCRIPTION: 此代理的作用以及何时调用它
DOMAIN_FIELD: frontend
TOOLS_NEEDED: 读取, 写入, 编辑, Bash
  4. 复制整个提示 - 包括填写的变量
  5. 粘贴到 Claude - Claude.ai, Claude Code 或 API
  6. 接收代理文件 - 完整的 .md 文件准备使用
  7. 安装代理 - 复制到 .claude/agents/ 或 ~/.claude/agents/

示例调用

@agent-factory

创建一个定制代理：
名称：api-integration-specialist
类型：实施
领域：后端
描述：第三方服务的 API 集成专家
能力：OAuth, REST 客户端，错误处理
工具：读取，写入，编辑，Bash
MCP：mcp__github

输出：完整的 .claude/agents/api-integration-specialist.md 文件

生成的代理结构

每个生成的代理都是一个单独的 Markdown 文件：

---
name: custom-agent
description: 触发自动调用
tools: 读取, 写入, 编辑
model: sonnet
color: green
field: backend
expertise: expert
mcp_tools: mcp__github
---

您是 [role] 专门从事 [domain]。

当被调用时：
1. [步骤 1]
2. [步骤 2]
3. [步骤 3]

[详细说明]
[清单]
[最佳实践]
[输出格式]

集成工作流程

工作流程 1：功能开发

1. product-planner → 创建需求
2. frontend-developer + backend-developer → 构建（并行）
3. test-runner → 验证（顺序）
4. code-reviewer → 审查（顺序）

工作流程 2：错误修复

1. debugger → 分析问题
2. [appropriate-dev-agent] → 修复
3. test-runner → 验证修复

工作流程 3：代码审查

1. code-reviewer → 质量审查（可以单独运行）
2. security-auditor → 安全扫描（可以单独运行）

MCP 工具集成

常见的 MCP 服务器集成：

  • mcp__github：PR 审查，问题，仓库操作
  • mcp__playwright：E2E 测试，截图，浏览器自动化
  • mcp__context7：文档搜索，知识查询
  • mcp__filesystem：高级文件操作
  • 自定义 MCP 服务器：任何用户配置的 MCP 工具

代理在配置时自动引用其能力中的 MCP 工具。

安全与性能

进程监控

代理消耗系统资源。监控使用：

ps aux | grep -E "mcp|npm|claude" | wc -l

安全范围：

  • 15-20：战略代理（并行）
  • 20-30：实施代理（协调）
  • 12-18：质量代理（顺序）

警告：

  • 30：减少并行化

  • 60：严重 - 重启系统

执行规则

✅ 安全：4-5 战略代理并行 ✅ 安全：2-3 实施代理协调 ❌ 不安全：质量代理并行（系统崩溃）

最佳实践

  1. 保持代理专注 - 每个代理一个清晰的职责
  2. 使用描述性描述 - 启用自动调用
  3. 遵循工具访问模式 - 将工具与代理类型匹配
  4. 指定执行模式 - 防止性能问题
  5. 利用 MCP 工具 - 增强代理能力
  6. 逐步测试代理 - 从简单开始，增加复杂性
  7. 版本控制代理 - 将项目代理检入 git

限制

  • 代理是模板 - 根据您的具体需求定制
  • 工具建议是指导方针，不是要求
  • MCP 工具需要配置服务器
  • 性能取决于系统资源
  • 生成的代理需要在您的环境