dsh-gsap-skills

DeepSeek Harness GSAP 技能插件：把官方 greensock/gsap-skills 的 8 个 GSAP 技能打包成一个宿主级 skill provider。装一个插件，DSH 所有会话的技能目录就直接出现 gsap-* 技能——不再需要手工往 ~/.agents/skills 复制文件，版本随插件走，可分发、可升级。

包含的技能

| 技能 | 用途 | |---|---| | gsap-core | gsap.to()/from()/fromTo()、缓动、duration、stagger、matchMedia() | | gsap-timeline | gsap.timeline()、position 参数、嵌套、playback | | gsap-scrolltrigger | 滚动驱动动画、pinning、scrub | | gsap-plugins | Flip、Draggable、SplitText、ScrollSmoother、CustomEase 等插件 | | gsap-utils | clamp/mapRange/random/snap/toArray/wrap 等工具函数 | | gsap-react | React/Next.js：useGSAP、refs、gsap.context() 清理 | | gsap-frameworks | Vue / Svelte / 其他框架生命周期用法 | | gsap-performance | 性能优化：transform、will-change、layout thrashing |

它是什么、不是什么

• 是 skill 插件：DSH 的技能注册表（ctx.skills）支持插件注册 skill provider。本插件实现了一个零运行时依赖的只读 provider，直接读取包内 skills/ 目录并注册进注册表。
• 不是 Codex 插件，也不是动画运行库——不捆绑 GSAP 的 JS 文件，只是把官方 GSAP 技能文本带给 DSH 的 agent（与 Codex 里装的 8 个技能同源同文）。
• 零依赖：lib/ 只 import Node 内置模块，无 @deepseek-ai/* 运行时依赖。

安装（web profile）

# 1) 装包 + 自动应用 cordis.patch.yml（插入 gsap-skills 插件行）
dsh plugin --profile web add dsh-gsap-skills

# 2) 重启 web profile 生效
dsh --profile web

本机开发/试用（用本地路径 link 安装）：

cd ~/.dsh/profiles/web
pnpm add "dsh-gsap-skills@link:/绝对/路径/dsh-gsap-skills"
# 然后在 package.json 的 dsh.profile.bundles 追加 "dsh-gsap-skills"，重启

其他 profile 把 web 换成对应 profile 名即可。

使用

直接在对话里说要用 GSAP（写动画、补间、时间线、ScrollTrigger、React/Vue 里的 GSAP 等），agent 会按需自动加载对应技能（gsap-core / gsap-timeline / …），就像本机技能一样。

注意（重复技能遮蔽）

如果某台机器曾把技能手工复制到 ~/.agents/skills/gsap-*（或 ~/.claude/skills、项目 .agents/skills），该副本属于离 agent 更近的 scope 层，会遮蔽插件副本。安装本插件后建议删除手工副本：

rm -rf ~/.agents/skills/gsap-core ~/.agents/skills/gsap-timeline \
       ~/.agents/skills/gsap-scrolltrigger ~/.agents/skills/gsap-plugins \
       ~/.agents/skills/gsap-utils ~/.agents/skills/gsap-react \
       ~/.agents/skills/gsap-frameworks ~/.agents/skills/gsap-performance

升级技能内容

技能正文来自上游 greensock/gsap-skills（MIT）。要跟进上游更新：替换 skills/ 下对应 SKILL.md → npm run validate && npm test → 发新版。改动范围会以插件版本为单位发布。

开发

npm test        # node --test 单测（frontmatter 解析 / 扫描 / provider 契约）
npm run validate  # 结构 + 语法 + 8 技能自洽校验
npm pack        # 打包（files 含 skills/）

许可

• 本插件代码：MIT（见 LICENSE）。
• 8 份技能正文：来自 greensock/gsap-skills，MIT（见各 SKILL.md frontmatter）。
• GSAP 本体是 GreenSock 的商标/产品；本包不包含 GSAP 运行库。