前言¶
線下或線上湊一桌麻將，最怕的不是牌運，而是規則對不上：四川血戰到底、廣東推倒胡、杭州麻將的財神與承包，各有一套說法。翻論壇、問羣友，往往得到半截答案，還容易和當前桌子的「房規」混在一起。若你已經在 Cursor、Claude Code 等環境裏用 Agent 處理日常事務，把「地方麻將規則說明 + 基礎技巧 + 新手教程」做成可複用的 Skill，可以在娛樂前快速對齊玩法，而不是每次從零搜索。
下面介紹 SkillHub 上的社區 Skill「麻將助手」：它做什麼、如何安裝，以及使用時需要留意的邊界。
這是什麼¶
「麻將助手」是 SkillHub 座標 @user_29dc410e/mahjong-helper-skill 下的生活類（life-service）技能，版本 1.0.0，來源爲 community，發佈者爲 user_29dc410e。官方簡介寫明：提供麻將技巧及麻將輔助，幫助娛樂時更從容；內置麻將教程，支持新手學習。
該 Skill 標註 requires_api_key=false，不依賴額外 API Key。SkillHub 頁面顯示評分 100000、下載約 1791 次、安裝 4 次（數據以 SkillHub 展示爲準）。
核心功能¶
依據 SkillHub 官方簡介，已覈實的能力包括：
- 麻將技巧與輔助：在對話中圍繞牌局、策略、常見局面向 Agent 提問，由 Skill 引導模型按麻將語境作答（具體觸發方式以安裝後的 SKILL 說明爲準）。
- 多地方玩法覆蓋：支持四川麻將、廣東麻將、杭州麻將、長沙麻將、東北麻將、上海麻將、武漢麻將、溫州麻將、陝西麻將、蘇州麻將、安徽麻將等玩法說明與差異對比。
- 新手教程：內置面向初學者的麻將學習內容，適合在開局前快速補課術語與流程。
未在官方資料中出現的功能（例如實時識牌、聯網對戰、具體算分器實現）不在本文範圍內。
安裝與啓用¶
SkillHub 推薦兩種方式：用 CLI 安裝，或把安裝提示詞交給當前 AI 按官方文檔執行。
1. 安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可用官方一鍵腳本（完整安裝含默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安裝「麻將助手」到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認落在 ./skills/，Agent 可能讀不到。常見路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝命令形式如下（將 <skills 目錄> 換成你的實際路徑）：
skillhub install @user_29dc410e/mahjong-helper-skill --dir <skills 目錄>
也可按 SkillHub 技能頁提示，讓 AI 參照 SkillHub 安裝說明 安裝 @user_29dc410e/mahjong-helper-skill。
經過上面的步驟後，按你所用客戶端的要求重啓或刷新 Agent，使新 Skill 被加載。
典型用法¶
官方頁面未提供逐條複製的對話腳本，但結合簡介與 Skill 定位，可復現的用法如下：
- 確認「麻將助手」已出現在當前環境的 skills 目錄且已被 Agent 加載。
- 在對話中明確地方玩法與你想問的內容，例如：「按四川麻將規則，查叫時哪些牌型算番？」或「廣東推倒胡裏，槓上開花怎麼算？」
- 若是新手，可直接要求走教程路徑，例如：「用內置教程講一下麻將基本流程和常用術語。」
提問時儘量寫清地方規則名稱，避免模型默認成另一種玩法。房規（封頂、換三張、是否帶風等）若與標準地方規則不同，應在問題裏一併說明，由 Agent 在 Skill 約束下作答。
適用場景與注意¶
適合誰
- 偶爾打牌、需要快速查某地麻將規則或番型說明的用戶。
- 剛入門、希望在 Agent 裏系統看教程、對照術語的用戶。
- 已在 Cursor / Claude Code / 其他支持 SkillHub 路徑的客戶端中使用 Agent 的開發者或玩家。
限制與注意
- 內容爲娛樂向技巧與規則輔助，不能替代當地牌局的正式裁判或合同約定；涉及金錢的場合請以同桌約定爲準。
- 社區來源（community），更新與維護節奏取決於發佈者，使用前可在 SkillHub 查看版本是否爲 v1.0.0。
- 模型回答仍可能遺漏地方變體；複雜房規建議以 Skill 說明支持的範圍爲界，必要時人工覈對。
- 安裝統計中的「安裝次數」與「下載次數」在 SkillHub 上分別展示，二者含義不同，勿混爲一談。
結尾¶
「麻將助手」把多地麻將規則說明、技巧輔助和新手教程收進一個 Skill，適合在 Agent 對話裏按需查詢，且無需配置 API Key。若你要從官方渠道安裝或查看詳情，可打開 SkillHub 技能頁：
https://www.skillhub.cn/skills/user_29dc410e/mahjong-helper-skill
API 元數據地址：
https://api.skillhub.cn/user_29dc410e/mahjong-helper-skill
