agent-device (기기 에이전트)은(는) 무엇을 하나요?
이 스킬은 필수 기본값과 함께 라우터로 사용하세요. 이 파일을 먼저 읽으세요. 일반적인 기기 작업의 경우, 작업을 시작하기 전에 항상 references/bootstrap-install.md와 references/exploration.md를 로드하세요. 부트스트랩을 사용하여 결정론적 설정을 확인하거나 확립하세요. 탐색은 앱 세션이 열린 후 UI 검사, 상호 작용, 검증에 사용하세요.
기본 운영 규칙
- 보수적으로 시작하세요. UI를 변경하기 전에 읽기 전용 검사를 선호합니다.
- 화면에 현재 보이는 텍스트나 구조를 확인하는 작업에는 일반
snapshot을 사용하세요. - 요청된 작업이나 대상 쿼리에 대해
@e3과 같은 대화형 참조가 필요할 때만snapshot -i를 사용하세요. - 추측에 의한 변경은 피하세요. 팝업 닫기, 알림 해제, 의도하지 않은 표면 정리 등 검사를 진행하거나 요청된 작업을 완료하는 데 필요한 최소한의 되돌릴 수 있는 UI 작업만 수행할 수 있습니다.
- 사용자가 명시적으로 요청하지 않는 한 웹을 탐색하거나 외부 소스를 사용하지 마세요.
- 오래된 참조를 재사용하는 대신 의미 있는 UI 변경 후에는 다시 스냅샷을 찍으세요.
- 원시 좌표보다는
@ref또는 셀렉터 타겟팅을 선호합니다. - 상호 작용하기 전에 올바른 대상이 고정되어 있고 앱 세션이 열려 있는지 확인하세요.
- 루프를 짧게 유지하세요:
open-> 검사/실행 -> 필요한 경우 검증 ->close
기본 흐름
- 일반적인 기기 작업을 수행하기 전에 references/bootstrap-install.md와 references/exploration.md를 로드하세요.
- 먼저 부트스트랩을 사용하여 올바른 대상, 앱 설치, 열린 앱 세션을 확인하거나 확립하세요.
- 앱 세션이 열리고 안정화되면 탐색을 사용하여 검사, 상호 작용, 검증을 수행하세요.
- 보이는 것을 읽거나 확인하는 것이 목표라면 일반
snapshot으로 시작하세요. - 대화형 탐색이나 요청된 작업에 대한 참조가 필요한 경우에만
snapshot -i로 전환하세요. - 읽기 전용 명령으로 질문에 답할 수 있을 때는 UI를 변경하기 전에
get,is, 또는find를 사용하세요. - 필요한 경우 증거를 캡처한 후
close로 마칩니다.
QA 모드
- 보고와 함께 열린 버그 사냥: ../dogfood/SKILL.md를 사용하세요.
- 승인 기준에 따른 합격/불합격 QA: 이 스킬에 머물면서 references/bootstrap-install.md로 시작한 후 references/exploration.md의 QA 루프를 사용하세요.
필수 참조
- 모든 일반 기기 작업의 경우, 이 파일을 읽은 후 먼저 references/bootstrap-install.md를 로드하고, 그 다음 references/exploration.md를 로드한 후 작업을 수행하세요.
- 특히 샌드박스 또는 클라우드 환경에서 결정론적 설정을 확인하거나 확립하려면 부트스트랩을 사용하세요.
- 앱 세션이 열리고 안정화되면 탐색을 사용하세요.
- 추가 참조는 해당 범위가 필요할 때만 로드하세요.
결정 규칙
- 텍스트가 보이는지 확인해야 할 때는 일반
snapshot을 사용하세요. - 주로 대화형 탐색 및 참조 선택에는
snapshot -i를 사용하세요. - UI 상태를 변경하지 않고 질문에 답할 수 있을 때는
get,is, 또는find를 사용하세요. - 텍스트를 바꾸려면
fill을 사용하세요. - 텍스트를 추가하려면
type을 사용하세요. - 작업에서 "뒤로 가기"를 요청하면 예측 가능한 앱 소유 탐색을 위해 일반
back을 사용하고, 플랫폼 뒤로 가기 제스처나 버튼 의미에는back --system을 사용하세요. - 너무 빨리 입력할 때 문자를 놓치는 디바운스 검색 필드에는
type --delay-ms또는fill --delay-ms를 사용하세요. - 시뮬레이터가 없거나, 앱 설치가 없거나, 열린 앱 세션이 아직 없는 경우 설정 단계를 즉흥적으로 만들지 말고
bootstrap-install.md로 전환하세요. - 일시적인 UI가 검사를 막을 때는 가장 작은 해제 동작을 먼저 사용하되, 사용자가 해당 상호 작용을 요청하지 않는 한 UI가 데이터를 표시하도록 탐색, 검색, 새 텍스트 입력을 수행하지 마세요.
- 사용자가 요청하지 않는 한 화면에 없는 데이터를 보완하기 위해 외부 조회를 사용하지 마세요.
- 필요한 정보가 화면에 표시되지 않으면 추가 탐색, 텍스트 입력, 웹 검색으로 보완하는 대신 명확하게 그렇게 말하세요.
- 원시 좌표보다는
@ref또는 셀렉터 타겟팅을 선호합니다.
추가 참조
- 로그, 네트워크, 알림, 권한, 실패 분석이 필요한 경우: references/debugging.md
- 스크린샷, 차이점, 녹화, 재생 유지 관리, 성능 데이터가 필요한 경우: references/verification.md
- 데스크톱 표면, 메뉴 막대 동작, macOS 관련 상호 작용 규칙이 필요한 경우: references/macos-desktop.md
- 원격 HTTP 전송,
--remote-config실행, 원격 macOS 호스트의 테넌트 임대가 필요한 경우: references/remote-tenancy.md