MixSeek 設定検証

概要

MixSeek-Coreの設定ファイルがTOML構文およびMixSeekスキーマに準拠しているかを検証します。TOML構文エラー、必須フィールドの欠落、値の範囲外エラーなどを検出し、修正方法を提案します。

前提条件

MixSeek-Coreがインストールされていること
検証対象の設定ファイルが存在すること
Pythonコマンドが利用可能であること（detect-python-command スキルで判別）

対応ファイルタイプ

ファイルタイプ	説明	パス例
team	チーム設定	`configs/agents/team-*.toml`
orchestrator	オーケストレーター設定	`orchestrator.toml`
evaluator	評価設定	`configs/evaluators/evaluator.toml`
judgment	判定設定	`configs/judgment/judgment.toml`

使用方法

Step 1: 検証対象の確認

ユーザーにどのファイルを検証するか確認:

検証対象のファイルを指定してください:
- 特定ファイル: configs/agents/team-web-research.toml
- 全設定: すべての設定ファイル

Step 2: 検証の実行

detect-python-command スキルの run-python.sh を使用して検証を実行します：

# 特定ファイルの検証
skills/detect-python-command/scripts/run-python.sh \
    skills/mixseek-config-validate/scripts/validate-config.py <file-path>

# ファイルタイプを指定して検証
skills/detect-python-command/scripts/run-python.sh \
    skills/mixseek-config-validate/scripts/validate-config.py <file-path> --type team

Step 3: 結果の報告

検証結果をユーザーに報告:

成功時: 検証項目と結果を表示
失敗時: エラー内容と修正方法を提案

検証項目

TOML構文検証

基本構文の正しさ
文字列のクォート
配列・テーブルの形式
コメントの形式

スキーマ検証

項目	説明
必須フィールド	必要なフィールドが存在するか
フィールド型	値の型が正しいか
値の範囲	数値が許容範囲内か
形式	モデル形式など特殊形式の検証
一意性	agent_name等の一意性
整合性	min_rounds <= max_rounds 等

例

単一ファイルの検証

User: team.tomlを検証して

Agent: configs/agents/team-web-research.toml を検証します...

       ✅ TOML構文: OK
       ✅ 必須フィールド: OK
         - team.team_id: "team-web-research"
         - team.team_name: "Web Research Team"
         - team.leader.model: "google-gla:gemini-2.5-pro"
       ✅ モデル形式: OK
       ✅ Member Agent数: 2/15
       ✅ agent_name一意性: OK

       検証成功: この設定ファイルは有効です。

エラーがある場合

User: team.tomlを検証して

Agent: configs/agents/team-broken.toml を検証します...

       ❌ エラーが検出されました:

       1. 必須フィールド欠落
          - team.members[0].tool_description が未定義
          - 修正: tool_description = "エージェントの説明" を追加

       2. 値の範囲外
          - team.max_concurrent_members = 100 (範囲: 1-50)
          - 修正: 1〜50の値に変更

       3. モデル形式エラー
          - team.leader.model = "gemini-pro" (無効)
          - 修正: "google-gla:gemini-2.5-pro" 形式に変更

全ファイル検証

User: すべての設定ファイルを検証して

Agent: ワークスペース内の設定ファイルを検証します...

       configs/agents/team-web-research.toml
       ✅ 有効

       configs/agents/team-analysis.toml
       ❌ エラー: member[0].agent_type が無効な値 "search"
          → 有効な値: plain, web_search, code_execution, web_fetch, custom

       configs/evaluators/evaluator.toml
       ✅ 有効

       configs/judgment/judgment.toml
       ✅ 有効

       orchestrator.toml
       ✅ 有効

       結果: 4/5 ファイルが有効

エラーメッセージと修正方法

TOML構文エラー

Error: Invalid TOML at line 15

原因: TOML構文が無効修正: 該当行の構文を確認（クォート、ブラケット等）

必須フィールド欠落

Error: Missing required field: team.leader.system_instruction

修正: 指定されたフィールドを追加

[team.leader]
system_instruction = "指示内容"

型エラー

Error: Field 'temperature' must be float, got string

修正: 値の型を修正

# 誤り
temperature = "0.7"

# 正しい
temperature = 0.7

範囲エラー

Error: Field 'max_rounds' must be 1-10, got 15

修正: 値を許容範囲内に変更

モデル形式エラー

Error: Invalid model format: "gemini-pro"
Expected format: "provider:model-name"

修正: provider:model-name 形式に変更

# 誤り
model = "gemini-pro"

# 正しい
model = "google-gla:gemini-2.5-pro"

重み合計エラー

Error: Metric weights must sum to 1.0, got 0.8

修正: 重みの合計が1.0になるよう調整

CLIコマンド（直接実行）

# 単一ファイル検証
skills/detect-python-command/scripts/run-python.sh \
    skills/mixseek-config-validate/scripts/validate-config.py path/to/config.toml

# タイプ指定
skills/detect-python-command/scripts/run-python.sh \
    skills/mixseek-config-validate/scripts/validate-config.py config.toml --type team

# JSON出力
skills/detect-python-command/scripts/run-python.sh \
    skills/mixseek-config-validate/scripts/validate-config.py config.toml --json

# 詳細出力
skills/detect-python-command/scripts/run-python.sh \
    skills/mixseek-config-validate/scripts/validate-config.py config.toml --verbose

トラブルシューティング

スクリプトが実行できない

Error: No module named 'mixseek'

解決方法:

MixSeek-Coreがインストールされているか確認
uv sync を実行して依存関係を更新

ファイルが見つからない

Error: File not found