Meta-Agent

自进化 MCP 插件 —— Agent 执行失败时，自动分析轨迹、生成新 Skill、沙箱测试、审计上线。

工作原理

Agent 任务失败 → 分析执行轨迹 → LLM 生成 Skill YAML
    → Worker 沙箱测试 → Overfit 审计 → 上线到 SkillPool

提供 5 个 MCP 工具：

| 工具 | 说明 | |------|------| | generate_skill | 从失败轨迹生成新 Skill YAML | | refine_skill | 根据轨迹修缮已有 Skill | | evolve | 完整进化循环：生成 → 测试 → 审计 → 上线 | | audit_skill | 对指定 Skill 做独立过拟合审计 | | refine_from_trace | 从轨迹中提取被调用的 Skill 并逐一修缮 |

安装

pip install -e .

或直接安装依赖：

pip install mcp>=1.0.0 pyyaml httpx python-dotenv sentence-transformers

环境变量

| 变量 | 默认值 | 说明 | |------|--------|------| | META_AGENT_API_KEY | $OPENAI_API_KEY | LLM API 密钥 | | META_AGENT_MODEL | deepseek-chat | 主模型 | | META_AGENT_MODEL_FAST | (空) | 快模型（工具决策用） | | META_AGENT_API_BASE | https://api.deepseek.com/v1 | API 地址 | | META_AGENT_WORKSPACE | workspace/skills | Skill YAML 存储目录 | | LLM_TEMPERATURE | 0.2 | 生成温度 | | EMBEDDING_MODEL | sentence-transformers/all-MiniLM-L6-v2 | Skill 检索嵌入模型 |

最小配置：只需设置 META_AGENT_API_KEY（或 OPENAI_API_KEY）。

MCP 客户端配置

在 Claude Desktop 或其他 MCP 客户端中添加：

{
  "mcpServers": {
    "meta_agent": {
      "command": "python",
      "args": ["-m", "meta_agent"],
      "env": {
        "META_AGENT_API_KEY": "sk-xxx",
        "META_AGENT_WORKSPACE": "/path/to/skills"
      }
    }
  }
}

或通过 pip 安装后使用 CLI 入口：

{
  "mcpServers": {
    "meta_agent": {
      "command": "meta-agent",
      "env": {
        "META_AGENT_API_KEY": "sk-xxx"
      }
    }
  }
}

手动使用

# 通过模块启动
python -m meta_agent

# 或通过 CLI（pip install -e . 后）
meta-agent

以 stdio 模式运行，等待 MCP 客户端连接。

Skill 存储结构

生成的 Skill 以 YAML 形式存储在 workspace 目录：

workspace/skills/
├── skill_index.json          # 全局索引（含 embedding）
├── my_skill/
│   └── skill.yaml            # name, version, status, prose, test_cases
└── another_skill/
    └── skill.yaml

每个 Skill YAML 包含：

name / version / status — 标识与生命周期
description — 一句话描述（用于 embedding 检索）
prose — 注入到 Agent system prompt 的指导文本
test_cases — 验收测试用例
code_tools — 可选代码工具
audit_passed / audit_failures — 审计状态

生命周期

draft → test → active → deprecated
  ↑                ↓
  └── refine ←── fail

draft: Meta-Agent 生成初稿
test: Worker Agent 沙箱验证
active: 审计通过，上线供检索注入
deprecated: 多次失败后废弃

依赖

Python >= 3.10
mcp — MCP 协议实现
pyyaml — Skill 解析
httpx — LLM API 调用
python-dotenv — 环境变量加载
sentence-transformers — Skill 检索 embedding

MCP Servers