Sticker Pack Forge — Development skill for Claude Code

sticker-pack-forge · 表情包工坊

[中文](README.md) | [English](README_EN.md)

一张人物参考图 → 一整套能在微信 / QQ / iMessage / Telegram 直接用的表情包。

透明九宫格母版 → 9 张独立透明素材 → 9 条循环透明 GIF → 平台规格打包 → 可选桌面宠物。

  

为什么要做成 skill

单独跑一次不难，但每换一套人物都要重走：生成母版 → 找真实格缝切图 → 铺色幕 → 做动作 → 逐帧抠像 → 压体积 → 打包。 重复劳动多，而且中间几步（切图、抠像、GIF 透明）**特别容易静默出错** —— 图看起来没问题，实际边缘有白边、颜色被刷掉、GIF 只写出 2 帧。

这个 skill 把确定性部分全部本地化，并给每一步配了质检： 出错会在报告里点名，不会交给你一包"不知道哪里坏了"的文件。

快速开始

# 0. 环境自检（不消耗任何生成额度）
python scripts/run_selftest.py --workdir ./_selftest

# 1. 切分母版（母版用 references/prompts.md 第 2 节的生产版提示词生成）
python scripts/slice_grid.py --input 01_sheet/sheet.png --outdir 02_cells \
    --labels "无语,哭,震惊,得意,白眼,问号,比心,冲,笑"

# 2. 本地动效（默认路线）
python scripts/animate.py --input 02_cells --outdir 03_gifs \
    --fps 12 --duration 1.0 --size 240

# 3. 平台适配 + 打包
python scripts/pack.py --cells 02_cells --gifs 03_gifs \
    --outdir 04_pack --platform wechat --zip

视频路线（效果更自然）见 `SKILL.md` 阶段 4 的路线 B。

安装（给「另外的 AI」/ GitHub）

仓库根目录 **就是 skill 本体**，clone 或复制整个文件夹即可。

从 GitHub 克隆

git clone https://github.com/gaoren7716-lab/sticker-pack-forge.git

WorkBuddy / CodeBuddy

cp -r sticker-pack-forge ~/.workbuddy/skills/sticker-pack-forge

Claude Code / Claude 系

cp -r sticker-pack-forge ~/.claude/skills/sticker-pack-forge   # 用户级
# 项目级（可随仓库提交给团队）：
mkdir -p .claude/skills && cp -r sticker-pack-forge .claude/skills/sticker-pack-forge

其它支持 Skill 的 Agent

把整个文件夹复制到该 Agent 的 `skills/` 目录（用户级或项目级）即可。

英文说明见 [README_EN.md](README_EN.md)。

依赖

• Pillow（必需，≥ 10）
• numpy（可选，抠像快一到两个数量级）
• ffmpeg + ffprobe（仅视频路线需要；静态和本地动效不需要）

本机可用环境（示例，换机器请替换成你自己的 venv）：`C:\Users\<用户名>\.workbuddy\tools\imgtool-venv`（作者机器为 Pillow 12.3 + numpy 2.5）。

自检覆盖

`run_selftest.py` 共 44 项断言，全部本地完成、不消耗