代理创建器 是做什么的？
元代理，专门用于创建新的自定义代理、技能和 MCP 集成。将需求转化为功能完备、文档齐全的代理系统。
快速开始
用户："创建一个用于数据库优化的代理"
代理创建器：
1. 分析需求（领域、用户、问题、范围）
2. 设计角色（高级 DBA，20 年经验）
3. 映射能力（EXPLAIN 分析、索引、查询重写）
4. 选择模板（技术专家）
5. 编码知识（反模式、技术、示例）
6. 添加 MCP 工具（可选：SQL 解析器）
7. 记录使用方法和限制
结果：约 45 分钟即可获得生产就绪的代理
核心能力
1. 代理设计与架构
- 角色开发，具有鲜明的话语风格
- 技能定义与范围管理
- 交互模式设计
- 知识编码以优化检索
2. MCP 集成
- 协议理解与服务器开发
- 资源管理与 API 设计
- 持久化代理的状态管理
3. 技能框架设计
- 渐进式信息呈现（轻量元数据，按需提供细节）
- 可组合性与模块化
- 清晰的文档
代理模板
| 模板 | 最佳用途 | 关键要素 |
|---|---|---|
| 技术专家 | 领域专家 | 问题解决框架、代码示例、最佳实践 |
| 创意/设计 | 创意角色 | 设计理念、创意流程、质量标准 |
| 编排器 | 协调任务 | 委托策略、集成模式、质量保证 |
快速原型工作流
| 步骤 | 时间 | 活动 |
|---|---|---|
| 1. 理解需求 | 2 分钟 | 缺少什么能力？ |
| 2. 设计角色 | 3 分钟 | 哪位专家能够解决此问题？ |
| 3. 映射知识 | 10 分钟 | 他们需要了解什么？ |
| 4. 创建结构 | 5 分钟 | 按模板组织 |
| 5. 添加示例 | 10 分钟 | 具体、可运行的代码 |
| 6. 编写文档 | 5 分钟 | 如何使用 |
| 7. 测试与改进 | 10 分钟 | 用查询验证 |
总计：约 45 分钟即可获得高质量的代理
MCP 服务器创建
官方包：
@modelcontextprotocol/sdk- 核心 TypeScript SDK@modelcontextprotocol/create-server- 脚手架新服务器@modelcontextprotocol/inspector- 测试和调试
创建步骤：
- 定义能力（输入、输出、目的）
- 设计接口（清晰的工具模式）
- 实现核心逻辑
- 打包为 MCP 服务器
质量检查清单
专业性
- 清晰的领域边界
- 具体、可操作的指导
- 真实世界的示例
- 涵盖常见陷阱
可用性
- 明确的使命陈述
- 易于浏览的结构
- 具体的代码示例
集成
- 可独立运行
- 可与其他代理组合
- 清晰的输入/输出格式
何时使用
适用于：
- 创建新的领域专家代理
- 为自定义能力构建 MCP 服务器
- 设计技能架构
- 快速原型化 AI 能力
不适用于：
- 使用现有代理（请直接调用）
- 通用编码任务（请使用特定语言技能）
- 基础设施设置（请使用部署工程师）
- 修改 Claude 的核心行为
反模式
反模式：知识库转储
表现：将整个文档粘贴到代理中 错误原因：信息过载、检索效果差、上下文臃肿 替代方案：精选关键知识，使用渐进式信息呈现
反模式：模糊角色
表现："你是一位专家助手" 错误原因：缺乏个性，输出千篇一律 替代方案：指定具体角色、工作年限、沟通风格
反模式：范围缺失
表现：试图包揽一切的代理 错误原因：样样通，样样松 替代方案：设定清晰边界，并提供重定向建议
反模式：缺少示例
表现：只有抽象描述，没有代码 错误原因：用户看不到如何应用指导 替代方案：为核心模式提供具体、可运行的示例
参考文件
references/agent-templates.md- 技术、创意、编排器模板references/mcp-integration.md- MCP 服务器创建模式、SDK 使用references/creation-process.md- 端到端工作流、质量检查清单
核心洞察：优秀的代理不是知识库转储——它们是经过深思熟虑设计的专家系统，具有个性、实用指导和真实世界的适用性。
配合使用：skill-coach（质量审查）| skill-documentarian（文档生成）| orchestrator（多代理设计）