Back to search
stable-sprite-animation
SkillWorks with Claude CodeGitHub
根据角色参考图、动作提示词和帧数,生成透明 PNG 动画序列和 GIF。适用于像素角色、物品与环境素材的 2D 精灵动画,重点保持固定部位像素一致、避免循环收尾跳变。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/charolettebradford1361985svo-bit--stable-sprite-animation)HTML
<a href="/listings/charolettebradford1361985svo-bit--stable-sprite-animation"><img src="/api/listings/charolettebradford1361985svo-bit--stable-sprite-animation/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 58 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: stable-sprite-animation
- description: 根据角色参考图、动作提示词和帧数,生成透明 PNG 动画序列和 GIF。适用于像素角色、物品与环境素材的 2D 精灵动画,重点保持固定部位像素一致、避免循环收尾跳变。
- metadata:
- version: "0.3.7"
- ---
- # Stable Sprite Animation
- 把角色图制作成指定动作的连续帧。用户只需提供 **图片、动作、帧数**;agent 负责选方法、部件、锚点和节奏。先判断能否直接动画化原图部件,不默认把所有动作交给生图模型安排帧序。
- ## 能力与依赖
- - Python 3.10+;依赖见 `requirements.txt`。优先使用已有兼容环境,缺失时在独立虚拟环境安装。
- - 原图部件完整的短步走路、小幅跑步和原地小跳可以只用本地脚本完成。需要新造型、缺失部件或整组生图时,才需要参考图编辑工具;若有 `imagegen`,遵循其规则。本包没有网络请求、密钥或模型权重,外部生成遵守所在环境的工具规则和费用授权。
- - 输入须有真实透明通道。普通照片/JPG/实底图先通过可用的抠图能力处理并检查角色轮廓,保留原始文件;不要把不透明背景一并锁进动画。
- ## 先识别对象与动作
- 先区分 **角色** 和 **物品/环境物**,再按实际结构与动作选择参考。读取 [对象分类与制作参考](references/object-routing.md),只读取匹配类型的制作文档;不要一次加载全部案例。分类不是固定模板:短腿角色走路看腿型,打哈欠看吻部,下属物件如手提包可组合物品规则。未知结构保留未分类状态,不修改原图去迎合案例。
- ## 选择制作方法
- 下列部件路径主要针对角色;旗布等物品先按对象分类页选择固定支架与可变区域,不套腿部脚本。
- 先按可见腿长、膝部是否可辨、视角、遮挡和最终显示尺寸选择步态表现,见 [步态表现选择](references/gait-readability.md)。长腿通常需要清楚的前后换腿与经过位;短粗腿可以弱化交叉,用短步与承重节奏表达走路,不为强调交替而拉长或压细原腿。
- - **斜侧视角、裸露膝部的走路:** 当整腿剪贴呈开合跳、生成腿图身份不连续,或前摆手臂被身体盖住时,读取 [斜侧角色走路](references/three-quarter-walk.md)。以固定近远腿身份、脚轨迹、受控膝弯和正确前后遮挡制作局部脚本;这是制作参考,不是现有 CLI 的新模式。保留已认可的腿轨迹,单独修鞋视角或手臂。
- - **保持原腿型的短步走路:优先复用原图整条腿和鞋。** 适用于双腿可分离、朝向不变、动作幅度不大的像素角色。用脚步轨迹决定左右脚交替,保留各自的轮廓;不把短粗腿拆成细长的两段骨骼再拉伸。读取 [原图部件走路](references/cutout-walk.md),执行 `scripts/cutout_walk.py`。其他角色必须重新选部件和坐标,不能套鳄鱼参数。
- - **短腿跑步:保留原脚块,安排前后换腿、短支撑和腾空。** 读取 [短腿跑步](references/cutout-run.md)。极小脚块优先整数平移,结合受控身体起伏和反向屈肘摆臂。现有走路脚本要求至少一脚支撑,不能直接用于有腾空的跑步;由 agent 按参考制作局部渲染脚本。
- - **保持原腿型的原地小跳:整腿整数平移,身体蓄力与缓冲。** 适用于朝向不变、能分离双腿、衣身与腿根有重叠的角色。地面阶段脚底保持原位置,用身体小幅下沉表现蓄力与落地缓冲;腾空按时间采样抛物线。读取 [原图部件跳跃](references/cutout-jump.md),执行 `scripts/cutout_jump.py`。它不负责深蹲、屈膝抱腿或翻转等新轮廓。
- - **小尺寸角色张嘴、打哈欠:** 需要新下颌或口腔结构且整组生图改变身份时,读取 [动作参考与原生网格重画](references/native-grid-redraw.md)。先生成关键姿势参考,再按原图网格逐帧重画局部;不要把放大预览的像素当作新的绘制精度。用户指定 Aseprite 时使用它;本包不附带该软件或通用张嘴渲染器。
- - **需要新造型或新可见内容:使用参考图生图。** 如张嘴露出牙齿、喷嚏特效、转身,或原图遮挡严重而缺少完整部件。读取 [整组生图流程](references/generated-sequence.md)。头身对齐正确不代表腿的步相正确;如果模型反复生成同一脚踢出,应该换成可控部件运动或补齐素材,不以更多提示词代替动作控制。
- - 各条路径都要检查原图的手提包、衣服、尾巴等身份细节。用户要求保留原腿型时,不擅自改成长腿、镜像鞋子或换掉鞋型。用户明确要求修鞋的视角时,可制作符合该视角的固定鞋素材,但不逐帧翻转、拉伸来假装交替。部件复用也不自动适合大跨步、深蹲、转身或空中翻转;缺少素材时不能凭复制脚部伪造这些动作。
- - **提包手需要运动时:** 读取 [提包手臂与遮挡](references/carrying-arm.md)。把袖管、手和包分层;手与包保持同一位移,单独处理附近尾巴和原位置露出的衣身。
- ## 共用约束与验收
- - **拆层补底、发束摆动或完整性问题:** 读取 [身体补全与次级运动](references/integrity-and-secondary-motion.md)。被移走部件后方应有完整底层;同时检查封闭透明洞、与背景相通的轮廓缺口和关节连接。头发按固定发根的完整发束处理,不能以少数边缘像素抖动冒充飘动。
- - **固定部位的含义要准确。** 绝对静止的区域直接复用 RGBA。若动作允许整个人物起伏或腾空,只能按明确的整数位移移动整层,并在身体局部坐标中验证原像素不变;这不能称为画布坐标完全不动。用户要求头身绝对固定时,将身体位移设为全零;若与全身跳跃冲突,先说明冲突再确定动作范围。
- - **连续走路不用静止首尾。** 常规双足步态以左右错开半周期安排支撑与摆动;交替在画面中需要多明显,按上述步态表现选择,不能强迫短腿出现夸张交叉。检查支撑、抬脚、前摆和落地。第 N 帧必须继续迈入第 1 帧,不复制一个静止终点。一个关节运动公式周期正确,也不等于腿型或观感合格。
- - **检查最终合成的形状。** 原脚块未缩放仍可能被衣摆、另一只脚或包遮成细条;对照原图检查可见脚底、腿根和袖口。允许的前景遮挡需单独声明,不能将其混称为身体变形或“所有身体像素完全不变”。
- - **回到静止的动作不能硬换外部底图。** 部件跳跃由同一套部件自然恢复到站姿,首末可以相同并保留停顿;先完成触地、缓冲、回稳。生图路径选本组已恢复的姿势作循环端点。两者都要检查进入、离开连续静止段的真实一步;详见各路径说明。
- - 每次修改并渲染后,重新查看全部帧的联系表、修改部位放大图及 `N-1→N→1→2`,不能沿用上一候选的审阅结论。有播放器时实际播放;遇到疑似缺像素时增加高对比透明底图、覆盖掩码与导出帧核查。检查轮廓、关节连接、道具、遮挡、支撑脚地面和动作语义;不只看首尾 hash、固定区域差异或鞋底高度。
- - 程序报告不能自动升级为视觉通过。记录 `visual-review.json`,写明实际看过什么、是否播放过 GIF、问题帧和结论。没有播放能力时如实记录,保留 `unverified` / `needs_review` 及其原因。
- ## 独立审阅与逐版修订
- 动画制作默认按 [独立审阅与版本交付](references/independent-review.md) 执行:主 agent 制作,具备授权与工具时由一个独立子 agent 只读审阅,主 agent 判断反馈后修改。V01 为初版,默认最多三轮修订(V02~V04),每个新版本重新审阅。提前达标即可停止;保留全部版本,最终编号一起展示和打包。无子 agent 能力时明确降级为自审,不伪称独立审阅;用户明确选择其他流程时优先遵从。
- ## 交付与改进
- - 按用户请求展示各版编号 GIF、提供对应 PNG 与整组 `result.zip`,标出推荐版本、修订原因和剩余问题;推荐版不一定是最后一版。部件路径保留配置与运动记录,生图路径保留提示词和来源顺序。用户只要 GIF 时优先直接展示 GIF。PNG 透明,GIF 默认灰底预览。
- - 如实区分 PNG 帧数、独特画面数、GIF 实存帧数。GIF 可能合并相邻相同画面并保留停留时长,不代表少交了 PNG。
- - 保留运行目录和失败报告,便于后续 agent 复现;新尝试使用新输出目录,不覆盖已批准结果。
- - **局部改进冻结已认可部分。** 以批准的 PNG 序列为基线,编辑前确定包含旧位置、新位置及必要补底的区域;逐帧检查区域外 RGBA 不变。保护区应预先定义,不能从修改后仍相同的像素倒推出“未改变”。只修提包手时,保留已认可的腿轨迹、空手动作、帧数和时长。
- - 优先修可定位的问题:轨迹、裁框、遮挡或比例。不要靠改变原腿型、抖一像素或透明叠化掩盖问题;仍有问题时明确指出,不宣称任意角色都能完美复现。
- - 自测:`python -m unittest discover -s <skill-dir>/tests -v`。配置的更多细节只在需要时读相应参考文件,无需把全部代码加载到上下文。
README.md · README · 84 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Stable Sprite Animation
- [](https://github.com/charolettebradford1361985svo-bit/stable-sprite-animation/actions/workflows/tests.yml)
- [](LICENSE)
- 把角色参考图、动作提示词和帧数,变成透明 PNG 序列和 GIF 的 **Codex / AI agent 技能与 Python 工具**。重点是保留角色部件、控制动作节奏和检查循环衔接。
- An agent skill and local Python tools for reference-preserving sprite animation: intact-limb walks, small jumps, compact run recipes, and alignment of generated sequences.
- ## 支持的流程
- 先读 [对象分类](references/object-routing.md),再按需读取匹配的制作参考;本版暂不附图片示例。角色与物品/环境物分开选择制作方法;分类是参考入口,不是固定动画模板。
- | 流程 | 做法 | 适用范围 |
- |---|---|---|
- | 原腿型走路 | 整条原裤腿和鞋小幅刚性运动,左右错开半周期 | 朝向不变、双腿可分离的小步走路 |
- | 斜侧人形走路参考 | 固定近远腿、脚轨迹、受控膝弯、鞋视角与前后摆臂 | 按角色制作局部脚本;不是走路 CLI 的新模式 |
- | 原腿型跳跃 | 整腿整数平移、浅蹲蓄力、抛物线腾空、落地缓冲 | 原地小跳,衣身与腿根有足够重叠 |
- | 短腿跑步参考 | 原脚块平移、前后换腿、短暂腾空、屈肘和提包摆臂 | 按角色编写局部渲染脚本;不是现有走路 CLI 的模式 |
- | 局部动作重画参考 | 生图提供关键姿势,在原生网格重画眼睑、下颌等局部 | 小尺寸角色张嘴、打哈欠;不是自动张嘴 CLI |
- | 生图序列整理 | 参考图生图后,注册、锁定固定区域并检查循环 | 张嘴、喷嚏、新姿势或其他需要补画的内容 |
- agent 负责判断方法、选择部件裁框与锚点、安排逐帧参数。前两条流程使用本地 Pillow、NumPy、OpenCV;需要补画时使用所在 agent 环境提供的生图能力。本仓库不含模型权重、API 凭据或付费服务。
- ## 安装与使用
- 从 [Releases](https://github.com/charolettebradford1361985svo-bit/stable-sprite-animation/releases) 下载技能 ZIP,把其中完整的 `stable-sprite-animation/` 文件夹放进 Codex 的用户技能目录:
- - Windows:`%USERPROFILE%\.codex\skills\`
- - macOS / Linux:`~/.codex/skills/`
- 也可以克隆本仓库到该目录下的 `stable-sprite-animation` 文件夹。已有同名技能时先保留原版本。其他支持 `SKILL.md` 的 agent 可以直接读取 [技能入口](SKILL.md)。
- 使用 Python 3.10+,在虚拟环境中安装依赖:
- ```text
- python -m pip install -r requirements.txt
- ```
- 在新对话中上传角色图片,然后说:
- > 使用 stable-sprite-animation。让这个角色原地跳跃,12 帧,保持原腿型,起跳和落地自然,给我透明 PNG 序列和 GIF。
- agent 会选择配置并执行脚本。对于已经准备好的配置,可以直接运行:
- ```text
- python scripts/cutout_jump.py --image character.png --config jump.json --out output/jump-01
- python scripts/cutout_walk.py --image character.png --config walk.json --out output/walk-01
- ```
- 输出目录应为新目录或空目录。输出包括 `frames/`、`preview.gif`、图集、配置、运动记录、验证报告和 `result.zip`。PNG 保持透明,GIF 默认灰底。完整安装与使用说明见 [PACKAGE_GUIDE.md](PACKAGE_GUIDE.md)。
- ## 参数与质量边界
- 先读 [步态表现选择](references/gait-readability.md):长腿通常需要清楚的前后换腿,短粗腿可以弱化交叉,靠短步和承重节奏表达;同时考虑视角、遮挡与实际显示尺寸,不改变原腿型来套统一动作。
- - [走路配置](references/cutout-walk.md) · [跳跃配置](references/cutout-jump.md) · [短腿跑步参考](references/cutout-run.md) · [提包手臂](references/carrying-arm.md) · [生图序列流程](references/generated-sequence.md)。按需要读取对应文档即可。
- - [斜侧角色走路](references/three-quarter-walk.md):记录已认可的 12 帧设计、手脚共用节奏、近臂前景遮挡及鞋视角修正;保留“仍有浮动感”的质量边界,不附第三方角色图片。
- - 示例中的鳄鱼裁框对应一张特定的 200×200 原图。仓库未包含该私人角色素材;换图后需要重新确定裁框,不能直接套坐标。
- - 紧凑角色跑步参数对应另一张 32×42 原图,是制作参考而非 CLI 配置。样例坐标、脚宽和 12 帧参数不可作为所有角色的固定规则。
- - 朝向改变、深蹲、明显屈膝、缺失肢体或新可见内容需要额外素材。当前部件脚本不会自动补出这些轮廓。
- - 固定部位可以随身体整体移动,验证在身体局部坐标中进行。“原像素保留”不意味着整个角色永远停在画布的同一位置。
- - 合成站姿仍需检查胯部、袖口和半透明边缘;部件保形、循环公式和首尾一致都不能单独证明动作自然。
- - 跳跃样例有 12 张 PNG、11 个独特画面,首末站稳姿势相同。GIF 还可能合并相邻相同帧,报告会区分这些数量并保留时长。
- 身体露底、局部像素缺失或头发摆动,参阅 [身体补全与逐帧检查](references/integrity-and-secondary-motion.md):覆盖掩码与封闭洞检测互补,检查最终 GIF,并保留已认可动作。不是自动毛发模拟或通用补全模型。
- 小尺寸面部动作参阅 [动作参考与原生网格重画](references/native-grid-redraw.md):保持连贯下颌和原图像素尺度,避免缩放嘴部贴片。本案例动作结构基本认可,粗像素修正尚待实际验证。
- 动画默认采用 [独立审阅与逐版修订](references/independent-review.md):主 agent 制作、子 agent 只读审阅,最多三轮修订(V01 初版至 V04),每版保留并一起交付。无委派能力时明确降级自审,未播放不能声称播放验收;这是 agent 工作流,不是新增 CLI 自动修复功能。
- ## 开发与维护
- ```text
- python -X utf8 -m unittest discover -s tests -v
- ```
- 当前有 30 项测试,使用合成 RGBA 图,检查部件像素、左右脚支撑、腾空轨迹、身体固定区域、循环与导出时长。测试不依赖私人图片或联网生图。GitHub Actions 在提交和 PR 时执行测试。
- 发现问题请提交 [Issue](https://github.com/charolettebradford1361985svo-bit/stable-sprite-animation/issues/new/choose),附可公开使用的最小复现素材、配置和问题帧。贡献流程见 [CONTRIBUTING.md](CONTRIBUTING.md),版本记录见 [CHANGELOG.md](CHANGELOG.md)。
- ## 许可证
- 代码和仓库文档采用 [MIT](LICENSE)。输入图片、第三方素材及外部模型输出的权利由各自来源决定;软件许可证不会转让这些素材的权利。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.