Loading
Develop or update reusable visual components for iPolloWork Video, including maps, charts, rankings, diagrams, openings and endings. Use for component authoring rules, manifests, editable variables, s
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add Devin-AXIS/iPolloWork --skill ipollowork-video-component-authoring -a cursor -y
Develop or update reusable visual components for iPolloWork Video, including maps, charts, rankings, diagrams, openings and endings. Use for component authoring rules, manifests, editable variables, shared data forms, inherited design themes, AI editing slots and seekable HyperFrames timelines. Not for producing a whole video, authoring a full-project template, or packaging a DeepSeek host plugin.
Develop or update reusable visual components for iPolloWork Video, including maps, charts, rankings, diagrams, openings and endings. Use for component authoring rules, manifests, editable variables, shared data forms, inherited design themes, AI editing slots and seekable HyperFrames timelines. Not for producing a whole video, authoring a full-project template, or packaging a DeepSeek host plugin.
交付的是能放进视频、通过共用表单调整、跟随项目主题、可由 AI 加工的组件。不要为一个组件另做编辑器、参数面板、渲染器或宿主插件。
在 iPolloWork 仓库根目录阅读 AGENTS.md 和维护性规范。先找同类组件，再选择扩展还是新增。以下路径均相对仓库根目录：
vendor/hyperframes/registry/blocks/world-map/：地图、主题继承、结构化数据的参考。vendor/hyperframes/registry/blocks/media-hero/：可编辑内容与动画配方的参考。vendor/hyperframes/packages/core/src/registry/types.ts：组件分类及 manifest 契约。vendor/hyperframes/packages/core/src/registry/componentData.ts：共用数据结构及解析规则。vendor/hyperframes/packages/core/schemas/registry-item.json、packages/types/src/hyperframes.ts：注册项和宿主校验契约。vendor/hyperframes/packages/studio/src/utils/blockInstaller.ts：真实安装、主题与变量接入方式。不要复制这些 schema 或创建另一套数据协议。规范与代码不一致时，先核对当前消费者，不用旧示例猜测接口。
通常只需在 vendor/hyperframes/registry/blocks/<slug>/ 放置：
registry-item.json # 元信息、变量、分类、文件和能力声明
<slug>.html # 画面与动画
确有需要再加本地图片、字体、数据或预览文件；安装所需文件必须在 files 中声明，路径保持包内相对路径。注册到现有 vendor/hyperframes/registry/registry.json，不另建组件目录服务。
产品里统称“组件”，但底层类型要准确：有独立画布和时长的地图、排行榜等通常是 hyperframes:block；注入已有画面的片段才是 hyperframes:component。完整项目模板属于另一种交付，不混用。
variables 声明稳定的 id、可理解的 label、类型及默认值，与 HTML 的 data-composition-variables 保持一致。string / number / color / boolean / enum 类型；数字给合理范围，枚举给选项，长文本给长度约束。不要擅自增加对象类型。update: live 仅用于能即时更新的参数；改变结构或动画时按现有机制使用 rebuild / reload，声明必须与实际行为一致。motionCueTimes、motionStyle 等系统控制字段不当作普通用户参数。地图、路线、图表、排行榜等数据组件使用 visualComponent.data，声明列、语义、行标识、行数限制和绑定。沿用已有 category-value / region-value / point-value / route-value / series-value，选择真正匹配数据的类型。
AI 面向的标准数据是：
{
"version": 1,
"kind": "region-value",
"rows": [
{ "region": "China", "value": 96 },
{ "region": "Japan", "value": 77 }
]
}
列名由该组件的 columns 决定，不是所有组件固定使用 region。rowId 稳定且唯一，数字保持数字类型；单位、精度、高亮和替换/覆盖语义按现有契约声明。
binding.variable 必须对应真实变量。底层可以使用已有 json / key-value-list / route-value-list / label-detail-list 编码，但由共用适配层转换；不要求用户手写逗号、冒号等字符串。不要另设一份互不同步的 JSON 状态。非法数据给明确提示，不静默丢行或生成虚构数值。
visualComponent.version: 1、themeMode: inherit，按能力填写 surfaces；首选 video，未验证前不要声称支持 PPT 或网页。VISUAL_COMPONENT_CATEGORIES，例如地图 maps、数据 data、架构/金字塔 diagrams。开头、结尾还可用已有 librarySection 定位；不要另造一套分类树。--ipw-color-bg、--ipw-color-surface、--ipw-color-text、--ipw-color-primary、--ipw-color-border、--ipw-font-display、--ipw-font-body、--ipw-card-radius。window.__timelines[compositionId] 的暂停 GSAP 时间线，由 HyperFrames 控制播放、暂停与 seek。motionRecipe。需要让 AI 按旁白调用动画配方时，才沿用已支持的配方契约；事件、cue 绑定和实际元素一致，容量与文字限制有真实依据，不伪造配音时间。用 visualComponent.ai.slots 声明稳定的可编辑区域，并在 HTML 对应位置添加 data-ipw-ai-slot。instructions 简要说明用途、输入规则和需要保留的结构。
支持 AI 替换内容、调整布局、缩小地图并在旁边加说明等局部加工；保持变量 ID、数据绑定、主题继承及时间线接入不变。不强制所有加工都变成表单参数，也不为 AI 再维护一份画面。
外部文字按文本处理，不拼入可执行 HTML；不执行输入数据中的脚本，不嵌入密钥。引用地图、字体、图片等资源保留来源和授权，缺少素材时明确说明，不暗中联网替换。
本规范只指导组件开发。发布 npm、修改宿主插件、提交 PR 或上传组件市场需按用户授权及现有发布流程另行处理。