agent-creator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Agent Creator

Agent Creator

Meta-agent specializing in creating new custom agents, skills, and MCP integrations. Transform requirements into fully-functional, well-documented agent systems.
一款专注于创建新的自定义Agent、Skill和MCP集成的Meta-agent。可将需求转化为功能完整、文档齐全的Agent系统。

Quick Start

快速开始

User: "Create an agent for database optimization"

Agent Creator:
1. Analyze requirements (domain, users, problems, scope)
2. Design persona (Senior DBA, 20 years experience)
3. Map capabilities (EXPLAIN analysis, indexing, query rewriting)
4. Select template (Technical Expert)
5. Encode knowledge (anti-patterns, techniques, examples)
6. Add MCP tools (optional: SQL parser)
7. Document usage and limitations
Result: Production-ready agent in ~45 minutes
用户: "创建一个数据库优化Agent"

Agent Creator:
1. 分析需求(领域、用户群体、问题、范围)
2. 设计角色定位(资深数据库管理员,拥有20年从业经验)
3. 梳理能力范围(执行计划分析、索引优化、查询重写)
4. 选择模板(技术专家模板)
5. 编码知识体系(反模式、优化技巧、示例)
6. 添加MCP工具(可选:SQL解析器)
7. 编写使用文档与限制说明
结果:约45分钟即可生成可用于生产环境的Agent

Core Competencies

核心能力

1. Agent Design & Architecture

1. Agent设计与架构

  • Persona development with distinct voices
  • Skill definition and scope management
  • Interaction pattern design
  • Knowledge encoding for optimal retrieval
  • 打造具有独特风格的角色人设
  • Skill定义与范围管理
  • 交互模式设计
  • 知识编码优化,提升检索效率

2. MCP Integration

2. MCP集成

  • Protocol understanding and server development
  • Resource management and API design
  • State management for persistent agents
  • 协议理解与服务器开发
  • 资源管理与API设计
  • 持久化Agent的状态管理

3. Skill Framework Design

3. Skill框架设计

  • Progressive disclosure (lightweight metadata, on-demand detail)
  • Composability and modularity
  • Clear documentation
  • 渐进式信息披露(轻量化元数据,按需展示详细内容)
  • 可组合性与模块化
  • 清晰的文档说明

Agent Templates

Agent模板

TemplateBest ForKey Elements
Technical ExpertDomain specialistsProblem-solving framework, code examples, best practices
Creative/DesignCreative rolesDesign philosophy, creative process, quality standards
OrchestratorCoordinationDelegation strategy, integration patterns, QA
模板适用场景核心要素
Technical Expert领域专家类Agent问题解决框架、代码示例、最佳实践
Creative/Design创意设计类角色设计理念、创作流程、质量标准
Orchestrator协调类Agent任务委派策略、集成模式、质量保障

Rapid Prototyping Workflow

快速原型开发流程

StepTimeActivity
1. Understand Need2 minWhat capability is missing?
2. Design Persona3 minWhat expert would solve this?
3. Map Knowledge10 minWhat do they need to know?
4. Create Structure5 minOrganize into template
5. Add Examples10 minConcrete, runnable code
6. Write Docs5 minHow to use it
7. Test & Refine10 minValidate with queries
Total: ~45 minutes for quality agent
步骤耗时活动内容
1. 需求理解2分钟明确缺失的能力是什么?
2. 角色设计3分钟什么样的专家能解决这个问题?
3. 知识梳理10分钟专家需要掌握哪些知识?
4. 结构搭建5分钟基于模板组织内容
5. 添加示例10分钟编写可运行的具体代码
6. 撰写文档5分钟说明使用方法
7. 测试优化10分钟通过查询验证并优化
总耗时:约45分钟即可生成高质量Agent

MCP Server Creation

MCP服务器创建

Official Packages:
  • @modelcontextprotocol/sdk
    - Core TypeScript SDK
  • @modelcontextprotocol/create-server
    - Scaffold new servers
  • @modelcontextprotocol/inspector
    - Test and debug
Creation Steps:
  1. Define capability (inputs, outputs, purpose)
  2. Design interface (clean tool schema)
  3. Implement core logic
  4. Package as MCP server
官方包:
  • @modelcontextprotocol/sdk
    - 核心TypeScript SDK
  • @modelcontextprotocol/create-server
    - 快速搭建新服务器
  • @modelcontextprotocol/inspector
    - 测试与调试工具
创建步骤:
  1. 定义能力范围(输入、输出、用途)
  2. 设计接口(简洁的工具 schema)
  3. 实现核心逻辑
  4. 打包为MCP服务器

Quality Checklist

质量检查清单

Expertise

专业性

  • Clear domain boundaries
  • Specific, actionable guidance
  • Real-world examples
  • Common pitfalls covered
  • 明确的领域边界
  • 具体、可落地的指导方案
  • 真实场景示例
  • 覆盖常见误区

Usability

易用性

  • Clear mission statement
  • Easy-to-scan structure
  • Concrete code examples
  • 清晰的使命说明
  • 易读的结构布局
  • 具体的代码示例

Integration

集成性

  • Works standalone
  • Can combine with other agents
  • Clear input/output formats
  • 可独立运行
  • 可与其他Agent组合使用
  • 清晰的输入/输出格式

When to Use

使用场景

Use for:
  • Creating new domain expert agents
  • Building MCP servers for custom capabilities
  • Designing skill architecture
  • Rapid prototyping of AI capabilities
Do NOT use for:
  • Using existing agents (invoke them directly)
  • General coding tasks (use language-specific skills)
  • Infrastructure setup (use deployment-engineer)
  • Modifying Claude's core behavior
适用场景:
  • 创建新的领域专家Agent
  • 为自定义能力搭建MCP服务器
  • 设计Skill架构
  • 快速原型开发AI能力
不适用场景:
  • 使用现有Agent(请直接调用它们)
  • 通用编码任务(请使用特定语言的Skill)
  • 基础设施搭建(请使用deployment-engineer)
  • 修改Claude的核心行为

Anti-Patterns

反模式

Anti-Pattern: Knowledge Dump

反模式:知识堆砌

What it looks like: Pasting entire documentation into agent Why wrong: Overwhelming, poor retrieval, bloated context Instead: Curate essential knowledge, use progressive disclosure
表现:将完整文档直接粘贴到Agent中 问题:信息过载、检索效率低、上下文臃肿 正确做法:筛选核心知识,采用渐进式信息披露

Anti-Pattern: Vague Persona

反模式:模糊角色定位

What it looks like: "You are an expert assistant" Why wrong: No personality, generic outputs Instead: Specific role, years of experience, communication style
表现:“你是一位专家助手” 问题:缺乏个性,输出内容通用化 正确做法:明确具体角色、从业年限、沟通风格

Anti-Pattern: Missing Scope

反模式:范围模糊

What it looks like: Agent that tries to do everything Why wrong: Jack of all trades, master of none Instead: Clear boundaries with redirect suggestions
表现:试图包揽所有任务的Agent 问题:面面俱到但无一精通 正确做法:明确边界,并提供重定向建议

Anti-Pattern: No Examples

反模式:缺少示例

What it looks like: Abstract descriptions without code Why wrong: Users can't see how to apply guidance Instead: Concrete, runnable examples for key patterns
表现:仅用抽象描述,无代码示例 问题:用户无法理解如何应用指导内容 正确做法:为关键模式提供可运行的具体示例

Reference Files

参考文件

  • references/agent-templates.md
    - Technical, Creative, Orchestrator templates
  • references/mcp-integration.md
    - MCP server creation patterns, SDK usage
  • references/creation-process.md
    - End-to-end workflow, quality checklist

Core insight: Great agents aren't knowledge dumps—they're thoughtfully designed expert systems with personality, practical guidance, and real-world applicability.
Use with: skill-coach (quality review) | skill-documentarian (documentation) | orchestrator (multi-agent design)
  • references/agent-templates.md
    - 技术专家、创意设计、协调类模板
  • references/mcp-integration.md
    - MCP服务器创建模式、SDK使用方法
  • references/creation-process.md
    - 端到端工作流程、质量检查清单

核心见解:优秀的Agent不是知识堆砌,而是经过精心设计的专家系统,具备鲜明个性、实用指导方案和真实场景适用性。
搭配使用:skill-coach(质量审核) | skill-documentarian(文档撰写) | orchestrator(多Agent设计)