ClaudeMap

spine-hero

从一张原画让 2D 游戏角色动起来的 agent skill:部件拆上 Spine 骨骼、每个动作写成代码、脚本门禁加独立缺陷检查、最后由人拍板

技能与命令skillanimationspinegame developmentmulti-model

spine-hero 是一个面向 Claude Code、Codex 与 Cursor 的 agent skill,把一张原画变成绑好骨骼、可做动作的角色。原画拆件上 Spine 骨骼;每个动作都写成该骨架上的关键帧与 IK——从不逐帧制作——因此换装后所有动作照常可用。orchestrator 为每个动作写简报并并行开工;图生视频模型只为原画生成时序参考(永不描摹、不作帧使用);图像模型补画原画没画到的部分(被遮挡的部件、可换装的装备、快速打击的关键姿势);强编码模型逐个写动作、截图并自查结果。质量由两层把关:脚本门禁只测量数字(滑步、地面速度、裂缝、未回到静止、画出角色框外)——「没有模型来判断数字」;另一个独立模型按「人类抓到过的所有缺陷」清单检查 2 倍特写。最终由人拍板,你抓到的每个缺陷都会变成缺陷清单或门禁的新条目。各角色按层级文档化(orchestrator、author、gate、review、check、video、image、human),模型名只是示例、不是要求。

它做什么

  • 一张原画进、绑骨角色出:部件拆上 Spine 骨骼,动作写成关键帧与 IK 代码——从不逐帧
  • 脚本门禁测量每次捕获:滑步、地面速度、裂缝、是否回到静止、是否画出角色框外;没有模型来判断数字
  • 独立模型对照不断增长的缺陷清单检查脚部与头部 2 倍特写(示例流程含 13 条历史缺陷)
  • 参考视频只给时序与节拍;图像模型补画被遮挡部件、可换装备与关键姿势
  • 角色按层级划分——orchestrator、author、gate、review、check、video、image、human——模型名仅为示例、不是要求

什么时候用

适合让一个游戏角色从一张原画长出整套动作——行走、攻击、嘲讽——并要求换装后动作照常可用;机械门禁接住模型看不见的问题(滑步、裂缝),你的眼睛再为下一轮补充缺陷清单。

如何上手

skill 位于仓库的 skills/spine-hero/(SKILL.md 及参考文档:pipeline、rig、locomotion、moves、reference-video、orchestration、defects、gate)。先用自带示例试跑门禁:

node --test skills/spine-hero/scripts/gate.test.mjs
cp skills/spine-hero/assets/metrics.example.json /tmp/metrics.json
node skills/spine-hero/scripts/gate.mjs /tmp/metrics.json       # PASS example-hero walk: 8/8 checks

安装(Claude Code 插件):

/plugin marketplace add enoch3712/spine-hero-skill
/plugin install spine-hero@spine-hero-skill

然后让 agent 使用该 skill 并规划动作,按 reference-video.md 的模板提供参考视频。

注意事项

README 自述的边界:它只在一个游戏上打造过(侧视手绘角色、web 运行时、Spine 4.2),未在其他引擎或画风上试过。绑骨与捕获要你自己写——占大部分准备工作;仓库自带的脚本只有门禁(含测试)与一个小锁助手。门禁的像素阈值按单一捕获尺寸校准,gate.md 说明了哪些阈值可迁移。Codex 与 Cursor 的插件安装路线未测试。使用消耗模型 token,视频与图像模型可能产生费用。撰稿时 41 星(2026-11-14)。

代码仓库

enoch3712/spine-hero-skill

收录日期

地图上的相关资源

  • SureForge

    技能

    纯指令式 skill:让 agent 先调研再提问、先规划再动手、先验证再说「做完了」。

    • workflow
    • verification
    • quality
    • skill
  • 归藏的 Agent Skill:把代码库的最近更新做成一支成片宣传片——接真实组件、代码渲染动画、代码写配乐,全程不碰视频剪辑软件。

    • agent-skill
    • video
    • promo
    • marketing
  • 一个给「图里没有任何文字线索」的照片做地理定位的 Agent Skill——用 OSM 几何、高程天际线与卫星瓦片,把「这是哪」变成带误差半径的测量答案。

    • agent-skill
    • geolocation
    • osint
    • openstreetmap