Menu
MixSeek-Plusのデバッグ機能を有効化し、ログ出力を制御します。「デバッグモードを有効化」「verbose」「ログを出力」「ログレベル」「デバッグ設定」といった依頼で使用してください。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
現在の環境で適切なPythonコマンドを判別し、スクリプトを実行します。「Pythonコマンドを確認」「どのpythonを使う」「Python実行方法」といった依頼や、他のスキルからPythonスクリプトを実行する前に使用してください。
MixSeekの設定ファイル（team.toml、orchestrator.toml、evaluator.toml、judgment.toml）を検証します。「設定を検証」「TOMLをチェック」「設定ファイルの確認」「バリデーション」「ワークスペースの検証」といった依頼で使用してください。TOML構文とMixSeekスキーマへの準拠を確認します。
MixSeekの評価設定ファイル（evaluator.toml、judgment.toml）を生成します。「評価設定を作成」「スコアリング設定」「判定設定を作って」「メトリクスを設定」といった依頼で使用してください。Submissionの評価基準と最終判定ロジックを定義します。
MixSeek-Coreで利用可能なLLMモデルの一覧を表示します。「使えるモデル」「モデル一覧」「どのモデルがある」「モデルを取得」「APIからモデル」といった依頼で使用してください。API経由でプロバイダー別のモデル情報を動的取得し、推奨設定、互換性情報を提供します。
MixSeekのオーケストレーター設定ファイル（orchestrator.toml）を生成します。「オーケストレーターを設定」「チーム競合設定」「複数チームで競わせる」「マルチチーム実行設定」といった依頼で使用してください。複数チームを並列実行して最良の結果を選択する設定を定義します。
MixSeekのプロンプトビルダー設定ファイル（prompt_builder.toml）を生成します。「プロンプトを設定」「プロンプトビルダーを作成」「ラウンド別プロンプト」といった依頼で使用してください。
| name | mixseek-debug |
| description | MixSeek-Plusのデバッグ機能を有効化し、ログ出力を制御します。「デバッグモードを有効化」「verbose」「ログを出力」「ログレベル」「デバッグ設定」といった依頼で使用してください。 |
| license | Apache-2.0 |
| compatibility | Requires mixseek-core or mixseek-plus. Python 3.13+, uv recommended. |
| metadata | {"author":"mixseek","version":"1.0.0"} |
MixSeek-Plusは複数のデバッグ用環境変数を提供しています。これらを使用して、エージェント実行時の詳細なログ出力を有効化し、問題の診断や動作確認を行うことができます。
| 環境変数 | 値 | 効果 | スコープ |
|---|---|---|---|
MIXSEEK_VERBOSE | 1 または true | 統合デバッグモード | MCPツールログ + mixseek.member_agents(DEBUG) + claudecode_model(DEBUG) |
CLAUDECODE_MODEL_LOG_LEVEL | DEBUG | claudecode-model単体のログ | claudecode-modelパッケージのみ |
MIXSEEK_LOGFIRE | 1 または true | Logfireインストルメンテーション | pydantic-ai トレース（要Logfire設定） |
通常のデバッグには MIXSEEK_VERBOSE=1 のみで十分です。
MIXSEEK_VERBOSE=1 を設定すると、以下のログが有効化されます：
mixseek.member_agents ロガーのDEBUGレベル出力claudecode_model ロガーのDEBUGレベル出力現在の環境変数設定を確認するには、以下のスクリプトを実行してください：
bash skills/mixseek-debug/scripts/check-debug-env.sh
# 統合デバッグモード（推奨）
MIXSEEK_VERBOSE=1 uv run mskp team "タスク" --config configs/agents/team.toml
# claudecode-model単体のデバッグ
CLAUDECODE_MODEL_LOG_LEVEL=DEBUG uv run mskp team "タスク" --config configs/agents/team.toml
# 複数の環境変数を組み合わせ
MIXSEEK_VERBOSE=1 MIXSEEK_LOGFIRE=1 uv run mskp team "タスク" --config configs/agents/team.toml
# 現在のセッションに設定
export MIXSEEK_VERBOSE=1
# 以降のコマンドはすべてverboseモードで実行される
uv run mskp team "タスク" --config configs/agents/team.toml
# 無効化
unset MIXSEEK_VERBOSE
import mixseek_plus
# 方法A: enable_verbose_mode()を使用（推奨）
mixseek_plus.enable_verbose_mode()
mixseek_plus.patch_core()
# これ以降のClaudeCodeエージェントはverboseログを出力
# コンソール出力例:
# [Tool Start] fetch_page: url=https://example.com
# [Tool Done] fetch_page: success in 1234ms
# ファイル出力先: $WORKSPACE/logs/member-agent-YYYY-MM-DD.log
# verboseモードを無効化
mixseek_plus.disable_verbose_mode()
import os
import mixseek_plus
# 方法B: 環境変数を直接設定
os.environ["MIXSEEK_VERBOSE"] = "1"
mixseek_plus.patch_core()
# 方法C: 一時的に有効化（コンテキストマネージャは非提供、手動管理）
os.environ["MIXSEEK_VERBOSE"] = "1"
try:
# デバッグしたい処理
pass
finally:
del os.environ["MIXSEEK_VERBOSE"]
MIXSEEK_VERBOSE=1 時、以下のフォーマットでコンソールに出力されます：
[Tool Start] <tool_name>: <params>
[Tool Done] <tool_name>: <status> in <time>ms
[Tool Result Preview] <result_preview>
例:
[Tool Start] fetch_page: url=https://example.com/docs
[Tool Done] fetch_page: success in 2345ms
[Tool Result Preview] # Documentation\n\nWelcome to...
Member Agentのログは以下のファイルに出力されます：
$MIXSEEK_WORKSPACE/logs/member-agent-YYYY-MM-DD.log
出力内容:
MIXSEEK_VERBOSE=1 時、claudecode_model ロガーも自動的にDEBUGレベルに設定され、以下が出力されます：
claudecode_model - DEBUG - <message>
MIXSEEK_VERBOSE=1 uv run mskp team "Webページを取得して要約して" --config configs/agents/team.toml
# 事前にLogfireの設定が必要
MIXSEEK_VERBOSE=1 MIXSEEK_LOGFIRE=1 uv run mskp team "タスク" --config configs/agents/team.toml
他のログを抑制してclaudecode-modelのみをデバッグしたい場合：
CLAUDECODE_MODEL_LOG_LEVEL=DEBUG uv run mskp team "タスク" --config configs/agents/team.toml
原因1: 環境変数が正しく設定されていない
# 確認
echo $MIXSEEK_VERBOSE
# 正しく設定
export MIXSEEK_VERBOSE=1
原因2: patch_core()が呼び出されていない
Python APIを使用する場合、patch_core() を呼び出す必要があります：
import mixseek_plus
mixseek_plus.enable_verbose_mode()
mixseek_plus.patch_core() # これを忘れないこと
原因3: ログハンドラーが設定されていない
Pythonのロギング設定を確認してください：
import logging
logging.basicConfig(level=logging.DEBUG)
原因: MIXSEEK_WORKSPACEが設定されていない
# 確認
echo $MIXSEEK_WORKSPACE
# 設定
export MIXSEEK_WORKSPACE=/path/to/workspace
# ログファイルの場所
ls -la $MIXSEEK_WORKSPACE/logs/
MIXSEEK_VERBOSE=1 は多くのログを出力します。特定のコンポーネントのみをデバッグしたい場合：
# claudecode-model単体のみ
CLAUDECODE_MODEL_LOG_LEVEL=DEBUG uv run mskp team "タスク" --config configs/agents/team.toml
または、Pythonでロガーレベルを個別に制御：
import logging
# 特定のロガーのみDEBUGに
logging.getLogger("claudecode_model").setLevel(logging.DEBUG)
# 他はINFOに抑制
logging.getLogger("mixseek.member_agents").setLevel(logging.INFO)
原因: Logfireが設定されていない
Logfireを使用するには、事前に設定が必要です：
import logfire
logfire.configure()
詳細は Logfire公式ドキュメント を参照してください。
デバッグが完了したら、環境変数を削除または無効化してください：
unset MIXSEEK_VERBOSE
unset CLAUDECODE_MODEL_LOG_LEVEL
unset MIXSEEK_LOGFIRE
または、Python APIで：
import mixseek_plus
mixseek_plus.disable_verbose_mode()