mlb-beginner-translator

MLB 初心者向け翻訳

目次

• 例
• ワークフロー
• よくあるパターン
• ガードレール
• クイックリファレンス

例

シナリオ：ラインナップ最適化ツールが生の推奨を出しました。朝のブリーフィングで公開する前に、野球の知識がまったくないユーザー（K L D'Souza）向けに書き直す必要があります。

書き換え前（専門用語だらけの生データ）：

Caminero（TB 3B）は右投手に対するプラトーン成績が良く、Fenway では Bello との相性も良好です（球場係数：得点103／本塁打105）。直近15日間のxwOBAは.410で、基準値の.355を上回っており、好調がうかがえます。3番打者なので、OBPへの貢献度は非常に高いです。daily_quality = 66。盗塁機会は平凡です――Belloの走者への対応は平均的ですが、捕手の盗塁阻止率は28%です。シーズンwOBAとの差に基づく回帰指数は+15です。Hayes（UTIL）よりSTARTにしましょう。HayesはOracleでのブルペンゲームで左投手と対戦します――球場は打者に不利で、機会も少なく、QSの可能性も低いです（厳密に言えば、彼は打者です。つまり、私が言いたいのは、彼の試合の予想最低値が低いということです）。結論：CamineroをSTART、HayesをSIT。

書き換え後（初心者向け）：

Junior Caminero（タンパベイ、三塁手）――今日はSTARTにしましょう。

理由：彼は右投手を得意としています（多くの打者は利き手が反対の投手を相手にするほうがよく打てます）。今日の相手投手（Brayan Bello）は右投げです。また、今日の球場（ボストンのFenway Park）は打者に有利で、平均的な球場より得点が約3%、本塁打が約5%増える傾向があります。さらに、Camineroは最近よく打っています（直近15日間の期待打撃成績は、シーズン平均を約15%上回っています）。打順は3番なので、打席に立つ回数が多く、得点する機会も増えます。今日は盗塁できるかどうか五分五分です――ボストンの捕手は走者をかなりの割合で刺すため、盗塁には期待しません。

Ke'Bryan Hayes（ピッツバーグ、三塁手、ユーティリティ枠）――今日はSITにしましょう。

理由：彼は左投手と対戦します。彼にとっては難しい相手です。また、試合はサンフランシスコのOracle Parkで行われます（気温が低く、外野が広いため、打撃成績が抑えられやすい球場です）。相手チームはブルペンゲーム（先発投手を一人に定めず、試合を通して救援投手を次々に起用する形）を予定しており、大きな打撃機会が少なくなる傾向があります。

アクション：

• 3BでCamineroをSTART。
• HayesをSIT（ベンチ、BNに移動）。

翻訳で行ったこと：

1. 11個の専門用語（RHP、プラトーン成績、球場係数、xwOBA、OBPへの貢献度、daily_quality、SB、CS%、回帰指数、ブルペンゲーム、QS）を検出し、それぞれ初出時に説明するか、専門用語を使わない表現に書き換えました。
2. 「好調」を「最近よく打っています」と書き換えました（ガードレール #2を参照）。
3. 内部エージェントのシグナル（daily_quality = 66、regression_index = +15）を削除しました。これらは入力情報であり、出力ではありません。
4. 最後に、判断を行動動詞（START／SIT）にまとめました。
5. 守備位置の略称（3B、BN）は、初出時に括弧内で正式名称を示した後にのみ使用しました。
6. 自己訂正（「厳密に言えば、彼は打者です……」）を削除しました。エージェントが自分自身と議論する様子をユーザーに見せる必要はありません。

ワークフロー

このチェックリストをコピーして、進捗を記録してください。

MLB Beginner Translator Progress:
- [ ] Step 1: Receive raw draft from upstream agent
- [ ] Step 2: Scan for jargon terms (use glossary list)
- [ ] Step 3: Apply first-mention-gloss rule per term per document
- [ ] Step 4: Rewrite assumed-knowledge phrases (hot streak, plus matchup, etc.)
- [ ] Step 5: Strip internal signals and agent self-talk
- [ ] Step 6: Collapse to action verbs (START / SIT / ADD / DROP / BID $X / ACCEPT / COUNTER / REJECT)
- [ ] Step 7: Validate against rubric (resources/evaluators)

ステップ1：上流エージェントから生の草稿を受け取る

呼び出し元のエージェントが作成したものをそのまま受け取ります。ラインナップ最適化の統合結果、トレード分析の結論、ウェーバー分析の順位、カテゴリー戦略の計画、コーチの朝のブリーフィングなどが該当します。入力は箇条書き、文章、シグナルのJSONブロックのいずれでもかまいません。出力は常に、ユーザー向けの文章とアクションリストにします。

• 文書の種類（ブリーフィング、トレードメモ、チャットの返信、アラート）を特定する
• 名前が挙がっている選手をすべて特定する――各選手について、初出時にチームとポジションを記載する
• すべての推奨事項を特定する――それぞれを行動動詞で締めくくる

ステップ2：専門用語を確認する リポジトリ yahoo-mlb の resources/methodology.md にある用語集全体と、マスターの context/frameworks/beginner-glossary.md を確認します。すべての用語が出現する箇所に印を付けてください。用語は次の5つの形式で現れることがあります。正式名称（「On-Base Percentage」）、頭字語（「OBP」）、複合語（「OBP contribution」）、俗語（「hot bat」）、内部シグナル名（「daily_quality」）です。いずれも専門用語として扱います。

• カテゴリ別のスタッツを検出（R、HR、RBI、SB、OBP、K、ERA、WHIP、QS、SV）
• ポジションの略称を検出（C、1B、2B、3B、SS、OF、UTIL、SP、RP、P、BN、IL、DH）
• 対戦関連用語を検出（RHP、LHP、プラトーン、パークファクター、先発予想、打順、週に2回先発、ブルペンゲーム、オープナー、ストリーミング）
• 高度なスタッツを検出（xwOBA、wOBA、BABIP、FIP、xFIP、SIERA、バレル率、打球速度）
• 移籍・選手獲得関連用語を検出（FAAB、ウェーバー、ローリングウェーバー、H2H、カテゴリ放棄、IL枠での選手確保、DFA、ハンドカフ）
• 選手タイプを検出（掘り出し物候補、期待外れ、ブレイク、ポストハイプ、イニングイーター、クローザー併用）
• 内部シグナル名を検出（daily_quality、form_score、matchup_score、regression_index、qs_probability、streamability_score など）

ステップ3：文書ごとに、用語の初出時に説明を付ける

ステップ2で検出した専門用語は、それぞれ文書内で初めて登場する箇所に、平易な説明を括弧書きで付けます。同じ文書内の2回目以降は、説明なしで用語を使えます。ルールについては resources/methodology.md を、説明の形式については resources/template.md を参照してください。

• 初出の用語の直後に「（平易な説明）」が付いている
• 2回目以降は説明を繰り返していない（読者を煩わせないため）
• 選手名の初出には、必ず所属チームとポジションが併記されている

ステップ4：知識があることを前提とする表現を書き換える

危険なのは、なじみのない単語ではなく、野球の知識をさりげなく前提とする、聞き慣れた表現です。「好調な期間」「良い対戦」「有利な対戦」「手強い左腕」「楽な日程」「生きのいい投手」「三塁を守る」「打者有利な球場」などは、説明を付けるのではなく、書き換える必要があります。詳しい一覧と書き換え例は resources/methodology.md と Guardrails #2 を参照してください。

• 「好調な期間」／「hot bat」→「最近よく打っている」
• 「有利な対戦」／「プラスの対戦」→球場、相手投手の左右、天候など、具体的な理由を明記する
• 「手強い左腕」→「優秀な左投手」
• 「打者有利な球場」→「打者有利なスタジアム（具体的な球場名を明記）」
• 「バットフリップ／ガス／ヒーター／ナスティ」→文字どおりの表現に書き換える

ステップ5：内部シグナルとエージェントの独り言を取り除く

内部シグナルの値（数値の daily_quality、regression_index、streamability_score）は判断のための入力であり、ユーザー向けの内容ではありません。削除してください。また、自己訂正、議論の痕跡、立場を示すラベル（「賛成派の意見は……批判派の意見は……総合すると……」）も削除してください。ユーザーには統合された回答だけを見せます。

• ユーザー向けの文章から数値のシグナル値を削除した
• 立場を示すラベル（「賛成派／批判派／総合」）を削除した
• 自己訂正（「当然ながら」「つまり」「念のため明確にすると」）を削除した
• 確信度の表現は、平易な言葉で示す場合のみ残した（「確信度は高い」は可、「confidence: 0.72」は不可）

ステップ6：行動を示す動詞に絞る

すべての推奨は、曖昧な表現を避け、承認済みの行動動詞で締めくくる必要があります。「検討する」「考えてみる」「〜したほうがよいかもしれない」「〜を試してみてもよい」などは使いません。選択肢の一覧は CLAUDE.md のルール6を参照してください。前段のエージェントが曖昧な表現を使っていた場合は、その曖昧さを取り除き、明確な代替行動を添えた1つの動詞にまとめてください。

• すべての推奨は、次のいずれかで終わります：START / SIT / ADD / DROP / BID $X / ACCEPT / COUNTER（提案する対案を添える）/ REJECT
• ユーザー向けのすべての出力の末尾に、専用の「Actions」箇条書きリストが表示されます
• 「検討してください」「考えてみてください」などの曖昧な表現を、具体的な動詞＋代替案に置き換えます

ステップ 7：評価基準に照らして検証する

翻訳した出力をresources/evaluators/rubric_mlb_beginner_translator.jsonに照らして採点します。最低基準は、平均スコア4.0以上、かつ各評価項目のスコアが3以上であることです。アクション動詞または初出ルールの評価項目が4未満の場合は、公開前に修正してください。

• 評価基準に基づいて採点し、すべての評価項目が3以上
• 平均スコアが4.0以上
• アクション動詞と初出ルールの評価項目が4以上

よくあるパターン

パターン 1：毎日のラインアップ概要（朝）

• 入力形式：daily_qualityスコア、対戦相手に関するメモ、ラインアップが確定済みか未確定かのステータスを含む選手リスト
• 出力形式：選手ごとに短い段落を1つ、その後に統合されたアクションリストを末尾に記載
• 重要な書き換え：daily_qualityスコアは低下。対戦用語（球場係数、RHP/LHP、プラトーン）には注釈を付ける。「confirmed」は「今日のラインアップ表に記載済み」と説明する
• 末尾の表記：選手ごとにSTART / SITを記載し、ポジション枠を明示

パターン 2：トレード推奨メモ

• 入力形式：トレードのオファー（獲得選手／放出選手）、カテゴリーへの影響表、mlb-trade-analyzerによる統合分析
• 出力形式：オファーの要約を1行で示し、平易な言葉で短く「理由」を説明し、カテゴリーへの影響を段落で説明（「長打力を得る一方、走力を失います」）、その後にアクション動詞を1つだけ記載
• 重要な書き換え：カテゴリー名は省略せずに記載する（HR → ホームラン、SV → リリーフ投手によるセーブ）。選手のタイプ（ブレイク候補、飛躍候補）を翻訳する。ロースターとの適合性（SS / OFの起用資格）を説明する
• 末尾の表記：ACCEPT / COUNTER（提案する対案を添える）/ REJECT

パターン 3：ウェイバー／FAAB獲得メモ

• 入力形式：選手の推奨、FAABの入札額、補えるカテゴリーの不足、放出候補
• 出力形式：その選手を獲得できる理由（先発選手の負傷、ブレイクなど）、入札する金額、放出する選手を説明
• 重要な書き換え：FAABは初出時に説明する。「ウェイバー」を説明する。「handcuff」は「抑え投手の控え」と翻訳する。割合は「Y回の先発登板のうち、およそX回」のように表現する
• 末尾の表記：選手に対してBID $X（Player Yを放出）/ PASS

パターン 4：週間カテゴリー戦略プラン

• 入力形式：カテゴリーの状況（リード／劣勢／同点）、捨てるカテゴリーの判断、ストリーミング登板スケジュール
• 出力形式：週間プレビュー――「今週の状況はこうです」――に続けて、カテゴリーごとの具体的なアクションを記載
• 重要な書き換え：H2Hを説明する。「punt」は「他のカテゴリーで優位に立つために、あるカテゴリーを諦める」と説明する。「streaming」は「対戦相手に応じて投手を入れ替える」と説明する。QSを説明する
• 末尾の表記：各方針のアクションを記載する（火曜日にXをSTART、YをDROP、FAABを使ってZをADD）

パターン 5：チャットへの返信（その場の質問）

• 入力形式：ユーザーの質問（「Arraezを放出すべきですか？」など）、エージェントのシグナル、意見の相違
• 出力形式：回答とアクションを1〜3文で示す
• 重要な書き換え：シグナルをそのまま並べない。エージェント間の議論を語らない。ユーザーの言語で回答する
• 末尾の表記：アクション動詞を1つだけ記載

ガードレール

1. 初出時の注釈ルールは文書ごとに適用します。 最初の段落で OBP に注釈を付けたら、同じ文書の第4段落では再度注釈を付けません。読者を煩わせてしまいます。ただし、新しい朝のブリーフなら、専門用語はすべてリセットされます。迷った場合は、新しい文書では再度注釈を付けてください。

2. 「好調が続いている」という落とし穴に注意します。 「hot streak」は意味が自明に見えますが、野球の成績にはばらつきがあり、好不調の波があるとユーザーが知っていることを前提としています。「ここ1～2週間、よく打っています」または「最近、よく投げています」のように書き換えてください。同様の落とし穴：「cold streak」→「最近、苦戦しています」；「plus matchup」→具体的な理由（相手投手、球場、天候）を挙げます；「tough lefty」→「優れた左投手」；「juicy park」→球場名を挙げ、「打者に有利」と説明します；「live arm」→「球速が速く、球の動きも良い」。

3. ユーザー向けの出力では、内部シグナル名を決して使いません。 daily_quality、form_score、matchup_score、opportunity_score、regression_index、streamability_score、qs_probability、obp_contribution、sb_opportunity、role_certainty、k_ceiling、era_whip_risk、two_start_bonus、save_role_certainty はすべて内部用です。これらは判断のための入力であり、ユーザーに伝える内容ではありません。「いつもより運が悪く、今後は成績が上向くはずです」のような意味を伝える必要がある場合は、平易な英語で表現します。

4. 各選手について、文書内で初めて言及するときはチームとポジションを付けます。 「Junior Caminero（タンパベイ、三塁手）」とし、「Caminero」だけにはしません。初出後は姓だけでも構いません。すべての種類の文書に適用されます。

5. 行動を示す動詞は必須です。 「天候が持ちこたえれば、Caminero の先発起用を検討してください」では、ユーザーは「天候が持ちこたえる」の意味を判断できません。明確な主な行動と、具体的な代替案にまとめます。「Caminero を先発起用してください。試合が延期になった場合は、代わりに Hayes を起用してください。」のようにします。「検討する」「考えてみる」「～したほうがよいかもしれない」「試してみてもよい」「～に傾く」「選択肢に入る」は使いません。

6. FAAB は割合ではなく金額で示します。 ユーザーの予算は 100 ドルです。「残りの FAAB の 12％を入札する」ではなく、「12 ドルで入札する」とします。文脈上、割合が必要な場合は、具体的な金額に換算して示します。

7. カテゴリコードは初出時に正式名称を書きます。 「HR」は初心者にとって野球用語ではなく、ただの2文字です。最初は「本塁打（HR）」と書き、その後は「HR」を使います。R、RBI、SB、K、SV、QS に加え、見慣れているように見える OBP／ERA／WHIP も同様です。

8. 独自の専門用語訳を作らないでください。 上流エージェントが使った用語が、マスター用語集（context/frameworks/beginner-glossary.md）または resources/methodology.md の拡張リストにない場合は、（a）上流エージェントに言い換えを依頼するか、（b）用語集で承認された語だけを使って、その用語を避けて書き換えてください。新たな平易な表現を独自に考案してはいけません。ブリーフ間で用語の一貫性を保つことが重要です。

9. 未確認の事実については、適切に不確実性を示します。 上流エージェントの草稿に confidence: low と記された事実、またはウェブで確認できなかった事実が含まれている場合は、「今日のサンフランシスコの天気予報は確認できませんでした。試合が延期になった場合は、以下の代替案を参照してください」のように、平易な英語で不確実性を明示します。不確実性を隠してはいけません。

10. 絵文字や装飾を追加しません。 ユーザーが求めているのは平易な英語であり、過剰に親しげな表現ではありません。選手名や行動を示す動詞を太字にするのは構いません。絵文字、顔文字、「素晴らしい選択です！」のような応援めいた表現は使いません。

クイックリファレンス

動作を表す動詞の段階（CLAUDE.mdのルール6より）：

START             -- put this player in your active lineup today
SIT               -- bench this player today (move to BN)
ADD               -- claim this player (via FAAB or waivers)
DROP              -- release this player from the roster
BID $X            -- submit a FAAB bid of $X (between $0 and remaining budget)
ACCEPT            -- accept the incoming trade offer as-is
COUNTER           -- reject as-is and send back a specific counter (specify the counter)
REJECT            -- reject the incoming trade offer with no counter
PASS              -- do not claim this player (alternative to ADD on waivers)

初出時に解説を付けるパターン：

<bare term> -> <term> (<plain-English description>) on first mention in a document
             -> <bare term> on subsequent mentions in the same document

例：

• 初出時：「Junior CamineroのOBP（安打、四球、または死球で出塁する頻度）は.360です。」
• 以降：「CamineroのOBPは上昇傾向です。」

よくある言い換え（知識があることを前提とした表現）：

エージェントの表現	ユーザー向けの言い換え
「好調期」	「ここ1～2週間、よく打っています」
「不調期」	「最近、苦戦しています」
「有利な対戦」	具体的な理由（球場、投手の利き腕、天候）を挙げます
「手強い左腕」	「優れた左投手」
「打者有利の球場」	「打者に有利な球場（）」
「生きのいい投球」	「速く、よく動く球を投げます」
「乗りに乗っている」	「ここ数試合、好調です」
「好条件の日程」	「今日は有利な条件で試合をします」
「エース」	「野球界屈指の先発投手」
「スター選手」	「トップクラスの選手」
「バットフリップ／特大弾／一発」	「ホームラン」
「剛速球／速球／火の玉」	「速球」
「三振を奪う」	「三振」
「四球／無料の出塁」	「四球（投手が安打を許さずに走者を一塁へ進めること）」

主なリソース：

• resources/template.md：用語のカテゴリ（スタッツ、ポジション、対戦、上級用語、移籍、選手タイプ、シグナル名）別のインライン解説パターン。ブリーフ、トレードメモ、ウェーバーメモ、チャット返信の翻訳前後のテンプレート。
• resources/methodology.md：初出時のルール、知識があることを前提とした表現の注意リスト、動作を表す動詞の徹底、専門用語を含む場合と含まない場合のラインアップ推薦例を含む翻訳前後の例。
• resources/evaluators/rubric_mlb_beginner_translator.json：10項目の評価基準（専門用語の検出、解説の正確さ、初出時のルール、知識があることを前提とした表現の言い換え、シグナルの削除、動作を表す動詞の有無、選手の特定、不確実性の明示、語調、全体の読みやすさ）。
• マスター用語集：yahoo-mlb/context/frameworks/beginner-glossary.md -- 平易な英語での定義をまとめた公式資料です。このスキルはその内容を反映し、さらに拡張しています。

必要な入力：

• 上流のMLBエージェント（coach、lineup-optimizer、waiver-analyst、trade-analyzer、category-strategist、streaming-strategist、playoff-planner）が作成した未加工の草稿
• 対象ドキュメントの種類（ブリーフ、トレードメモ、ウェーバーメモ、カテゴリープラン、チャット返信）
• 上流でのウェブ検索失敗によるconfidence: lowフラグ

生成される出力：

• ユーザー向けに完全に翻訳されたドキュメント：すべての専門用語に初出時の解説を付け、知識があることを前提とした表現をすべて言い換え、内部シグナルをすべて削除し、すべての推奨事項を行動を表す動詞にまとめます。
• 最後にまとめた「Actions」の箇条書きリスト。
• 未確認の事実がある場合は、必要に応じて平易な英語で不確実性に関する注記を追加します。