Skills
opt-editor 설치, 환경 진단, Plate 마이그레이션, 업그레이드, release용 action skill을 정리합니다.
reopt designUpdated
1. Editor Skills는 무엇인가
opt-editor Skills는 @reopt-ai/opt-editor 의 설치,
환경 진단, Plate 마이그레이션, 업그레이드, release를 실제 작업 단위로
처리하기 위한 action guide입니다.
이 페이지는 Editor 전용 workflow만 다룹니다. 공통 UI 설치와 repo 운영은
/docs/opt-ui/skills, DataGrid 전용 workflow는
/docs/opt-datagrid/skills 를 참고합니다.
2. 주요 Skills
| Skill | 실행 위치 | 용도 |
|---|---|---|
/opt-editor-install | 소비자 프로젝트 | 설치 또는 업그레이드 (자동 분기). CSS, catalog, breaking change 수정 포함 |
/opt-editor-doctor | 소비자 프로젝트 | 설치, .npmrc, CSS, catalog, 스트리밍 연동, compat 상태 진단 |
/opt-editor-migrate | 소비자 프로젝트 | Plate/Slate 기반 에디터를 opt-editor로 단계별 전환 |
/design-publish | opt-ui repo | opt-ui / opt-editor / opt-datagrid 통합 배포와 preflight 검증 |
읽기 전용 API/레시피는
node_modules/@reopt-ai/opt-editor/dist/docs/ 를 직접 보고,
설치/전환/업그레이드/배포 같은 작업 흐름은 action skill로 처리합니다.
3. 대표 워크플로우
소비자 프로젝트에 opt-editor 도입
consumer project: /opt-editor-install
consumer project: /opt-editor-install --with-ai
node_modules/@reopt-ai/opt-editor/dist/docs//opt-editor-install 은 미설치 시 초기 설정(CSS import, catalog
생성, 기본 Editor 렌더링)을, 이미 설치되어 있으면 업그레이드를 자동으로
수행합니다. AI 스트리밍까지 바로 붙일 때는 --with-ai 옵션을
사용합니다.
환경 진단과 수정 가이드
consumer project: /opt-editor-doctor
consumer project: /opt-editor-doctor --fix/opt-editor-doctor 는 패키지 설치, registry, CSS, catalog, Editor
컴포넌트, AI integration, Slate compat 잔존 여부까지 18개 체크로 점검합니다.
Plate 에디터 전환
consumer project: /opt-editor-migrate --analyze
consumer project: /opt-editor-migrate
consumer project: /opt-editor-migrate --phase=2/opt-editor-migrate 는 Plate/Slate 구조를 그대로 한 번에
갈아엎기보다, 기반 설치 → 컴포넌트 전환 → 데이터 변환 → 정리의 4단계로 점진적
전환을 전제로 합니다.
사설 배포
opt-ui repo: /design-publish/design-publish 는 opt-ui monorepo에서 실행합니다.
소비자 프로젝트의 설치/업그레이드는 /opt-editor-install 로 처리합니다.
4. 어떤 repo에서 실행해야 하나
/opt-editor-install, /opt-editor-doctor,
/opt-editor-migrate 는 실제 소비자 프로젝트에서 실행해야
합니다. 반면 /design-publish 는 opt-ui monorepo에서 실행해야
합니다.
특히 migrate와 install(upgrade 분기)은 기존 코드, Slate/Plate 의존성, 타입 사용처를 직접 읽어야 하므로 잘못된 repo에서 실행하면 분석 자체가 성립하지 않습니다.
5. 언제 Skills를 먼저 봐야 하나
신규 프로젝트에 opt-editor를 설치하고 catalog/store까지 붙여야 하는 경우
- AI 스트리밍을 포함한 Editor 초기 셋업을 한 번에 맞추려는 경우
설치 후 CSS, registry, catalog, stream wiring 문제를 진단해야 하는 경우
- Plate/Slate 기반 에디터를 점진적으로 opt-editor로 전환하려는 경우
- 버전 업그레이드 시 breaking change를 안전하게 적용해야 하는 경우
- 독립 release를 preflight 포함 경로로 실행해야 하는 경우
반대로 블록 타입, 스트리밍 프로토콜, Markdown 변환 API만 확인하면 된다면
Editor 문서와 dist/docs 레퍼런스를 먼저 보면 됩니다. Skills
문서는 설치와 전환, 검증, release 같은 작업 흐름을 위한 문서입니다.