ahc-optuna

ahc-optuna

AHC のハイパーパラメータ最適化（eval.py -o）を安全に回すための skill。

使うタイミング

• ユーザーが Optuna で定数調整を依頼したとき。
• 環境変数経由で a.rs の評価パラメータを最適化したいとき。

MUST

• 対象定数は *_DEFAULT として a.rs 冒頭に定義する。
• Env に対応メンバを追加し、Env::init で初期化する。
• 初期化は次の形式にそろえる:
  • self.xxx = os_env::get("xxx").and_then(|s: String| s.parse::<f64>().ok()).unwrap_or(XXX_DEFAULT);
• eval.py 側は AHC_PARAMS_XXX、a.rs 側は os_env::get("xxx") を使う。
• 最適化対象は実際の選択ロジックで使う値のみに限定する。
• 事前チェック:
  • /Users/toastuz/Develop/.venv/bin/python3 eval.py -s 0 -v
  • 極端値でスコア差分を確認（キー反映漏れ検知）
• 実行:
  • 短試行: /Users/toastuz/Develop/.venv/bin/python3 eval.py -s 0 49 -o 20
  • 本試行: /Users/toastuz/Develop/.venv/bin/python3 eval.py -s 0 49 -o 100
• 反映:
  • study.best_trial.params を *_DEFAULT へ反映する。
  • /Users/toastuz/Develop/.venv/bin/python3 eval.py -s 0 -v
  • /Users/toastuz/Develop/.venv/bin/python3 eval.py -s 0 49
  • 必要なら /Users/toastuz/Develop/.venv/bin/python3 eval.py -s 0 49 --seq

SHOULD

• 探索範囲は現行値の近傍から開始し、端に寄ったら再設定する。
• 一度に最適化するパラメータ数は抑える。
• 実行結果は「変更パラメータ」「best」「再検証結果」をセットで報告する。

FORBIDDEN

• a.rs 側で AHC_PARAMS_ 接頭辞付きキーを直接参照しない。
• 未使用パラメータを最適化対象に入れない。
• 全試行同値を放置して次ステップへ進めない。

OUTPUT

• 変更した *_DEFAULT 一覧
• best trial の主要パラメータ
• 再検証結果（-s 0 -v, -s 0 49, 必要なら --seq）