unity-cli-bridgelisted

# Unity CLI Bridge `unity-cli`를 실제 작업에 안전하게 쓰기 위한 운용 스킬이다. 목적은 명령어 목록을 길게 나열하는 것이 아니라, 현재 프로젝트를 올바르게 잡고, 맞는 명령을 고르고, 작업 뒤 로그까지 확인하는 흐름을 고정하는 것이다. ## Quick Workflow 1. 실행 파일을 찾는다. - 우선순위는 `UNITY_CLI_BIN` 환경 변수, `unity-cli` (PATH 상의 설치된 바이너리), 현재 작업 디렉터리나 상위 디렉터리의 `unity-cli` 실행 파일 순서다. - `ucli`가 PATH에 있으면 그대로 사용한다. 매 호출마다 변수를 재정의하지 않는다. - 셋 다 없으면 `unity-cli`를 먼저 설치하고 PATH를 잡는다. 필요하면 `ucli` 같은 짧은 alias를 추가한다. 2. **대상 프로젝트를 결정하고 `--project`를 항상 명시한다.** - CLI는 `--project` 없이 호출하면 아무 live 인스턴스에 연결한다. **의도하지 않은 프로젝트에 명령이 실행될 수 있으므로 반드시 명시한다.** - 프로젝트 결정 우선순위: 1. 사용자가 프로젝트를 명시적으로 지정한 경우 → 그대로 사용 2. 현재 작업 디렉터리(`pwd -P`)가 Unity 프로젝트 내부인 경우 → 해당 프로젝트 3. 여러 프로젝트가 실행 중이면 `instances list`로 확인 후 사용자에게 물어본다 - macOS에서는 항상 `pwd -P`로 실제 경로를 사용한다. - `--project`는 프로젝트 이름(예: `<your-project>`)이나 전체 경로 모두 가능하다. 3. 쓰기 작업 전에는 상태를 본다. - 먼저 `status --json --project <name>`으로 live 연결, busy 상태, 현재 프로젝트가 맞는지 확인한다. - 응답의 `projectName`이 의도한 프로젝트가 맞는지 반드시 확인한다. 4. 작업 종류에 맞는 흐름을 고른다. - 일반 명령, 에셋 작업, scene inspect/patch는 `references/command-flows.md` - 프리팹 조립과 patch spec은 `references/prefab-workflows.md` - 문제 해결은 `references/troubleshooting.md` 5. 작업 뒤에는 반드시 검증한다. - live 작업 뒤에는 `read-console --type error --limit N` - live 작업 뒤에는 `read-console --type warning --limit N` ## Operating Rules - 모든 asset 경로는 `Assets/...` 형식으로 다룬다. 조회 전용(`asset find`, `asset info`)은 `Packages/...`도 허용된다. - 파괴 연산과 덮어쓰기는 `--force`가 있을 때만 허용된다고 가정한다. - `execute --code 'Debug.Log(__pucArgsJson);' --args '{"k":"v"}' --force`