立直麻将 Skill

中文 | 日本語 | English

面向 Agent Skills 兼容客户端的四人立直麻将助手，支持文本牌谱校验与可复现计算。

能力

• 计算向听、听牌与剩余枚数
• 分析 14 张手牌各舍牌后的向听、有效牌与进张数
• 计算役、宝牌、符、得点和支付
• 根据事件历史校验振听、一发与立直后暗杠的等待变化
• 支持食断/无食断、赤牌/无赤牌规则 profile

默认使用 tenhou-4p-kuitan-aka-v1。不处理三麻、图片识别、押引、对手模型或 EV；包牌和多人荣和只说明所需条件，不作不完整结算。

安装

要求 Python 3.10+。以 Codex 为例：

git clone https://github.com/chenyu1ov3/riichi-mahjong-skill.git ~/.codex/skills/riichi-mahjong
python -m pip install -r ~/.codex/skills/riichi-mahjong/requirements.txt

其他客户端请克隆到其 skill 目录，并保留目录名 riichi-mahjong。

使用

$riichi-mahjong 计算 123m456m55p789p234s 自摸 4s，东场，南家。
$riichi-mahjong 分析 123m123p123s789s7z1m 应舍哪张，并列出有效牌。

输入格式见 牌谱约定，规则见 规则集，机器接口见 JSON Schema。

开发检查：python -m ruff check .、python -X utf8 -m pytest。

基于 MahjongRepository/mahjong，采用 MIT License。