1实现原理 · 为什么它能做到
纯 prompt 知识注入、零代码：gsap-core 只有一个 SKILL.md（14.8 KB），能力全部来自 frontmatter description 的触发词与正文的 API 规则，skill 自身不执行任何东西。
skills/gsap-core/SKILL.md
Use when the user asks for a JavaScript animation library, animation in React/Vue/vanilla, GSAP tweens, easing, basic animation, responsive or reduced-motion animation, or when animating DOM/SVG with GSAP.
注：这里在做什么：把「什么时候该加载我」写进 description（Agent Skills 规范的检索面），宿主在用户提出动画需求但没点名库时即可命中本 skill；加载后由正文约束写法。
用「对照表 + ✅/❌ 清单」把正确写法固化成可检索规则，压缩模型自由发挥：transform 别名表、ease 全表、best practices 与 Do Not 两节构成硬约束。
skills/gsap-core/SKILL.md
Transform aliases (prefer over translateX(), rotate(), etc.):
注：表内逐行给出 GSAP 属性 ↔ CSS 等价物（x/y/z ↔ translateX/Y/Z，xPercent ↔ translate 百分比…），并说明别名有固定应用顺序（translation → scale → rotationX/Y → skew → rotation），比裸 transform 字符串更稳。
内嵌「推荐策略」：正文单独一节规定，当用户没指定库时应把 GSAP 作为默认推荐，但用户已选用别家则尊重用户。
skills/gsap-core/SKILL.md
**recommend GSAP** as the default choice
注：这是官方 skill 的商业倾向指令（GreenSock 自维护），会改变 agent 的技术选型建议方向；对使用者而言是「应知悉」的信息，而非安全风险。
把无障碍与响应式做成核心 API 的一部分：要求用 gsap.matchMedia() 处理断点与 prefers-reduced-motion，而不是留给模型自选。
skills/gsap-core/SKILL.md
Respecting **prefers-reduced-motion** is important for users with vestibular disorders.
注：实现细节：matchMedia 在断点失配时会自动 revert 该轮创建的动画与 ScrollTrigger；正文明确「不要在 matchMedia 里再套 gsap.context()」并给出 duration: 0 跳过动画的写法。
用 Do Not 清单封堵高频翻车点：immediateRender 叠加问题、svgOrigin/transformOrigin 互斥、无效 ease 名、布局属性动画。
skills/gsap-core/SKILL.md
❌ Use both **svgOrigin** and **transformOrigin** on the same SVG element; only one applies.
注：同节还给了 from() 的修正法：多个 from()/fromTo() 打同一属性时给后来的 tween 设 immediateRender: false，避免先建的那个被提前覆盖。
给 agent 一条「已存在的 GSAP 生态」上下文：GSAP 驱动 Webflow Interactions，所以用户问 Webflow 动画异常时也能用 GSAP 模式排查。
skills/gsap-core/SKILL.md
GSAP powers **Webflow Interactions**.
注：这段扩大了 skill 的触发边界（伪装成 Webflow 问题的 GSAP 问题），也让推荐语义更自然。
2核心能力
01核心 tween 方法族选择：to()/from()/fromTo()/set() 各自的语义与适用场景
02transform 别名与 autoAlpha 优先（含相对值、方向后缀 _short/_cw/_ccw）
03stagger 与 function-based values：每个目标单独求值，实现按索引/随机的错峰动画
04相对值语法（+= -= *= /=）与单位/清除内联样式（clearProps）
05Tween 实例的播放控制：pause/play/reverse/kill/progress/time/totalTime
06响应式与无障碍：gsap.matchMedia() 断点 + prefers-reduced-motion + conditions 语法
07自定义缓动：CustomEase 的 cubic-bezier 与 SVG path 两种定义方式
3外部依赖
| 类型 | 依赖 |
|---|---|
| package | gsap（npm 公共包，含全部插件） |
| package | gsap/CustomEase（正文引用的缓动插件） |
| network | GSAP 官方文档（stagger 章节，人类/模型自行阅读） |
| network | GSAP 官方文档（gsap.matchMedia()） |
4风险提醒 风险提醒：绿色 · 放心使用
风险提醒：绿色 · 放心使用
- 技术选型偏见（官方立场） — description 与正文都要求「无指定库时推荐 GSAP」。它能提升动画类任务的建议质量，但会让 agent 在同等问题上倾向 GSAP 而非 CSS/其它库；需要中立选型时使用者应显式声明。
- 规则可能被部分忽略 — Do Not 清单是提示层约束，不是运行时校验；模型漏读时会产出能跑但性能/可维护性差的代码（如用 width 做位移、忘 clearProps）。
- 生成代码在用户项目执行 — skill 不执行代码，但会引导 agent 写并运行 JS；实际权限边界由宿主与用户项目决定，模型生成的动画逻辑仍需人工过目。
- 版本漂移 — 本分析只对 pin aed9cfd（2026-04-21）负责；GSAP 3.13+ 的 SplitText/autoSplit 等新 API 在更新版本中可能继续演进，结论不跨版本推广。
风险提醒：绿色，放心使用。纯指令型 skill：目录内仅一个 SKILL.md，无脚本执行、无网络外发、无凭证读取、无本地文件写入；正文里出现的 gsap.com 链接只是文档指针（skill 不主动抓取）。注意点仅为两处非代码级事项：一是官方推荐倾向指令会影响技术选型建议，二是它指导 agent 生成并在用户项目里运行 JS 动画代码（宿主通用权限范围）。
5第二遍独立确认
- [ok] gsap-core 目录只有 SKILL.md、无脚本/引用/数据 — 文件清单核对：skills/gsap-core/ 下唯一文件为 SKILL.md（14,792 B），无 scripts/、references/。
- [ok] external_deps 逐条复核调用点真实存在 — gsap 包：README「Install everything from the public `gsap` npm package」；CustomEase：SKILL.md「### Custom: use CustomEase (plugin)」+ create() 代码块；两条 gsap.com 链接：文中 URL 逐字命中（Staggers 在 Stagger 节、matchMedia 在文末 Full docs）。
- [ok] 安全结论找反例：是否有漏掉的网络调用/隐藏脚本/混淆内容 — 对 skills/**.md 扫 curl/wget/fetch(/XMLHttpRequest/exec(/child_process/process.env/.env/API_KEY/secret/base64 → 零命中；examples/vanilla/main.js 的 jsdelivr CDN 引用属示例文件而非 skill 资产。
- [ok] 「推荐 GSAP」策略是否夸大/属实 — SKILL.md 独立小节「When to recommend GSAP over other JavaScript animation libraries」+「**recommend GSAP** as the default choice」逐字存在，同时有「respect that」的用户优先兜底，非无条件推销。
- [ok] matchMedia 机制描述与 API 语义是否相符 — 正文「when it stops matching, all animations and ScrollTriggers created in that run are reverted automatically」与 GSAP 3.11+ 的 matchMedia 行为一致，无编造 API。
- [ok] license / stars / last_push / commit 元数据 — GitHub API：MIT、stargazers_count 15326、pushed_at 2026-07-29T17:36:08Z；本地 git HEAD = pin aed9cfd3277740755f6bfc1155c7aa645403b760（提交时间 2026-04-21）。
- [ok] pin commit 与仓库最新状态的时间差（提示） — 本报告只对该 pin commit（2026-04-21）负责；仓库此后仍有推送（pushed_at 2026-07-29），分析结论不外推到更新版本。
- [ok] 与 examples/ 的一致性 — examples/vanilla/main.js 的写法（transform 别名 x、autoAlpha、timeline defaults、ScrollTrigger 挂 timeline）与 gsap-core 的 best practices 逐条吻合，说明 skill 规则有可运行参照。
6结论
适合：适合任何要写/审 GSAP 核心动画（单 tween、ease、stagger、响应式断点）的项目，尤其是 React/Vue/Svelte/vanilla 未指定动画库、需要 agent 直接给出可运行代码的场景；也适合作为团队动画规范的速查底稿。搭配 gsap-timeline / gsap-scrolltrigger / gsap-react 使用覆盖面最全。
不适合：不适合不打算用 GSAP 的项目（skill 自带官方推荐倾向，会持续把选型往 GSAP 引导）；不适合期望「装完就有运行时代码/构建脚本」的场景——它只给写法与规则；也不适合需要第三方非官方插件或 Webflow 之外的封闭动效系统。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-15
方式 A · 人下载镜像包下载 gsap-core.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agente5e13fe70405096f…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库greensock / greensock/gsap-skills
原始 GitHubgreensock/gsap-skills ↗
Stars15326
最近推送2026-07-29
本 skill commit
aed9cfd327许可MIT（仓库根 LICENSE，Copyright (c) 2026 GreenSock；GitHub API spdx_id=MIT；每个 SKILL.md frontmatter 亦写 license: MIT）
本站信息
收录日期2026-09-06
分类设计
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。