drillan 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
解決方法:
- ファイルパスが正しいか確認
$MIXSEEK_WORKSPACEからの相対パスを使用
参照
- Pythonコマンド判別:
skills/detect-python-command/SKILL.md - チーム設定スキーマ:
skills/mixseek-team-config/references/TOML-SCHEMA.md - オーケストレーター設定スキーマ:
skills/mixseek-orchestrator-config/references/TOML-SCHEMA.md - 評価設定スキーマ:
skills/mixseek-evaluator-config/references/TOML-SCHEMA.md