massgen-config-creator

Config Creator

このスキルでは、MassGen の規約とベストプラクティスに準拠した新しい YAML 設定ファイルを作成するためのガイダンスを提供します。

目的

config-creator スキルは、MassGen エージェント向けに適切に構成され、検証済みの設定ファイルを作成するのに役立ちます。コードベース全体で一貫性を保ち、よくある間違いを避けるのに役立ちます。

このスキルを使う場面

次のような場合に config-creator スキルを使います。

• 新機能を紹介する設定例を作成する
• 事例やリリース向けの設定を作成する
• 再利用可能なマルチエージェントのワークフロー設定を構築する
• 新しいバックエンドやツールとの連携をテストする
• 設定パターンをユーザーと共有する

信頼できるドキュメント

重要： 設定作成に関する主な情報源は次のとおりです。

📖 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 → バックエンドレベル（個々のエージェントのワークスペース）
• context_paths → オーケストレーターレベル（共有の読み取り専用ファイル）
• enable_web_search → バックエンドレベル
• enable_planning_mode → ORCHESTRATOR.COORDINATIONレベル

プロパティの詳細については、docs/source/development/writing_configs.rst を参照してください。

3. 主な規約

✅ 推奨事項：

• 費用対効果の高いモデル（gpt-5-nano、gpt-5-mini、gemini-2.5-flash）を優先する
• すべてのエージェントに同一の system_message を指定する
• エージェントごとに別々のワークスペースを使う
• 実行フローを説明する「何が起こるか」のコメントを含める

❌ 禁止事項：

• 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:  # Singular
  id: "my_agent"
  backend:
    type: "claude"
    model: "claude-sonnet-4"

マルチエージェント

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

エージェント向けのヒント

プログラムで設定を作成する場合：

1. まず、必ず信頼できるドキュメントを読む：docs/source/development/writing_configs.rst
2. 既存の設定を読み、現在のパターンを把握する
3. 類似の設定の構成をコピーし、独自に作らない
4. 作成後、すぐにテストする
5. 判断に迷ったら、docs/source/development/writing_configs.rst の完全なガイドを参照する

このスキルはクイックリファレンスガイドです。包括的で最新の情報については、必ず上記の公式ドキュメントファイルを参照してください。