mixseek-prompt-builder

MixSeek-Coreのプロンプトビルダー設定ファイル（prompt_builder.toml）を生成します。3つのテンプレートを定義し、各コンポーネントへのプロンプト配信を制御します。

テンプレートの役割

| テンプレート | 対象 | 用途 |

|-------------|------|------|

| team_user_prompt | Team (Leader Agent) | ラウンド別の指示、過去履歴の提示 |

| evaluator_user_prompt | Evaluator | 提出内容の評価指示 |

| judgment_user_prompt | Judgment Client | 継続・終了の判定指示 |

• ワークスペースが初期化されていること（mixseek-workspace-init参照）
• 環境変数 MIXSEEK_WORKSPACE が設定されていること（推奨）
• orchestrator設定が存在すること（マルチラウンド機能を使用する場合）

• パス: $MIXSEEK_WORKSPACE/configs/prompt_builder.toml

Step 1: 要件のヒアリング

ユーザーに以下を確認してください:

1. 用途: どのようなタスクに使用するか（調査、分析、コード生成など）
2. ラウンド戦略: マルチラウンドで改善するか、単発実行か
3. カスタム判定基準: 終了条件に特別な基準があるか

Step 2: テンプレートの選択

用途に応じてテンプレートを選択:

| テンプレート | 用途 | 特徴 |

|-------------|------|------|

| default | 一般的な競合形式 | リーダーボード参照、基本的なラウンド進行 |

| deep-research | Deep Research | ラウンド別検索キーワード改善、段階的深掘り |

| single-round | 単発実行 | シンプル構造、ラウンド変数の最小使用 |

Step 3: カスタマイズ

必要に応じて以下をカスタマイズ:

• Jinja2条件分岐: {% if round_number == 1 %} などでラウンド別指示
• 変数の追加使用: {{ ranking_table }} でリーダーボード表示
• 判定基準の調整: judgment_user_promptの判定条件

Step 4: ファイルの保存

生成した設定を以下のパスに保存:

```bash

$MIXSEEK_WORKSPACE/configs/prompt_builder.toml

```

Step 5: 設定ファイルの検証

生成後は構文とプレースホルダーを確認:

```bash

# TOML構文の検証

uv run python -c "import tomllib; tomllib.load(open('configs/prompt_builder.toml', 'rb'))"

# Jinja2構文の検証（オプション）

uv run python -c "

from jinja2 import Environment

env = Environment()

import tomllib

config = tomllib.load(open('configs/prompt_builder.toml', 'rb'))

for key in ['team_user_prompt', 'evaluator_user_prompt', 'judgment_user_prompt']:

env.parse(config['prompt_builder'][key])

print('OK')

"

```

default（デフォルト）

• 一般的なチーム競合形式
• リーダーボード参照あり
• 基本的なラウンド進行指示
• 用途: 汎用的なタスク

deep-research

• Deep Research特化
• ラウンド1: 初期調査、広範な検索
• ラウンド2: キーワード改善、深掘り
• ラウンド3: 最終統合、検証
• 用途: 調査・リサーチタスク

single-round

• 単発実行向け
• シンプルなプロンプト構造
• ラウンド変数の最小使用
• 用途: 一回きりのタスク

Team / Judgment 共通変数

| 変数名 | 型 | 説明 |

|--------|-----|------|

| user_prompt | string | 元のユーザプロンプト |

| round_number | int | 現在のラウンド番号（1始まり） |

| submission_history | string | 過去のSubmission履歴（整形済み） |

| ranking_table | string | リーダーボード（整形済み） |

| team_position_message | string | チーム順位メッセージ |

| current_datetime | string | 現在日時（ISO 8601形式） |

Evaluator専用変数

| 変数名 | 型 | 説明 |

|--------|-----|------|

| user_prompt | string | 元のユーザプロンプト |

| submission | string | 評価対象のエージェント提出内容 |

| current_datetime | string | 現在日時（ISO 8601形式） |

詳細は references/JINJA2-VARIABLES.md を参照してください。

Deep Research設定例

```toml

[prompt_builder]

team_user_prompt = """

現在日時: {{ current_datetime }}

# タスク

{{ user_prompt }}

# ラウンド {{ round_number }}

{% if round_number == 1 %}

• 広範な検索キーワードで情報収集
• 主要な情報源を特定

{% elif round_number == 2 %}

• 前回の結果を分析し、より具体的なキーワードを使用
• 情報の空白を埋める

{% else %}

• 情報を検証し、矛盾を解消
• 構造化された回答を作成

{% endif %}

# 過去の提出履歴

{{ submission_history }}

"""

evaluator_user_prompt = """

# 評価タスク

以下の提出内容を評価してください。

{{ user_prompt }}

{{ submission }}

"""

judgment_user_prompt = """

# 判定タスク

調査の継続が必要かどうかを判定してください。

• 継続: 情報不足、重要な観点が欠落
• 終了: 十分な回答が可能

{{ user_prompt }}

{{ submission_history }}

{{ ranking_table }}

"""

```

カスタム判定基準例

```toml

judgment_user_prompt = """

# カスタム判定

以下の基準で継続・終了を判定してください。

1. 3つ以上の情報源から確認が取れている
2. 数値データが含まれている
3. 最新情報（1年以内）が含まれている

1. 情報源が2つ以下
2. 推測や不確かな表現が多い
3. 重要な観点が欠落している

{{ user_prompt }}

{{ submission_history }}

"""

```

Jinja2構文エラー、変数展開の問題、マルチラインTOML文字列については references/JINJA2-VARIABLES.md の「エラー回避」セクションを参照してください。

• TOMLスキーマ詳細: references/TOML-SCHEMA.md
• Jinja2変数詳細: references/JINJA2-VARIABLES.md
• orchestrator設定: skills/mixseek-orchestrator-config/SKILL.md
• evaluator設定: skills/mixseek-evaluator-config/SKILL.md