massgen-config-creator

MassGen Config Creator 是 MassGen 生态系统内开发人员与代理程序的必备实用工具。其主要目标是提供权威指南，以生成结构合理、经过验证的 YAML 配置文件，并确保其遵循既定的框架规范。通过遵循这些标准，用户可以确保整个代码库配置的一致性，减少常见的运行错误，并优化代理程序的性能。此工具专为技术用户、贡献者以及需要构建可重用多代理工作流、定义后端工具集成或为研究与案例研究准备配置的自动化代理而设计。

• 提供关于属性放置的系统性指南，特别强调后端层级设置（如 cwd 或 enable_web_search）与编排器层级设置（如 context_paths 和 planning_mode）之间的必要区分。

• 强制要求严格遵守权威文档 writing_configs.rst，该文档是当前所有规范和架构要求的唯一事实来源。

• 通过鼓励重用 massgen/configs/tools/ 目录中现有稳定配置的模式，促进快速原型开发。

• 支持创建复杂的多代理设置，包括系统消息（system_message）同步以及使用单独目录的工作区隔离。

• 通过提供可靠的结构模板，协助集成各类工具，例如文件系统、MCP、网络搜索以及代码执行环境。

• 在初始化新配置文件之前，请务必先阅读现有的配置文件（例如 massgen/configs/basic/multi/ 中的文件），以确保与当前的命名模式（agent_description_feature.yaml）兼容。

• 切勿凭空捏造新的配置属性；请务必对照 YAML 架构参考文件和官方文档核对所有键值，以避免验证失败。

• 利用已建立的代理后端模式（claude, openai, gemini），并确保选择具有成本效益的模型（例如 gpt-5-mini, gemini-2.5-flash）。

• 配置创建完成后，请务必使用 massgen CLI 命令配合新配置文件进行验证测试，以确保编排流程按预期执行。

• 在创建涉及外部资源的配置文件时，请将其正确分类至适当目录，如 filesystem、multimodal 或 mcp，以方便组织和检索。