Skills
opt-datagrid 설치, 마이그레이션, backend contract, 업그레이드, release용 action skill을 정리합니다.
reopt designUpdated
1. DataGrid 소비자 스킬
소비자 프로젝트의 공식 진입점은 opt-datagrid-install
하나입니다. 과거의 opt-datagrid-init·
opt-datagrid-upgrade는 별도 스킬이 아니며, 현재 스킬이 설치
상태와 요청을 읽어 install·upgrade· migrate·verify로 분기합니다.
권장 설정: 전용 스킬
신규 설치와 업그레이드를 자동 판별하고, 다른 grid에서의 마이그레이션·패키지 문서 확인·검증까지 처리합니다.
소비자 프로젝트 루트에서 스킬을 에이전트 런타임에 설치합니다. 이미 설치했다면 이 명령은 생략할 수 있습니다.
npx skills add reopt-ai/reopt-skills/opt-datagrid-install설치 후 에이전트에게 아래처럼 요청하세요. 스킬은 현재 설치 상태를 확인해 신규 설치와 업그레이드를 구분합니다.
opt-datagrid-install 스킬로 이 프로젝트에 @reopt-ai/opt-datagrid을 설정하고 결과까지 검증해줘.스킬은 소비자 프로젝트의 AGENTS.md(없으면 CLAUDE.md)에 reopt marker 블록을 멱등하게 갱신하고, 설치된 패키지 버전의 문서를 읽은 뒤 typecheck·doctor 등 해당 모듈의 검증을 실행합니다.
아래 패키지 설치 명령은 스킬을 사용할 수 없거나 설정 과정을 직접 통제해야 할 때의 수동 대안입니다. 스킬 소스와 최신 지원 범위 확인.
2. 지원 모드
opt-datagrid-install # 미설치면 install, 설치됐으면 upgrade
opt-datagrid-install install # 신규 설치만
opt-datagrid-install verify # 기존 설치 검증
opt-datagrid-install --upgrade # 명시적 업그레이드
opt-datagrid-install --check # 변경 없이 분석
opt-datagrid-install --target=1.4.2 # 버전 지정
opt-datagrid-install migrate # 기존 grid 전환
opt-datagrid-install migrate --dry-run마이그레이션은 glide-data-grid, ag-grid, react-data-grid, MUI DataGrid 사용처를 대상으로 합니다. 변경 전 dry-run으로 대상 파일과 변환 범위를 확인하고, 변환 뒤 typecheck와 실제 grid 동작을 검증합니다.
3. 패키지 문서와 역할 분리
스킬은 설치된
node_modules/@reopt-ai/opt-datagrid/dist/docs/index.md를 시작점으로 실제 버전의 API와 recipe를 읽습니다.스킬에는 registry 정리, marker 블록, peer 확인, 마이그레이션 guardrail처럼 소비자 프로젝트 설정만 남깁니다.
- props·hooks·remote protocol의 정답을 스킬 문서에 복제하지 않습니다.
4. 메인테이너 워크플로우
| Skill | 실행 위치 | 용도 |
|---|---|---|
opt-datagrid-backend | backend 또는 consumer repo | remote datasource backend 계약 설계·검토 |
opt-e2e-loop | reopt-design | 문서 데모와 컴포넌트 E2E 검증 |
design-publish | reopt-design | 패키지 배포 preflight와 release |
5. 완료 기준
공개 npm registry를 사용하며 legacy GitHub Packages override가 없어야 합니다.
- React peer와 Client Component 경계가 맞아야 합니다.
고유 ID가 있는 row는
getRowId를 연결합니다.- typecheck가 통과하고 편집·키보드·대상 migration smoke를 확인합니다.