用途:为 SVG 动画库的 lib/primitives/ 目录扩展新的可复用原语,覆盖运动(motion)、形状(shapes)和滤镜(filters)三类。技能强调原语一旦发布就会被预设依赖,因此要求一次做对,而不是求快。
主要要求:\n1. 先通读目标分类文件,匹配既有命名(动作用 create<Verb>,静态元素用 create<Noun>)、返回结构(motion 返回 { css, className };shapes 返回原始 SVG 元素字符串;filters 返回 <filter> 元素字符串)、opts 模式(单一 opts = {} 对象并在顶部解构默认值,禁用位置参数)以及 ID 生成方式(motion 使用 uniqueId(prefix) 并在关键帧名中包含 className 以避免冲突;shapes 和 filters 从调用方接收 id)。\n2. 编写函数并加入 module.exports,函数上方附一行 JSDoc 说明其产出及关键参数,不逐项堆砌 @param。\n3. 至少由一个现有预设消费该原语,否则视为未验证的词汇;若本次会话没有预设会使用它,应停止并建议创建 <name>-demo 占位预设。\n4. 运行 npm test,区分全部通过、快照差异(可能是签名或导出顺序变化)和测试报错(导入损坏)三类结果;仅在变更确属有意时才运行 npm run snapshot:update,并在报告中标注受影响的预设。\n5. 更新 docs/lib-api.md(在对应分类下增加 H3 小节,包含描述、opts 表、消费预设及来源行范围)和 CLAUDE.md(在 lib API index 中增加一行条目并递增计数)。\n6. 输出简短报告,包含原语名称、签名、被哪个预设使用、测试结果及文档更新情况。
限制:不得因本技能之外的原因编辑 lib/primitives/*.js;不得添加无消费预设的原语;不得跳过文档更新;不得使用位置参数;不得忘记 module.exports;不得在无明确理由时运行快照更新。若原语不属于 motion、shapes、filters 任一分类,应停止并提议新分类,由调用方决定。