前言¶

在 Cursor、Claude Code 等环境里做 Skill 时，常见做法是写长文档或接外部 API。若你只是想验证「唤醒词 + 对话流程 + 本地脚本」能否跑通，用一个小游戏做样板往往更直观：规则固定、不依赖密钥、也方便对照 SKILL.md 里的说明改参数。

下面介绍 SkillHub 社区 Skill interesting-（坐标 @user_c7d255d2/interesting-guess-game）。它把「猜数字」封装成可被 Agent 按指令调度的内容类能力，附带可独立运行的 Python 实现。

这是什么¶

interesting- 在 SkillHub 上的展示名即为 interesting-，版本 1.0.0，分类为 content-creation，来源 community，发布者为 user_c7d255d2。包内 SKILL.md 将能力定位为「趣味猜数字小游戏」：系统按难度随机生成目标数，玩家输入猜测后得到偏大/偏小提示，并统计得分与猜测次数。

SkillHub 元数据标明 requires_api_key=false，无需配置 API Key。截至页面与商店抓取信息，评分为 100000，下载 734 次，安装计数为 0（以 SkillHub 展示为准）。

官方入口：

• API/安装线索页：https://api.skillhub.cn/user_c7d255d2/interesting-guess-game
• SkillHub 详情页：https://www.skillhub.cn/skills/user_c7d255d2/interesting-guess-game

核心功能¶

以下均来自已安装的 Skill 包内 SKILL.md 与 guess_game.py，可与仓库内容逐项核对。

1. 三档难度：简单（1–50，最多 10 次）、中等（1–100，8 次）、困难（1–200，5 次）。
2. 交互流程：选难度 → 生成随机目标数 → 循环接收猜测 → 提示偏大/偏小 → 猜对或次数用尽后结算，可选择再来一局或退出。
3. 输入校验：仅接受可转为整型的纯数字；非法输入会提示重新输入，不扣次数（ValueError 分支不减少 remain_times）。
4. 计分：猜对时得分累加为 剩余次数 × 10（见 guess_check 实现）。
5. 唤醒词（文档约定）：猜数字、开始小游戏、趣味猜数、启动数字游戏。
6. 对话侧参数（文档表格）：game_level（简单/中等/困难）、user_num（玩家猜测的整数）；由 Agent 按 Skill 说明组织多轮对话，与 CLI 脚本逻辑对应。

运行环境：Python 3.7 及以上。作者字段在 SKILL.md 中记为 jm-jsjkxyjs01-jpn-506。

安装与启用¶

通过 SkillHub CLI 安装¶

先确认本机已有 skillhub（安装方式见 SkillHub 安装文档）。安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落到 ./skills/ 可能不会被识别。

Cursor 常用目录为 ~/.cursor/skills/。社区包需带命名空间：

skillhub install interesting-guess-game --namespace user_c7d255d2 --dir ~/.cursor/skills/

安装成功后，包路径形如 ~/.cursor/skills/@user_c7d255d2/interesting-guess-game/，内含 SKILL.md 与 guess_game.py。

通过提示词让 AI 安装¶

SkillHub 详情页提供的标准提示为：请 Agent 根据 https://skillhub.cn/install/skillhub.md 安装 @user_c7d255d2/interesting-guess-game。不同客户端 skills 目录不同（文档中另列 Claude Code、Codex、Windsurf 等路径）；按你所用环境替换 --dir 即可，逻辑与上一节相同。

安装或更新 Skill 后，按各客户端要求重启或刷新 Agent，以便加载新的 SKILL.md。

典型用法¶

在对话中按 Skill 示范驱动¶

SKILL.md 给出的指令示例：

1. 「开启猜数字游戏」：进入游戏首页，选择难度。
2. 「选择简单难度猜数字」：在 1–50 范围内生成目标数并开始猜测。
3. 「结束游戏」：终止对局并展示本局得分。

Agent 加载该 Skill 后，可用上述自然语言或唤醒词触发，由模型按文档中的运行逻辑引导选难度、收数字、反馈大小。

本地直接运行 Python 脚本¶

不经过 Agent 时，可在 Skill 目录下执行附带的脚本验证规则：

cd ~/.cursor/skills/@user_c7d255d2/interesting-guess-game
python3 guess_game.py

终端中会提示用 1/2/3 选难度，随后循环 input 读入猜测，输出与 SKILL.md 内嵌代码一致。

适用场景与注意¶

适合谁

• 需要一份最小可用的 content-creation 类 Skill 样例，学习 SKILL.md 结构、唤醒词与参数表写法。
• 想在无 API 依赖的前提下，演示 Agent 如何配合本地 Python 完成多轮交互。
• 做教学内容或休闲小玩法时的起点，再自行改区间、次数或计分公式。

限制与注意

1. 游戏核心是终端 input/print，适合本机交互；在纯无 stdin 的自动化环境里需改成交互方式，文档未提供额外适配。
2. 难度与区间写死在 level_info 字典中，调整规则需改 guess_game.py 或同步更新 SKILL.md。
3. 分类为内容创作而非生产工具链，不要指望其提供业务 API 或数据处理能力。
4. 商店统计中的「安装」计数可能与本地 --dir 安装不同步，以你本机 skills 目录是否出现 @user_c7d255d2/interesting-guess-game 为准。

结尾¶

interesting- 把猜数字小游戏写成标准 Skill 包：文档说明触发词与流程，脚本实现三档难度与计分，且无需 API Key。若你要在 Agent 里试装一个轻量社区 Skill，可按命名空间安装到对应 skills 目录，从「开启猜数字游戏」开始体验。

官方地址：https://www.skillhub.cn/skills/user_c7d255d2/interesting-guess-game