Run

Skill: /run

인자 모드에 따라 세 가지 흐름:

| 인자 | 동작 | 내부 호출 | |---|---|---| | 없음 / mac / win / linux / webgl / android / ios | 플레이어 빌드 + 런치 | scripts/run.sh {platform} | | editor | Unity Editor GUI를 현재 프로젝트로 연다. 빌드 안 함 | scripts/run-editor.sh | | bridge | .claude-bridge/inbox/ 의 JSON 커맨드들을 헤드리스 Unity로 일괄 실행 | scripts/bridge-run.sh |

각 모드의 실제 작업 파일:

• 빌드: [scripts/run.sh](../../scripts/run.sh) + [Assets/Editor/RunBuildCommand.cs](../../Assets/Editor/RunBuildCommand.cs) (Project.Editor.RunBuildCommand.Build)
• Editor: [scripts/run-editor.sh](../../scripts/run-editor.sh) (open -a Unity --args -projectPath)
• Bridge: [scripts/bridge-run.sh](../../scripts/bridge-run.sh) + [Assets/Editor/ClaudeBridge/ClaudeBridgeBatch.cs](../../Assets/Editor/ClaudeBridge/ClaudeBridgeBatch.cs) (Project.Editor.ClaudeBridge.ClaudeBridgeBatch.Run)

이 스킬 파일은 인자 분기와 출력 해석만 담당한다.

---

1. 인자

빌드 (기본)

• 없음 → 현재 OS로 기본 (mac / win / linux 자동 감지)
• mac / macos / osx → StandaloneOSX
• win / windows → StandaloneWindows64
• linux → StandaloneLinux64
• web / webgl → WebGL
• android → Android (APK)
• ios → iOS (Xcode 프로젝트, macOS 호스트 필요)

편집

• editor → Unity Editor GUI 실행. 빌드 없음. Unity가 이미 같은 프로젝트로 떠 있으면 그 인스턴스가 전면화됨.

브릿지 (헤드리스)

• bridge → .claude-bridge/inbox/*.json 에 드롭된 커맨드를 Unity -batchmode로 일괄 처리. 결과는 .claude-bridge/outbox/*.json. 사용자가 Editor를 열어 둘 필요 없음.

---

2. 실행

프로젝트 루트(메인 또는 워크트리) 에서 인자별로:

./scripts/run.sh {platform}      # 빌드
./scripts/run-editor.sh          # Editor GUI
./scripts/bridge-run.sh          # ClaudeBridge 헤드리스 처리

3. 출력 구조

/builds/
└── {label}-{branch}-{shortsha}[-dirty]-{target}-{timestamp}/
    ├── BUILD_INFO.txt       ← 레이블/브랜치/커밋/Unity 버전/호스트 등 핑거프린트
    ├── unity-build.log      ← 배치모드 Unity 로그 전문
    └──     ← .app / .exe / WebGL 디렉토리 / .apk / .xcodeproj 등

label 의미:

• main — 현재 디렉토리가 primary git worktree일 때
• agent-0 / agent-1 / ... — 워크트리일 때 해당 디렉토리 이름

---

4. 오류 해석

스크립트는 종료 코드로 실패 원인을 구분합니다. 그대로 사용자에게 전달하세요.

공통

| 종료 코드 | 의미 | 대응 | |---|---|---| | 2 | 프로젝트 루트가 아님 / 인자 오타 | 경로 확인 후 재시도 | | 3 | Unity Editor 미설치 | 스크립트가 출력한 Unity Hub 설치 안내를 그대로 전달. 버전은 ProjectSettings/ProjectVersion.txt 기준 |

빌드 (run.sh) 추가

| 종료 코드 | 의미 | 대응 | |---|---|---| | 4 | 플랫폼 모듈 미설치 | 스크립트가 출력한 Unity Hub GUI 절차 + CLI 명령을 그대로 전달. 임의로 모듈을 자동 설치하지 말 것 (시간 오래 걸림, 대화형 프롬프트 가능성) | | 5 | 빌드 실패 | unity-build.log 끝 40줄을 스크립트가 출력함. 그 중 컴파일 에러·예외 스택트레이스를 요약해 보고 |

브릿지 (bridge-run.sh) 추가

| 종료 코드 | 의미 | 대응 | |---|---|---| | 1 | 일부/전부 커맨드 실패 | .claude-bridge/outbox/*.json 의 ok:false 항목 찾아서 error 필드 요약. 파일별 id로 어느 커맨드가 실패했는지 추적 | | 4 | Unity 프로세스 자체 실패 | .claude-bridge/logs/bridge-*.log 말미 확인. 주로 컴파일 에러 또는 Run 메서드 실행 중 예외 |

자주 나오는 빌드 실패

• No enabled scenes — 스켈레톤 상태의 템플릿에서는 정상. 사용자에게 File → Build Settings에서 씬을 추가하거나 Assets/Scenes/에 씬을 만들라고 안내한다.
• 컴파일 에러 — 로그 말미의 error CS 라인을 찾아 원인을 짚는다. 현재 세션에서 수정한 파일과 연관 있는지 먼저 확인.

---

5. 금지 사항

• 빌드 스크립트·RunBuildCommand.cs·ClaudeBridgeBatch.cs를 임의로 수정하지 않는다. 수정이 필요해 보이면 아키텍트에게 보고 후 승인받는다.
• 플랫폼 모듈을 자동 설치하지 않는다. 가이드만 제시.
• 다른 워크트리의 빌드 결과를 삭제하지 않는다. builds/ 정리는 별도 지시가 있을 때만.
• unity-build.log / bridge-*.log 전문을 대화창에 붙여넣지 않는다. 요약 + 원인 라인 위주로 보고.
• bridge 모드에서 Editor가 이미 열려 있으면 경고한다. 같은 프로젝트를 동시에 여는 Unity 인스턴스는 파일 락으로 충돌한다. 사용자에게 "Editor 닫고 다시 시도" 안내.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: zaffre001
• Source: zaffre001/unity-claude-template
• License: MIT

Install and usage instructions live in the source repository linked above.