화수 맥 유즈 (macOS 네이티브 앱 자동화)

무엇을 해주나

• GUI 전용 앱 조작: 명령줄도 API도 없는 macOS 네이티브 앱(데스크톱 AI 클라이언트, 국산 클라이언트 등)의 메뉴 클릭, 입력창 채우기, 화면 읽기, 창 전환을 수행합니다.
• 4단계 채널 라우팅: L0 구조 인터페이스(CDP·AppleScript·URL scheme) → L1 접근성(AX) 의미 조작(agent-desktop) → L2 창 좌표 → L3 픽셀 순으로, 상황에 맞는 통로를 자동 선택합니다.
• 포커스 보호 게이트: 기본은 무헤드(백그라운드) 쓰기이며, 포커스를 빌려야 할 때만 터미널 창 차단·전역 포커스 락·"사용자가 2초 내 키보드/마우스를 썼으면 대기"라는 3중 게이트를 통과합니다.
• 검증과 취증: 도구가 성공을 반환해도 믿지 않고 읽기 재확인 → 스크린샷 → 상태 표시기 → 부수효과 순으로 실제 반영 여부를 판정하고, 창 단위 백그라운드 스크린샷을 증거로 남깁니다.
• 안전 정지선: 발행·결제·삭제·OAuth 동의 같은 되돌릴 수 없는 동작, 터미널 엔터, 시스템 권한 팝업, 금융·의료 앱은 사용자에게 넘깁니다.

이런 분께 추천

• 자동화 API가 없는 Mac 앱을 반복 조작해야 하는 분
• 버그 재현·보고용으로 특정 앱 창만 깔끔히 캡처해야 하는 분
• 여러 데스크톱(Space)을 쓰면서 작업 중에도 에이전트가 포커스를 뺏지 않길 원하는 분
• 데스크톱 AI 클라이언트에서 같은 프롬프트를 여러 모델에 돌려보고 결과를 증거로 남기려는 분

활용 예시

1. "이 Electron 기반 데스크톱 클라이언트에 질문을 넣고 답변 창을 캡처해줘" → probe.sh로 구조 확인 → mac open --cdp 9333 → cdp.js insert/press → cdp.js shot으로 증거 저장.
2. "다른 데스크톱에 있는 앱 창을 보고서에 넣게 캡처해줘" → mac windows <앱> --all로 on=0 확인 → mac shot으로 포커스 없이 백그라운드 캡처.
3. "처음 보는 앱인데 자동화 가능한지 확인해줘" → probe.sh <앱>으로 번들·아키텍처·URL scheme·AX 컨트롤 수·로컬 포트를 한 번에 점검.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/alchaincyf/huashu-mac-use/HEAD/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

AI 스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 alchaincyf/huashu-mac-use 의 SKILL.m 폴더를 내 ~/.claude/skills/huashu-mac-use/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.