前言¶

线下或线上凑一桌麻将，最怕的不是牌运，而是规则对不上：四川血战到底、广东推倒胡、杭州麻将的财神与承包，各有一套说法。翻论坛、问群友，往往得到半截答案，还容易和当前桌子的「房规」混在一起。若你已经在 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 官方简介，已核实的能力包括：

1. 麻将技巧与辅助：在对话中围绕牌局、策略、常见局面向 Agent 提问，由 Skill 引导模型按麻将语境作答（具体触发方式以安装后的 SKILL 说明为准）。
2. 多地方玩法覆盖：支持四川麻将、广东麻将、杭州麻将、长沙麻将、东北麻将、上海麻将、武汉麻将、温州麻将、陕西麻将、苏州麻将、安徽麻将等玩法说明与差异对比。
3. 新手教程：内置面向初学者的麻将学习内容，适合在开局前快速补课术语与流程。

未在官方资料中出现的功能（例如实时识牌、联网对战、具体算分器实现）不在本文范围内。

安装与启用¶

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 定位，可复现的用法如下：

1. 确认「麻将助手」已出现在当前环境的 skills 目录且已被 Agent 加载。
2. 在对话中明确地方玩法与你想问的内容，例如：「按四川麻将规则，查叫时哪些牌型算番？」或「广东推倒胡里，杠上开花怎么算？」
3. 若是新手，可直接要求走教程路径，例如：「用内置教程讲一下麻将基本流程和常用术语。」

提问时尽量写清地方规则名称，避免模型默认成另一种玩法。房规（封顶、换三张、是否带风等）若与标准地方规则不同，应在问题里一并说明，由 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