Spinlings Skill 技能

技能简介

Spinlings 是一款运行在 Claude Code 内部的开源生物卡牌游戏插件（mod）。当 Claude 在后台执行任务时，输入框上方会浮现一条细窄竞技场，野生像素生物不时出没，你派出的三只生物自动迎战，胜利后有机会捕获卡牌。每张卡牌独一无二，拥有专属外观、基因与特性，支持融合、交易、决斗与全球排行榜。项目采用 MIT 协议开源，2026 年 10 月初发布，要求 Claude Code 2.1.287 及以上版本。

核心能力

• 野生遭遇战：Claude 主回合运行满 20 秒后，每再过 15 秒有概率触发遭遇（至多每 8 分钟一次），战斗每回合 2.2 秒自动结算，Claude 与战斗互不等待
• 特殊技能打断：战斗中出现 [1] Now! 提示时按 1 键，可打出 1.3 倍威力的 Perfect 攻击，走神不惩罚
• 卡牌获取体系：卡包按 Claude Code 开启时长充能（最多囤 12 包，触顶限流照常充能）、每日首胜与三连胜奖励、决斗掉落、交易赠送、融合孵化、手工合成
• 养成与进化：生物在 4 级和 8 级各进化一次，三阶段造型各异；每个赛季新增 36 个物种（四族各八种 + 一只传说），另有全球唯一的 Mythic 生物
• 单机可玩：无真实玩家时由生成的 Rival 与流浪商人补位，决斗、交易、市场照常运转，开局第一天即可完整体验
• 隐私透明：仅监听会话节奏类钩子，绝不读取提示词、工具调用、文件与路径；/spin privacy 可查看全部外发数据并一键注销账号

安装配置

1. 在 Claude Code 会话中依次执行 /plugin marketplace add 416rehman/spinlings 与 /plugin install spinlings@spinlings
2. 或在终端执行 claude plugin marketplace add 416rehman/spinlings 和 claude plugin install spinlings@spinlings；也可直接对 Claude 说"安装 416rehman/spinlings 里的 Spinlings mod"
3. 确认版本 ≥2.1.287（claude --version 检查、claude update 升级），安装后重启并新开会话；可在 /plugin → Marketplaces 中开启自动更新

使用步骤

1. 新会话输入 /spin 打开面板，四个标签页（队伍 / 收藏 / 发现 / 社区）对应热键 1-4
2. /spin team <a> <b> 设置 1-3 只出战生物，槽位顺序即出手顺序；被替换的生物仍留在收藏中
3. Claude 干活时留意输入框上方的竞技场，特殊技能触发按 1 打出 Perfect；/spin battle 可随时主动约战（至多每 2 分钟一次）
4. /spin pack 预览待开卡包，/spin redeem FIRSTSPIN 领取首发礼包码；/spin trade 发起交易，/spin market 进入市场买卖
5. /spin quiet 一键静音，/spin world offline 切换完全本地存档，/spin version 查看版本与服务器状态

适用场景

• Claude 执行长任务（构建、重构、批量迁移）时的等待间隙消遣，战斗全自动、不打断心流
• 编程工作之余的轻量放松，离线挂机也能开包、合成、整理收藏
• 与同事好友发起友好决斗（/spin duel 不影响天梯分），或通过礼物码邀请新人
• 收藏养成玩法：开包、融合、图鉴收集，冲击每赛季 36 物种的"全球首发现"永久印记

适用人群

日常使用 Claude Code 的开发者、喜爱养成收集类游戏的玩家，以及希望在终端里拥有轻量社交玩法的技术团队。项目完全免费，卡牌无现金价值。

工作原理

插件通过 Claude Code 的 hooks 机制挂载：session.start/end 与分钟级时钟负责卡包充能计时；turn.start/complete 判断 Claude 是否在工作以触发遭遇战；turn.step 读取模型与 effort 决定竞技场样式；ui.render 绘制输入框上方窄带与面板；command.run 只处理 /spin 一条命令。永不钩取 tool.call、prompt.submit、agent.spawn 等敏感事件。卡牌数据由 spinlings.dev 在线服务器同步，也可完全离线本地运行，老版本 mod 有兼容测试兜底。

官方链接

• 项目主页：https://github.com/416rehman/spinlings
• 官网与图鉴：https://spinlings.dev
• 概率公示：https://spinlings.dev/odds