massgen-config-creator

配置创建器

此技能为创建符合 MassGen 约定和最佳实践的新 YAML 配置文件提供指导。

用途

config-creator 技能可帮助你为 MassGen Agent 创建结构良好且经过验证的配置文件。它能确保整个代码库保持一致，并帮助避免常见错误。

何时使用此技能

在以下情况下使用 config-creator 技能：

• 创建展示新功能的示例配置
• 为案例研究或版本发布编写配置
• 构建可复用的多 Agent 工作流配置
• 测试新的后端或工具集成
• 与用户分享配置模式

权威文档

重要提示： 创建配置的首要权威资料是：

📖 docs/source/development/writing_configs.rst

此文件包含：

• 完整的配置创建工作流
• 当前所有约定和规则
• 属性放置位置参考
• 验证清单
• 常见模式和示例
• 最新模板

请始终查阅此文档，以了解最新的配置标准。

关键规则（快速参考）

1. 切勿臆造属性

务必先阅读 2-3 个现有配置，了解当前约定：

# Find similar configs
ls massgen/configs/tools/{category}/

# Read examples
cat massgen/configs/basic/multi/two_agents_gemini.yaml
cat massgen/configs/tools/mcp/filesystem_claude.yaml

2. 属性放置位置很重要

• cwd → 后端级别（单个 Agent 的工作区）
• context_paths → 协调器级别（共享的只读文件）
• enable_web_search → 后端级别
• enable_planning_mode → 协调器的协调级别

完整的属性参考请参阅 docs/source/development/writing_configs.rst。

3. 关键约定

✅ 应该：

• 优先选择经济高效的模型（gpt-5-nano、gpt-5-mini、gemini-2.5-flash）
• 为所有 Agent 设置相同的 system_message
• 为每个 Agent 使用独立的工作区
• 添加说明执行流程的“会发生什么”注释

❌ 不应该：

• 引用 massgen v1 或旧版路径
• 臆造新属性
• 建议会删除日志的清理命令

快速入门工作流

步骤 1：研究现有配置

# Find configs in your category
ls massgen/configs/tools/{relevant_category}/

# Read 2-3 similar examples
cat massgen/configs/basic/multi/two_agents_gemini.yaml

步骤 2：复制并调整

• 复制类似的配置作为起点
• 调整值，但不要臆造属性
• 遵循现有配置的结构

步骤 3：测试

massgen --config massgen/configs/tools/{category}/{your_config}.yaml "Test prompt"

步骤 4：验证

请参阅 docs/source/development/writing_configs.rst 中的验证清单。

文件命名和位置

命名模式：

{agent_description}_{feature}.yaml

位置类别：

• massgen/configs/basic/ - 简单示例
• massgen/configs/tools/filesystem/ - 文件系统操作
• massgen/configs/tools/web-search/ - 网页搜索
• massgen/configs/tools/code-execution/ - 代码执行
• massgen/configs/tools/multimodal/ - 图像、视觉、音频
• massgen/configs/tools/mcp/ - MCP 集成
• massgen/configs/tools/planning/ - 规划模式

常见模式（快速参考）

单 Agent

agent:  # Singular
  id: "my_agent"
  backend:
    type: "claude"
    model: "claude-sonnet-4"

多 Agent

agents:  # Plural
  - id: "agent_a"
    backend:
      type: "openai"
      model: "gpt-5-mini"
    system_message: "Shared task description"

  - id: "agent_b"
    backend:
      type: "gemini"
      model: "gemini-2.5-flash"
    system_message: "Shared task description"

使用文件系统访问

agents:
  - backend:
      cwd: "workspace1"  # Backend-level

orchestrator:
  context_paths:  # Orchestrator-level
    - path: "massgen/configs/resources/v0.0.29-example/source"
      permission: "read"

参考文件

主要文档：

• 配置编写指南：docs/source/development/writing_configs.rst ⭐ 从这里开始
• YAML 架构参考：docs/source/reference/yaml_schema.rst
• 示例配置：massgen/configs/

辅助文档：

• 支持的模型：docs/source/reference/supported_models.rst
• 后端配置：docs/source/user_guide/backends.rst
• MCP 集成：docs/source/user_guide/mcp_integration.rst

给 Agent 的提示

以编程方式创建配置时：

1. 务必先阅读权威文档：docs/source/development/writing_configs.rst
2. 阅读现有配置，了解当前模式
3. 复制类似配置的结构，不要自行臆造
4. 创建后立即测试
5. 如有疑问，请查阅 docs/source/development/writing_configs.rst 中的完整指南

此技能是一份快速参考指南。如需全面且最新的信息，请始终参阅上文列出的官方文档。