mixseek-config-validate

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

MixSeek 設定検証

MixSeek 配置验证

概要

概述

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

验证MixSeek-Core的配置文件是否符合TOML语法和MixSeek规范。会检测TOML语法错误、必填字段缺失、值超出范围等问题，并提供修正建议。

前提条件

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

已安装MixSeek-Core
存在待验证的配置文件
可使用Python命令（通过
```
detect-python-command
```
技能判别）

対応ファイルタイプ

支持的文件类型

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

文件类型	说明	路径示例
team	团队配置	`configs/agents/team-*.toml`
orchestrator	编排器配置	`orchestrator.toml`
evaluator	评估配置	`configs/evaluators/evaluator.toml`
judgment	判定配置	`configs/judgment/judgment.toml`

使用方法

Step 1: 検証対象の確認

Step 1: 确认验证对象

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

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

向用户确认要验证的文件：

请指定待验证的文件:
- 特定文件: configs/agents/team-web-research.toml
- 全部配置: 所有配置文件

Step 2: 検証の実行

Step 2: 执行验证

detect-python-command

スキルの

run-python.sh

を使用して検証を実行します：

bash

undefined

使用

detect-python-command

技能的

run-python.sh

执行验证：

bash

undefined

特定ファイルの検証

验证特定文件

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

undefined

skills/detect-python-command/scripts/run-python.sh
skills/mixseek-config-validate/scripts/validate-config.py <file-path> --type team

undefined

Step 3: 結果の報告

Step 3: 报告结果

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

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

向用户报告验证结果:

成功时: 展示验证项及结果
失败时: 说明错误内容并提供修正建议

検証項目

验证项

TOML構文検証

TOML语法验证

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

基础语法正确性
字符串引号
数组、表格格式
注释格式

スキーマ検証

规范验证

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

项目	说明
必填字段	是否存在必要字段
字段类型	值的类型是否正确
值的范围	数值是否在允许范围内
格式	模型格式等特殊格式验证
唯一性	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

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

用户: 验证team.toml

Agent: 正在验证configs/agents/team-web-research.toml...

       ✅ TOML语法: 正常
       ✅ 必填字段: 正常
         - team.team_id: "team-web-research"
         - team.team_name: "Web Research Team"
         - team.leader.model: "google-gla:gemini-2.5-pro"
       ✅ 模型格式: 正常
       ✅ 成员Agent数量: 2/15
       ✅ agent_name唯一性: 正常

       验证成功: 该配置文件有效。

エラーがある場合

存在错误的情况

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" 形式に変更

用户: 验证team.toml

Agent: 正在验证configs/agents/team-broken.toml...

       ❌ 检测到错误:

       1. 必填字段缺失
          - team.members[0].tool_description 未定义
          - 修正: 添加 tool_description = "Agent的说明"

       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 ファイルが有効

用户: 验证所有配置文件

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
       ✅ 有效

       结果: 5个文件中有4个有效

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

错误信息与修正方法

TOML構文エラー

TOML语法错误

Error: Invalid TOML at line 15

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

Error: Invalid TOML at line 15

原因: TOML语法无效修正: 检查对应行的语法（引号、括号等）

必須フィールド欠落

必填字段缺失

Error: Missing required field: team.leader.system_instruction

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

toml

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

Error: Missing required field: team.leader.system_instruction

修正: 添加指定字段

toml

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

型エラー

类型错误

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

修正: 値の型を修正

toml

undefined

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

修正: 修正值的类型

toml

undefined

誤り

错误写法

temperature = "0.7"

正しい

正确写法

temperature = 0.7

undefined

temperature = 0.7

undefined

範囲エラー

范围错误

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

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

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

修正: 将值修改到允许范围内

モデル形式エラー

模型格式错误

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

修正:

provider:model-name

形式に変更

toml

undefined

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

修正: 改为

provider:model-name

格式

toml

undefined

誤り

错误写法

model = "gemini-pro"

正しい

正确写法

model = "google-gla:gemini-2.5-pro"

undefined

model = "google-gla:gemini-2.5-pro"

undefined

重み合計エラー

权重总和错误

Error: Metric weights must sum to 1.0, got 0.8

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

Error: Metric weights must sum to 1.0, got 0.8

修正: 调整权重使总和为1.0

CLIコマンド（直接実行）

CLI命令（直接执行）

bash

undefined

bash

undefined

単一ファイル検証

单个文件验证

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出力

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

undefined

skills/detect-python-command/scripts/run-python.sh
skills/mixseek-config-validate/scripts/validate-config.py config.toml --verbose

undefined

トラブルシューティング

故障排除

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

无法执行脚本

Error: No module named 'mixseek'

解決方法:

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

Error: No module named 'mixseek'

解决方法:

确认已安装MixSeek-Core
执行
```
uv sync
```
更新依赖

ファイルが見つからない

文件未找到

Error: File not found

解決方法:

ファイルパスが正しいか確認
```
$MIXSEEK_WORKSPACE
```
からの相対パスを使用

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

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