metro-devtools-attachlisted
Install: claude install-skill ridsync/devoks-team-harness
## 전제 조건
### 플러그인 설치
```sh
/plugin install devoks-rn@devoks-plugins
/reload-plugins
```
### 런타임 전제
| 항목 | 조건 |
|------|------|
| Metro 실행 | `curl -s http://localhost:8081/status` → `packager-status:running` |
| 에뮬레이터 | Android: `adb devices` / iOS: `xcrun simctl list devices booted` |
### MCP 도구 Prefix
`/devoks-setup-mcp` Step 5로 설치하면 user scope에 등록된다:
```
mcp__metro-devtools__<tool>
```
미설치 시 `/devoks-setup-mcp`를 실행한다. **`mcp__chrome-devtools-attach__`와 절대 혼용 금지.**
---
## Step 1: 스크린샷 캡처 (항상 사용 가능 — MCP 불필요)
Metro 상태나 JS 디버거 활성화와 무관하게 즉시 사용할 수 있다.
### Android Emulator
```bash
adb exec-out screencap -p > /tmp/rn_screen.png
```
### iOS Simulator
```bash
xcrun simctl io booted screenshot /tmp/rn_screen.png
```
스크린샷 저장 후 Read tool로 이미지 파일을 읽으면 Claude가 UI를 시각적으로 확인할 수 있다.
#### 트러블슈팅
| 증상 | 원인 | 조치 |
|------|------|------|
| `adb` 명령 없음 | PATH 미설정 | `export PATH=$PATH:~/Library/Android/sdk/platform-tools` |
| Android 스크린샷 빈 파일 | 에뮬레이터 sleep 상태 | 에뮬레이터 화면 깨우기 |
| `xcrun simctl` 실패 | Xcode CLI 미설치 또는 PATH | `xcode-select --install` |
| iOS 물리 디바이스 | `xcrun simctl` 불가 | `idevicescreenshot`(libimobiledevice) 별도 설치 |
---
## Step 2: Metro CDP 연결 확인 (선택 — JS 상태 조회 필요 시)
`/devoks-setup-mcp` Step 5로 설치된 `metro-mcp.js`는 Metro URL을 자동 조회하므로 수동 설정이 불필요하다.
### 2-1. Metro 상태 확인
```bash
# Metro 실행 확인
curl -s http://localhost:8081/status # → packager-status:running
# MCP 연결 상태 확인
mcp__metro-devtools__get_metro_status
```
### 2-2. 연결 테스트
```
mcp__metro-devtools__evaluat