天鳳牌譜をPythonで解析する入門記事

mjlogのタグや副露コードに関する従来の日本語解説の多くがPerlで書かれたり変換ツール前提だったりする中で、生ログから学習サンプルまでを一貫して実行できるPythonの経路が欠けていた。さらに検証の習慣も重視しており、再生関数が各打牌時に手牌の整合性をassertで確認し、3,000試合・30,127局・1,441,017打牌でエラーがなかったと報告している。これらのチェックは正しさの証明ではなくパーサーの誤りを捕まえる手段として位置づけられ、牌種の不一致は手牌整合性を通過し得るため、役IDなどとの照合も併用していると著者は述べる。

ガイドはAI開発者が陥る罠もいくつか挙げている。起家を基準とした座順、明示的なマーカーのないツモ切り（直前に引いた牌を捨てること）は推測が必要、ダブロンは1局につき複数のAGARIエントリを保持する必要、鳴きのある手牌はストリーム上で副露が省略される。XMLには他家の手牌や未来のドラなど隠れた情報が含まれ、モデルに与えると実戦で使えなくなると警告する。著者は検証範囲を2023年の四人打ち・赤五ありの鳳凰卓に限定し、次のステップとしてシャンテンや牌効率の作業を読者に示している。