Communitygithub.com

iPolloWork 视频组件开发 (Devín-AXIS/iPolloWork)

iPolloWork Video용 재사용 가능한 시각 컴포넌트(지도, 차트, 순위, 다이어그램, 오프닝/엔딩)를 개발 또는 업데이트합니다. 컴포넌트 작성 규칙, 매니페스트, 편집 가능 변수, 공유 데이터 폼, 상속된 디자인 테마, AI 편집 슬롯 및 탐색 가능한 HyperFrame 타임라인에 사용됩니다. 전체 비디오 제작, 전체 프로젝트 템플릿 작성 또는 DeepSeek 호스트 플러그인 패키징에는 사용되지 않습니다.

iPolloWork)란 무엇인가요?

이 스킬은 iPolloWork Video 플랫폼용 시각 컴포넌트(지도, 차트, 순위표, 다이어그램, 오프닝/엔딩)를 개발하거나 업데이트하는 방법을 가르쳐 줍니다. 개발자는 ‘컴포넌트’라는 개념에 집중하며, 단일 컴포넌트를 위한 별도의 편집기, 파라미터 패널, 렌더러 또는 호스트 플러그인을 만들지 않아야 합니다. 대신, 미리 정의된 공유 데이터 폼과 변수, 상속된 테마 시스템을 활용하여 일관된 사용자 경험을 제공합니다. 주요 목표는 AI가 의미 있는 수정(내용 교체, 레이아웃 조정)을 수행할 수 있도록 컴포넌트를 설계하면서도, 핵심 데이터 바인딩, 테마 상속, 타임라인 통합은 그대로 유지하는 것입니다. 이 스킬에 포함된 SKILL.md 파일은 iPolloWork 코드베이스(`AGENTS.md`, 기존 블록 참조, 타입 정의)의 계약을 준수하고, 최소한의 파일 구조(`registry-item.json`, HTML 템플릿)로 구성하며, 제한된 변수 세트를 노출하고, 표준 데이터 구조(예: `region-value`, `category-value`)를 사용하며, CSS 변수와 GSAP 타임라인을 통해 애니메이션을 구현하는 방법을 상세히 설명합니다. 또한 AI가 수정할 수 있는 슬롯을 선언하고(`data-ipw-ai-slot`), 매니페스트의 `ai.slots`를 통해 이 슬롯을 AI 지원 편집에 연결하는 규칙을 안내합니다. 결과물은 기존 Studio와 호환되어야 하며, 공유 폼과 데이터 테이블을 사용하고, 철저한 테스트(기본, 경계, 다중 인스턴스, 타임라인 동기화)를 통과해야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Devin-AXIS/iPolloWork/tree/HEAD/.codex/skills/ipollowork-video-component-authoring

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

iPolloWork 비디오 컴포넌트 개발 규칙

제공하는 것은 비디오에 배치 가능하고, 공용 폼을 통해 조정 가능하며, 프로젝트 테마를 따르고, AI가 가공할 수 있는 컴포넌트입니다. 컴포넌트 하나를 위해 별도의 편집기, 파라미터 패널, 렌더러 또는 호스트 플러그인을 만들지 마십시오.

1. 시작 전: 현재 코드 계약을 기준으로 하십시오

iPolloWork 저장소 루트에서 AGENTS.md와 유지보수 규칙을 읽으십시오. 먼저 유사한 컴포넌트를 찾은 다음 확장할지 새로 생성할지 선택하십시오. 다음 경로는 모두 저장소 루트를 기준으로 합니다.

  • vendor/hyperframes/registry/blocks/world-map/: 지도, 테마 상속, 구조화된 데이터에 대한 참조.
  • vendor/hyperframes/registry/blocks/metric-signal/: 데이터 표시 및 선택적 애니메이션 레시피에 대한 참조.
  • vendor/hyperframes/packages/core/src/registry/types.ts: 컴포넌트 분류 및 매니페스트 계약.
  • 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: 실제 설치, 테마 및 변수 통합 방식.

이러한 스키마를 복사하거나 다른 데이터 프로토콜을 생성하지 마십시오. 규칙이 코드와 일치하지 않으면 현재 소비자를 먼저 확인하고, 이전 예제로 인터페이스를 추측하지 마십시오.

2. 최소 제공 구조

일반적으로 vendor/hyperframes/registry/blocks/<slug>/에 다음을 배치하기만 하면 됩니다.

registry-item.json       # 메타 정보, 변수, 분류, 파일 및 기능 선언
<slug>.html              # 화면 및 애니메이션

정말 필요한 경우에만 로컬 이미지, 글꼴, 데이터 또는 미리보기 파일을 추가하십시오. 설치에 필요한 파일은 반드시 files에 선언하고, 경로는 패키지 내 상대 경로를 유지하십시오. 기존 vendor/hyperframes/registry/registry.json에 등록하고, 별도의 컴포넌트 디렉토리 서비스를 만들지 마십시오.

제품에서는 통칭하여 "컴포넌트"라고 부르지만, 하위 유형은 정확해야 합니다. 독립적인 캔버스와 길이를 가진 지도, 순위표 등은 일반적으로 hyperframes:block입니다. 기존 화면에 주입되는 조각은 hyperframes:component입니다. 전체 프로젝트 템플릿은 다른 제공 방식에 속하므로 혼용하지 마십시오.

3. 변수: 적게 사용하고 유용하게, 폼은 공유

  • 매니페스트의 variables에서 안정적인 id, 이해 가능한 label, 유형 및 기본값을 선언하고, HTML의 data-composition-variables와 일관성을 유지하십시오.
  • 기존 string / number / color / boolean / enum 유형을 사용하십시오. 숫자에는 합리적인 범위를, 열거형에는 옵션을, 긴 텍스트에는 길이 제약을 제공하십시오. 객체 유형을 임의로 추가하지 마십시오.
  • 콘텐츠, 데이터, 하이라이트, 필요한 레이아웃 등 사용자가 결정해야 하는 사항만 노출하십시오. 모든 CSS 값을 매개변수로 만들지 마십시오. 색상은 기본적으로 테마에서 가져오므로 사용자가 항목별로 색상을 지정해야 사용할 수 없어야 합니다.
  • update: live는 즉시 업데이트할 수 있는 매개변수에만 사용하십시오. 구조나 애니메이션을 변경할 때는 기존 메커니즘에 따라 rebuild / reload를 사용하고, 선언은 실제 동작과 일치해야 합니다.
  • 기존 변수 업데이트 메커니즘에 연결하고, 업데이트 후 DOM과 애니메이션이 새 값을 반영하고 호스트의 현재 재생 위치를 유지해야 합니다. 텍스트만 변경하고 타임라인이 여전히 이전 요소를 가리키도록 하지 마십시오.
  • 공유 변수 폼과 데이터 테이블을 사용하고, 단일 컴포넌트를 위해 새 패널을 작성하지 마십시오. motionCueTimes, motionStyle 등 시스템 제어 필드는 일반 사용자 매개변수로 취급하지 마십시오.

4. 데이터: AI에게는 구조를, 사용자에게는 테이블을

지도, 경로, 차트, 순위표 등 데이터 컴포넌트는 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 상태를 설정하지 마십시오. 잘못된 데이터에는 명확한 힌트를 제공하고, 조용히 행을 버리거나 가짜 값을 생성하지 마십시오.

5. 테마 및 분류

  • 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.
  • 독립적인 미리보기를 위한 기본 대체 값을 허용하지만, 호스트가 전달한 테마를 덮어쓸 수 없습니다. 테마 전환 후 배경, 텍스트, 그래픽, 테두리 및 글꼴이 조화롭게 변경되어야 합니다. 데이터의 의미적 색상은 명확한 이유가 있는 경우에만 예외입니다.
  • 계층 구조를 명확하게 유지하고, 여백을 합리적으로 유지하며, 한국어 가독성을 고려하십시오. 필요한 경우 절제된 그라데이션이나 유리 효과를 사용할 수 있지만, 특수 효과로 정보 전달을 대체하지 마십시오.

6. 애니메이션 및 타임라인

  • 기본값은 HTML + CSS + GSAP입니다. 기존 그래픽 및 로컬 SVG를 우선적으로 재사용하십시오. 명확하게 실제 3D가 필요한 경우에만 Three.js를 고려하고, 단순한 지도를 위해 무거운 종속성을 추가하지 마십시오.
  • 기존 composition 루트 노드, 크기, 길이 및 설치 메커니즘을 사용하고, HyperFrames가 재생, 일시 정지 및 탐색(seek)을 제어할 수 있도록 window.__timelines[compositionId]에 등록된 일시 중지된 GSAP 타임라인에 등록하십시오.
  • 각 인스턴스의 선택자, 상태 및 타임라인은 자신에게만 영향을 미칩니다. 재구성 시 이전 애니메이션을 정리하고 다른 인스턴스를 덮어쓰지 마십시오.
  • 동일한 순간에 동일한 화면을 보여주어야 합니다. 독립적인 타이머, 자동 재생 루프, 고정되지 않은 난수 또는 CSS 자체 실행 애니메이션을 사용하여 주요 콘텐츠를 구동하지 마십시오. 실제 이미지, 오디오 및 비디오는 기존 미디어 시간 동기화 방식을 따르십시오.
  • 애니메이션은 설명 순서에 따라 제공됩니다. 명확하게 나타나고, 강조되고, 머물고, 사라집니다. 텍스트와 데이터는 읽을 수 있는 충분한 시간을 제공하십시오. 모든 컴포넌트가 동일한 등장 방식을 가지거나 기술 과시를 위해 지속적으로 움직이는 것을 피하십시오.
  • 일반 컴포넌트는 motionRecipe를 강제로 추가하지 마십시오. AI가 내레이션에 따라 애니메이션 레시피를 호출해야 하는 경우에만 이미 지원되는 레시피 계약을 사용하십시오. 이벤트, 큐 바인딩은 실제 요소와 일관되어야 하며, 용량 및 텍스트 제한은 실제 근거가 있어야 하고, 더빙 시간을 위조하지 마십시오.

7. AI 가공 공간

visualComponent.ai.slots를 사용하여 안정적인 편집 가능 영역을 선언하고, HTML의 해당 위치에 data-ipw-ai-slot을 추가하십시오. instructions는 사용 목적, 입력 규칙 및 유지해야 할 구조를 간략히 설명합니다.

AI가 콘텐츠를 교체하고, 레이아웃을 조정하고, 지도를 축소하고 옆에 설명을 추가하는 등의 부분적 가공을 지원합니다. 변수 ID, 데이터 바인딩, 테마 상속 및 타임라인 연결은 변경되지 않은 상태로 유지하십시오. 모든 가공을 폼 매개변수로 강제 변환하지 말고, AI를 위해 별도의 화면 인스턴스를 유지하지 마십시오.

외부 텍스트는 텍스트로 처리하고, 실행 가능한 HTML로 조합하지 마십시오. 입력 데이터의 스크립트를 실행하지 말고, 키를 포함하지 마십시오. 지도, 글꼴, 이미지 등 리소스를 참조할 때는 출처와 라이선스를 유지하고, 자료가 없으면 명확히 설명하고, 눈에 띄지 않게 네트워크에서 대체하지 마십시오.

8. 검수 및 제공

  1. 매니페스트, HTML 변수, AI 슬롯, 데이터 바인딩 및 설치 경로가 일관되고, 현재 저장소의 해당 검증과 영향을 받는 테스트를 통과해야 합니다.
  2. 기존 Studio에 컴포넌트를 설치하십시오. 공유 폼이 실제 화면을 수정할 수 있고, 데이터 테이블이 합법적인 행을 추가, 삭제 및 편집할 수 있어야 합니다.
  3. 기본값, 경계값, null 값, 긴 한국어 텍스트, 잘못된 데이터 및 두 가지 테마를 확인하십시오. 여러 인스턴스가 서로 영향을 주지 않아야 합니다.
  4. 처음부터 재생, 중간 탐색(seek), 시작점으로 드래그, 매개변수 업데이트 후 탐색(seek)을 확인하십시오. 화면과 타임라인이 일치해야 합니다.
  5. 실제 자료를 사용하여 짧은 비디오 클립을 내보내고 브라우저 미리보기와 출력이 일치하는지 확인하십시오. 스크린샷만으로 통과했다고 주장하지 마십시오.
  6. 컴포넌트 파일, 필요한 리소스 및 출처, 매개변수/데이터 예제, 실제 테스트 결과 및 검증되지 않은 항목을 제공하십시오. Studio를 복사하지 말고, 기존 템플릿 동작을 변경하지 말고, 대체 구현을 남기지 마십시오.

이 규칙은 컴포넌트 개발만을 안내합니다. npm 게시, 호스트 플러그인 수정, PR 제출 또는 컴포넌트 마켓 업로드는 사용자 권한 및 기존 게시 절차에 따라 별도로 처리해야 합니다.

Individual skills in this repo

This repo contains 17 individual skills — each has its own dedicated page.

Devin-AXIS/iPolloWork

Create deterministic animation and transitions for the active iPollo Video project.

Devin-AXIS/iPolloWork

Inspect, validate, preview, and render the active iPollo Video project with its bundled HyperFrames CLI.

Devin-AXIS/iPolloWork

Apply the core composition, timing, media, and determinism contract used by iPollo Video.

Devin-AXIS/iPolloWork

Plan visual direction, typography, pacing, audio, and composition for iPollo Video projects.

Devin-AXIS/iPolloWork

Build seek-safe keyframe animation for the active iPollo Video timeline.

Devin-AXIS/iPolloWork

Reuse approved HyperFrames blocks and components inside the active iPollo Video project.

Devin-AXIS/iPolloWork

Route video creation and editing through the active iPollo Video project and its built-in HyperFrames runtime.

Devin-AXIS/iPolloWork

Create or edit the active iPolloWork video's visual assets, installed recipes, editable composition and seek-safe motion; use for assembly or local picture/text/theme changes.

Devin-AXIS/iPolloWork

Add or revise music, sound effects and their mix in the active iPolloWork video, using authorized sources, real editable tracks and measured event cues.

Devin-AXIS/iPolloWork

Write or revise the active iPolloWork video's native STORYBOARD.md, with source coverage, content-led sequence and provisional timing; use for script-only work.

Devin-AXIS/iPolloWork

Route the active iPolloWork video request to its current storyboard, compose, voiceover or soundtrack work, preserving the client-owned delivery flow.

Devin-AXIS/iPolloWork

Add or revise scene-bound narration or speech-linked captions in the active iPolloWork video using actual voice settings, measured audio and alignment.

Devin-AXIS/iPolloWork

Create product launch and promotional videos through the active iPollo Video workflow.

Devin-AXIS/iPolloWork

Translates Figma motion and animations into production-ready application code. Use when implementing animation/motion from a Figma design — user mentions "implement this motion", "add animation from Figma", "animate this component", provides a Figma URL whose node is animated, or when `get_design_context` returns motion data or instructs you to call `get_motion_context`.

Devin-AXIS/iPolloWork

Motion / animation context for the `use_figma` MCP tool — animating Figma nodes via manual keyframes, animation styles, easing, and timeline duration. Load alongside figma-use whenever a task involves adding, editing, or inspecting animation on a node.

Devin-AXIS/iPolloWork

Plan and create short videos using the installed short-video-studio workspace app. Manage its creative canvas, scripts, storyboards, characters and local assets, generate images or video through connected Work channels, and hand off editable tracks to Work Video Studio.

Devin-AXIS/iPolloWork

Find, generate, process, and reuse media through the active iPollo Video session's media services.

관련 스킬