docs(debug): wire run_tests MCP tool into /ait debug skill

[DaveDev42]

배경

@ait-co/devtools repo에 폰 테스트러너 트릴로지(#644/#645/#646)가 머지됐다. 에이전트 진입점은 새 MCP 도구 **run_tests**로, 이미 attach된 실기기 WebView 위에서 미니앱의 *.phone.test.ts 파일을 Vitest 스타일로 실행하고 파일별 pass/fail/skip 결과를 반환한다.

이 PR은 그 도구를 /ait debug skill(shared/skills/debug/SKILL.md)에 반영하는 agent-plugin 반쪽이다. sdk-example의 테스트 파일 작성은 별도 PR로 분리된다.

변경 내역

§5-D 도구 테이블 (attach 의존 도구)

• run_tests 행 추가 (attach 의존 도구 12종 → 13종)
• 환경 2(relay-sandbox)에서 SDK가 mock이므로 실 SDK 동작 검증 불가임을 명시 — call_sdk/evaluate와 동일 규칙

§5-E 신규 섹션: 실기기 테스트 실행

• run_tests 인자 설명: files (필수), projectRoot, timeout_ms (기본 30000ms), confirm
• 환경 4(relay-live) confirm: true 게이트: 테스트가 실 SDK를 호출해 LIVE 번들에 부작용을 낼 수 있으므로, call_sdk/evaluate의 LIVE guard와 동일한 원칙 적용
• single-attach 모델: 별도 relay 연결을 열지 않고 이미 attach된 세션을 재사용 — 추가 QR 스캔 불필요
• 환경 2 mock-SDK caveat: DOM·console·타이밍 fidelity 검증은 가능하지만 실 SDK 동작은 환경 3(intoss-private dogfood)에서만 가능
• 로그에는 카운트만 포함하며 시크릿은 싣지 않음 (기존 SECRET-HANDLING 원칙과 동일)

"다음 단계" seam

• attach 후 *.phone.test.ts가 있으면 run_tests로 실행하는 분기 추가 (§1.3 next-station seam 요건 충족)

카운트 일관성

• "나머지 12종", "5-D의 12종 도구", "12종이 동적 등록" → 모두 13종으로 일관 업데이트
• 패널 탭 수 ("12개 탭", "12 tabs") — attach 의존 도구 카운트와 무관하므로 그대로 유지

검증

• node scripts/validate-plugin.mjs — 에러 0, 경고 1(링크 liveness 스킵, 기본 동작)
• 모든 "12종" 참조를 grep으로 확인: attach 의존 도구 관련 4개 모두 13종으로 수정, 패널 탭 2개는 유지

관련

• devtools 폰 테스트러너: feat(test-runner): run_tests MCP 도구 + 실기기 견고성 devtools#646 (구현 완료)
• sdk-example 테스트 파일 작성: 별도 PR (이 PR과 분리)

---

커뮤니티 오픈소스 프로젝트입니다.