devkit

SurvivorsStudio 팀 공용 개발 워크플로 플러그인입니다. Claude Code와 Codex가 같은 plugins/devkit/skills/ 및 agents/ 본문을 사용합니다.

Claude Code 설치

셸에서 설치합니다.

claude plugin marketplace add SurvivorsStudio/devkit
claude plugin install devkit@survivors
claude plugin list

목록에서 devkit@survivors가 enabled인지 확인한 뒤 새 세션을 여십시오. 플러그인은 세션 시작 시 로드됩니다. settings.json의 enabledPlugins만으로 설치 여부를 판단하지 말고 항상 claude plugin list를 사용하십시오.

갱신은 다음과 같습니다.

claude plugin update devkit@survivors

갱신 후에도 새 세션이 필요합니다.

Codex 설치

이 저장소의 팀 마켓플레이스는 기본 개인 마켓플레이스가 아니므로 먼저 GitHub 저장소를 마켓플레이스로 등록합니다.

codex plugin marketplace add SurvivorsStudio/devkit --ref main
codex plugin add devkit@survivors
codex plugin list

codex plugin list에서 devkit을 확인한 뒤 **새 작업(새 세션)**에서 사용하십시오. 플러그인을 로컬에서 개발할 때는 codex plugin marketplace add /path/to/devkit으로 클론 경로를 등록할 수도 있습니다.

저장소를 갱신한 뒤에는 등록된 Git 마켓플레이스 스냅샷을 먼저 갱신하고 다시 설치합니다.

codex plugin marketplace upgrade survivors
codex plugin add devkit@survivors
codex plugin list

개발 중 Codex가 이전 로컬 플러그인을 계속 보이면 Codex 매니페스트의 semantic version을 올린 뒤 다시 설치합니다. 개인 환경의 내부 스크립트 경로에 의존하지 마십시오.

제공 스킬

스킬	용도
/onboard	개발 환경과 설치 상태를 진단하고, 승인 후 정상화
/new-app	app-template에서 새 앱 저장소 생성
/pr	논리 단위 커밋, 읽기 전용 리뷰, PR 생성
/pr-merge	CI 통과 후 squash 머지 및 브랜치 정리
/done	세션의 결정과 근거를 로컬 .done/에 기록

호스트가 이름공간을 표시하면 /devkit:pr처럼 호출할 수 있습니다. 새 설치나 갱신 직후에는 새 세션에서 스킬 검색 결과를 확인하십시오.

Claude canonical · Codex 생성 배포본

.claude-plugin/marketplace.json          Claude Code 마켓플레이스
.agents/plugins/marketplace.json         Codex 팀 마켓플레이스
plugins/devkit/
├── .claude-plugin/plugin.json           Claude Code 매니페스트 (version 없음)
├── agents/pr-reviewer.md                 읽기 전용 PR 리뷰 절차
└── skills/                               Claude Code의 canonical 스킬 본문
codex-plugins/devkit/
├── .codex-plugin/plugin.json            Codex 매니페스트 (엄격한 semver version)
├── agents/                               canonical agents에서 생성
└── skills/                               canonical skills에서 생성
scripts/sync-codex-plugin.sh              Codex 배포본 생성·동기화 검사

Claude Code 본문이 원본입니다. done, pr, pr-merge의 disable-model-invocation: true는 Claude 전용 안전 필드이므로 원본에만 둡니다. Codex 배포본은 같은 본문에서 이 필드만 제거해 생성하며, 손으로 고치지 않습니다.

원본을 고친 뒤 다음을 실행하고 생성물이 최신인지 확인합니다.

./scripts/sync-codex-plugin.sh
./scripts/sync-codex-plugin.sh --check

버전 정책

Claude Code 매니페스트는 의도적으로 version을 두지 않습니다. Claude의 배포 기준은 커밋 SHA이므로 저장소 변경 후 claude plugin update devkit@survivors로 갱신합니다.

Codex 매니페스트는 엄격한 semantic version이 필수입니다. 배포 가능한 변경에서는 codex-plugins/devkit/.codex-plugin/plugin.json의 버전을 올리고 다시 설치합니다. Claude 매니페스트에 Codex 버전을 복사하지 마십시오.

스킬을 고칠 때

새 공용 스킬은 plugins/devkit/skills/<이름>/SKILL.md에 추가합니다. 마켓플레이스에는 플러그인만 등록하므로 스킬마다 별도 등록하지 않습니다. 변경 후 생성 스크립트를 실행하고, 각 런타임에서 갱신한 뒤 새 세션으로 확인하십시오.

관련 저장소

저장소	역할
app-template	새 앱의 원본
core	앱 공통 기능 npm 패키지
devops-docs	설계 근거와 결정 기록