단순화 전환 안내

공통 실행·상태 조회·대표 명령·경량 설치로 바뀐 사용법과 호환성 안내

처음에는 대표 명령 12개에서 고르세요. 세부 작업이 필요하면 전체 카탈로그로 이어집니다. 스킬의 전문 지식은 필요한 작업에서 읽고, 구현·검증 절차는 공통 실행기를 사용합니다.

무엇을 고르면 되나요?#

하려는 일	권장 진입점
기존 저장소에서 일을 맡기기	`/cc-dev:go`
새 제품을 기획·생성·배포하기	`/cc-product-auto:run`
제품의 진행 상태 확인	`/cc-product:status`
코드 검토	`/cc-quality:review`
화면 설계·개발·대조	`/cc-blueprint:design`, `/cc-blueprint:build`, `/cc-blueprint:sync`
무엇을 쓸지 모르겠음	`/cc-compass:compass`

위 표는 Claude 정식명입니다. OpenCode 설치 이름은 대표 명령 표의 별도 열에서 확인합니다. name이나 예전 문서의 짧은 표기만으로 모든 환경에 단축 명령이 등록됐다고 가정하지 않습니다.

기존 명령은 어떻게 연결되나요?#

기존 정식 호출	공통 처리	확인할 차이
`/cc-dev:bugfix`	버그 입력 정리 → run/batch	진단·계측 회수는 공통 계약. 과거 fast-path의 암묵적 검증 면제 대신 표준 run 검증/승인 적용
`/cc-product:dev-story`	스토리/이슈 연결 → run	기본 PR-only. `PR_READY`는 merged/closed가 아님
`/cc-product:develop`	leaf → run, container → batch	dev-story와 run을 연달아 실행하지 않음. 지원 불가 옵션은 실행 전 오류
`/cc-product:bmad-status`	status `--source bmad`	같은 조회 기준과 옵션 매핑
`/cc-product:workflow-status`	status `--source bmad`	조회 중 초기화나 다음 개발 단계를 실행하지 않음

--no-merge는 PR·CI·리뷰 뒤 종료하며, 머지 사전승인과 함께 있어도 우선합니다. --skip-tests와 --skip-device는 서로 다른 검사입니다. 명시적 생략에는 공통 실행기의 승인·기록 규칙이 적용됩니다. 지정 기기 미발견, 열린 자식, 점유된 이슈, CI 실패와 조회 불가는 통합 뒤에도 성공으로 처리하지 않습니다.

상태를 한 곳에서 보기#

/cc-product:status
/cc-product:status --source bmad --issue 1810
/cc-product:status --all --detail

.pipeline과 BMAD 자료가 함께 있으면 출처별로 보여줍니다. 내용이 다르면 충돌과 증거를 표시합니다. 단계 개수는 설정에서 계산하며, 누락/미검증/PR 검토 중인 상태를 완료율에 섞지 않습니다.

작은 설치 범위로 시작하기#

터미널 · 아무 폴더에서:

curl -fsSL https://skills.cocode.im/install.sh | bash -s -- --preset starter

프리셋	규모	용도
`starter`	플러그인 3개	작업 라우팅·개발 사이클·리뷰
`flutter-core`	플러그인 5개	Flutter·CoUI·국제화·품질 도구
`serverpod-core`	플러그인 4개	Serverpod·공식 레퍼런스·보안

정확한 구성은 자동 생성 목록과 설치기의 --help에서 확인합니다. 전체 설치와 기존 프리셋도 사용할 수 있습니다. 경량 묶음을 추가 설치하는 것이 기존의 다른 모듈을 지우는 명령은 아닙니다. 제거 범위는 업그레이드와 복구를 확인하세요.

경량 설치는 모든 업무의 의존성을 포함하지 않습니다. 예를 들어 Figma 화면 대조를 하려면 해당 플러그인과 MCP, 실행 중인 앱이 추가로 필요합니다. 명령 실행 전 필요한 도구를 확인하고 설치/설정 안내를 따른 뒤 재개합니다. 설치가 빠졌다고 옛 구현 예제를 복사해 대신 실행하지 않습니다.

스킬을 고치는 사람에게#

제품 developer는 구현 방법을 복사하지 않고 Flutter/CoUI/Serverpod 전문 기준에 위임합니다.
국제화의 구현 소유자는 cc-i18n입니다. Flutter의 i18n-agent는 연결 역할이며 언어/경로는 slang.yaml에서 확인합니다.
캐싱 API는 serverpod-caching, 프로젝트 캐시 정책은 serverpod-caching-patterns에서 다룹니다.
정식명·OpenCode 이름·스킬 참조·진입점은 공유 카탈로그로 검사합니다.

터미널 · 이 저장소 루트에서:

python3 scripts/plugin_catalog.py --check
python3 scripts/plugin_catalog.py --primary
python3 scripts/sync_taxonomy.py --check
python3 -m unittest discover -s scripts -p 'test_*.py' -v

정상 결과: 카탈로그 검증 성공, 대표 명령 12개, 생성물 최신, 테스트 OK. 대표 명령과 프리셋 정책은 taxonomy.json을 고치고 scripts/sync_taxonomy.py --write로 갱신합니다. docs/COMMANDS.md와 웹의 대표 명령 페이지는 생성 결과이므로 직접 수정하지 않습니다.

다음: 대표 명령 · 첫 스킬 수정 · 검증하기