# 拆slack-gif-creator：被低估的气氛件——官方最小件的开箱翻案报告 ## 概述 本期是本栏单件深拆第 2 轮。本周货架两头都很吵：新星榜被 Jev 系刷屏，browser-use/jev-ultrafast 一周 9729 星；HN 首页挂着「AI-generated posters don't have to be horrible」，1542 分吵的是 AI 审美。而本期偏偏去开全场最安静的一只箱子——三天前软四件黑箱首评里垫底的 slack-gif-creator（3.00 分）。开箱结论先行：**黑箱给低了，开箱 3.83 分**。涨的不只是分：这份只有两百来行的 SKILL.md，是官方示例包里把「规格、工具、知识、门禁、契约」五层货排得最整齐的一份写法课，读完就能照着写自己的第一个 Skill。 ## 先对账：这件是怎么轮到开箱的 9 月 18 日的《拆完硬四件：官方软四件首评》把 doc-coauthoring、internal-comms、brand-guidelines、slack-gif-creator 四张门牌全部黑箱开分，slack-gif-creator 拿了 3.00 垫底，功能与实战两项都带着「正文未读取」的※。那篇文末留了一句承诺：「只装一件的，等开箱报告再定」。本期就是来兑这句话的——四件里，doc-coauthoring 已有专文拆解，brand-guidelines 在 9 月 12 日视觉四件横评里被逐段实读过，internal-comms 与 slack-gif-creator 的正文至今没人读过。选后者，一是它垫底、翻案价值最大，二是它刚好是软四件里唯一带可执行脚本的件，能对「Skill 到底该多重」这个争了一整月的问题补一个官方样本。 ## 评测对比表：黑箱 3.00 → 开箱 3.83 权重沿用本栏惯例：功能 25%、设计 25%、实战 20%、上手 15%、社区 15%。 | 维度（权重） | 09-18 黑箱 | 今日开箱 | 开箱判词 | |---|:---:|:---:|---| | 功能完整度 | ★★※ | ★★★☆ | 机检函数、七式缓动、三档压缩，边界内齐活 | | 设计质量 | ★★★ | ★★★★ | 五层货一次排开，官方件的第三种写法 | | 实战效果 | ★★※ | ★★★ | 三条依赖装完即跑，但工位本身低频 | | 上手难度 | ★★★★★ | ★★★★★ | 正文验证了门牌承诺：抄主路代码就能出片 | | 社区活跃度 | ★★★★ | ★★★★ | 官方包随插件分发，无独立量级统计※ | | **加权** | **3.00** | **3.83** | **+0.83，软四件黑箱分静态对比即登顶** | ## 开箱：一张 SKILL.md 的五层货 ### 第一层：规格前置——把平台的硬数字放在正文第一节 正文开头一句定位：「A toolkit providing utilities and knowledge for creating animated GIFs optimized for Slack」——工具箱，不是模板库。紧接着第一节不是教程、不是安装，而是 Slack 的硬性规格：表情 GIF 128×128（消息 GIF 480×480）、帧率 10-30、色数 48-128、「表情 GIF 请压在三秒以内」。**把验收数字放在所有人要读的第一屏，等于给后面每一行代码预先画好了边界**。对照社区件常见的写法——约束藏在文末「注意事项」里等模型自己撞上——这一节的排位就是设计功力。很多翻车件缺的不是能力，是第一屏没有那四个数字。 ### 第二层：一条主路——四步核心工作流 规格之后是全篇唯一的「主路」代码块：建 GIFBuilder、循环画帧、add_frame、save 时带上 `num_colors=48, optimize_for_emoji=True`。四步，复制即可跑，成品直接就是压过缩的合规文件。注意它把压缩参数焊死在主路的最后一步——默认交付物就是优化过的，而不是先给个臃肿版本再等用户投诉。主路代码化是官方件反复出现的写法，这件的版本最短，短到没有一句废话。 ### 第三层：审美课藏在工具箱里 黑箱时代最大的疑问是：一个做动图的件，凭什么是「Skill」而不是「脚本」？开箱后答案在「Making Graphics Look Good」一节。它用命令句教学：「线条一律 width=2 起步，细线看起来又碎又业余」（原文：Thin lines (width=1) look choppy and amateurish）；星要加半透明的大号残影当辉光；浅色形状配深描边、深色形状配浅描边；心形和雪花这类复杂形，要算好对称点再下笔。这一节和 canvas-design 的「原则课」是同一种东西的浓缩版——**只有十几行，但每一行都是可判定的审美规则，不是「注意美感」这类空话**。9 月 18 日黑箱时担心「弱模型上原则课不如直接喂禁令」，开箱后发现这件根本没赌模型的审美水位，它把审美拆成了参数默认值。 ### 第四层：八组动效配方，给原理不给模板 「Animation Concepts」一节给了八组配方：抖动、脉冲（含心跳变体）、弹跳、旋转、淡入淡出、滑入、缩放、粒子爆裂。关键在于给法——每组配方给的是数学原理而不是整段可抄代码：抖动用 sin/cos 加微小随机扰动，心跳是「两快一停」的调频正弦，弹跳下落用 ease_in 落地换 bounce_out 且每帧重力累加，粒子要随机角度初速加 alpha 衰减。这就是它「Philosophy」一节自己声明的立场：提供知识、工具和自由，**不提供刚性模板**。给原理的配方能迁移到任何画布，给模板的配方只能复刻作者见过的三种玩法——这是本栏目前见过的、对「模板 vs 知识」这对矛盾最干净的一次表态。 ### 第五层：门禁与契约——按需优化、三给三不给 最后两块是别的官方件里少见的东西。其一，优化门禁：正文写死「Only when asked to make the file size smaller」——八档压缩手段（降帧、降色、缩尺寸、去重复帧、表情模式）只在用户开口时才启用，防止模型好心办坏事，默认就把成品压糊。**在 SKILL.md 里写「什么时候不要做」，比写「要做什么」稀缺得多**。其二，边界契约：Philosophy 一节明码标价「三给」（知识、工具、灵活度）「三不给」（刚性模板、emoji 字体渲染、预制图形库）。「不给 emoji 字体」还附了理由——跨平台渲染不可靠；「别假设本件内置现成图形」这句禁令在正文里出现了两次，这是在防模型幻觉出根本不存在的素材库。给能力划包络、给幻觉堵入口，两百行里干成了。 ## 三种质检流派：机检、二刷、路由 开箱最有意思的对照，是质检关的做法。canvas-design 的 FINAL STEP 预埋「用户已经说了不够完美」，用既成事实感逼模型强制二刷——那是**自省派**，靠提示词心理学生效。web-artifacts-builder 把初始化整段外包给配套脚本——那是**施工队派**，正文只当调度员。slack-gif-creator 是第三派：**机检派**。core.validators 直接给出 validate_gif 和 is_slack_ready 两个函数，尺寸、时长、色数是否合规，跑一下就有布尔答案，不达标就回炉重画。审美靠参数默认值兜底，合规靠函数兜底，全程没有一个「请仔细检查」式的软指令。三派没有高下，但机检派是其中唯一**不依赖模型自觉**的一派——对一个高频、低风险、规格明确的产物类型，这可能是性价比最高的写法。 顺带修正一个流传中的简化说法。「薄正文、重脚本」通常被拿来形容官方件把重活外包，但这件的结构其实更进一步的：正文本身就是文档，core 包（gif_builder、validators、easing、frame_composer 四个模块）只暴露 API，全篇没有引用任何外挂 reference 文档。官方大件的渐进披露靠外挂子文档分摊上下文，这件给出了另一种解——**正文短到不需要披露**。canvas-design 要配 canvas-fonts 字体目录，动辄几百行；这件两百行封顶，装机即全文常驻。 ## 触发与边界：名字锁平台，正文只锁十行 9 月 18 日的门牌分析说它「全场唯一把平台名写进门牌」，判词是「生态位锁死，不用的团队一文不值」※。开箱后这个判断要修正一半：Slack 专属的东西，其实只有第一节的规格表和 save 里的 optimize_for_emoji 开关，满打满算十来行；其余九成——缓动、粒子、重力、alpha 混合——是任何 GIF 任务通用的知识。**锁死发生在路由层（名字和 description 决定谁来接活），不在能力层（接到活之后干的是通用活）**。这给写 Skill 的人一个重要启示：用名字锁定细分流量不亏，只要正文的知识层保持通用，这件 Skill 就不会真的被平台绑死——哪天要给微信群做动图，改十行就能出门。 另一个值得一记的细节是上传图的双分支：用户丢进一张图时，正文要求先判断意图——「直接用」（例句：animate this）还是「当参考」（例句：make something like this）。一个分支一句例句，把最常见的输入歧义在正文里路由掉了。小件见功力，往往就在这种一句半句的地方。 ## 想写自己的第一个 Skill？抄走这八刀 1. **规格前置**：把产物的硬性验收数字放正文第一节，别藏在文末。 2. **主路代码化**：全篇只留一条复制即可跑的黄金路径，压缩参数焊死在最后一步。 3. **禁令带理由**：Don't use 清单每条附原因（「跨平台不可靠」），带理由的禁令才防得住聪明的模型绕路。 4. **机检代替自觉**：能写成函数的质量关，绝不写成「请仔细检查」。 5. **按需门禁**：优化、压缩、重试这类有副作用的动作，写明「仅在用户要求时」。 6. **边界契约**：开一节「三给三不给」，给能力划包络，同时点名封死最容易幻觉的假设（「别假设内置素材存在」）。 7. **配方书模式**：给数学原理和可组合的效果名，不给整段模板——知识可迁移，模板只能复刻。 8. **意图双分支**：对含歧义的输入（上传图、模糊指令），给两个分支各配一句用户例句。 ## 适用与不适用 **适用**：给群聊、社区、产品发布做庆祝动图和表情包；教学场景——它是全货架最好的「第一个 Skill」拆解标本；想给自有平台做动图产线的团队，把规格表换掉即可复用整套骨架。 **不适用**：需要复杂插画、真人素材、音视频合成的动效（它只有 PIL 原语，正文明确不做预制图形库）；对帧率流畅度有影视级要求的场景（表情 GIF 三秒上限）；不写 Python 的纯无代码用户——这件 presuppose 你愿意让它跑脚本。 ## 安装与使用 ```bash # example-skills 插件包在册即用，无需另装 # 手动取用（目录层级以仓库实际为准）： git clone --depth 1 https://github.com/anthropics/skills # 定位 skills/slack-gif-creator，整目录拷入 ~/.claude/skills/ 后重启会话 # 依赖（正文尾注原文）： pip install pillow imageio numpy ``` 触发示例※：装好后直接说「做一个庆祝上线的表情 GIF」即可命中；出片后可用包内 validate_gif 自查是否达到 Slack 规格。 ## 一图看懂 ```mermaid mindmap root((SKILL五层货)) 平台规格层 尺寸帧率色数 表情限三秒 主路层 四步黄金路径 工具层core包 GIFBuilder validators机检 easing七式 frame_composer 知识层 八组动效配方 审美参数细则 门禁契约层 按需优化 三给三不给 ``` ```mermaid flowchart TD U["用户来一句要张动图"] --> T["触发slack-gif-creator"] T --> S["读平台规格"] T --> K["读动效配方"] S --> C["写Python用PIL逐帧画图"] K --> C C --> A["GIFBuilder收帧"] A --> V["validate_gif机检"] V -->|不达标| C V -->|达标| B["save导出并压缩"] B --> O["交付表情或消息GIF"] ``` ## 推荐排行榜 - **上手最快榜**（软四件内）：slack-gif-creator ＞ internal-comms ＞ doc-coauthoring ＞ brand-guidelines。三条依赖一条命令，主路代码复制即跑。 - **写法课含金量榜**（官方已拆七件内）：skill-creator ＞ slack-gif-creator ＞ canvas-design ＞ webapp-testing。想学「怎么写」读第一件，想学「怎么写短」读这一件。 - **质检流派可靠性榜**：机检派（本件）＞ 施工队派（web-artifacts-builder）＞ 自省派（canvas-design）。不依赖模型自觉的关，才是真关。 - **软四件综合重排**（其余三件沿用 09-18 黑箱分静态对比）：slack-gif-creator 3.83 ＞ doc-coauthoring 3.80※ ＞ brand-guidelines 3.40 ＞ internal-comms 3.30。开箱十分钟，垫底变榜首——黑箱分的误差，可以有一个身位这么大。 ## 结语 这件 Skill 的示范意义，9 月 18 日黑箱时只猜对了一半：它确实是「Skill 能做得多轻」的边界展品，但轻不等于薄——两百行里排进了规格、主路、审美、知识、门禁、契约六样货，每样都有明确职能。货架越吵的周，越值得回头开一只安静的箱子：Jev 系新星一周九千星的狂欢里，真正教你怎么写 Skill 的，可能就是这张被压在软四件榜尾的萌物门牌。 ## 参考来源 > [!tip] 51学通信知识星球 > **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 > **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 > **当前规模**：5200 篇主题 / 990 个回答，198 元/年。 > **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 > **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。