Ops Client
개요
실제 데스크톱 클라이언트 창을 운영하고 검증합니다. 현재 가이드는 Tauri에 초점을 맞추고 있지만, 브라우저 미리보기가 유효한 증거가 아닌 클라이언트 앱에 이 스킬을 적용할 수 있습니다.
워크플로우
- 지정된 클라이언트 대상을 식별합니다: 앱 이름, 저장소 경로, 패키지/앱 디렉토리, 프로세스, PID, 보이는 창, 그리고 요청된 증거.
- 저장소에서 작업하는 경우,
src-tauri/,tauri.conf.*, Electron 설정, 네이티브 앱 타겟, 패키지 스크립트, justfile 작업, README 실행 안내와 같은 매니페스트와 소스 구조를 확인하여 데스크톱/클라이언트 앱이 포함되어 있는지 확인합니다. - 검증 전에 시작 명령어와 런타임 소스를 확인합니다:
pnpm tauri dev, 디버그 번들, 릴리스 앱, Electron/네이티브 실행 명령어, 또는 불명확할 경우Not found/Not verified. - 실제 창을 열거하고 소유자, PID, 제목, 경계를 기준으로 일치하는
CGWindowID를 식별합니다. - 포그라운드 포커스에 의존하지 않고 실제 창을 캡처합니다:
screencapture -x -l<CGWindowID> /private/tmp/desktop-client-window.png - 시각적 증거를 주장하기 전에
view_image로 스크린샷을 검사합니다. - 백그라운드 안전 검사 및 접근성(Accessibility) 작업(예: 명명된 컨트롤에 대한
AXPress)을 선호합니다. - UI, 번들 또는 접근성 변경 후 재확인하기 전에 의도된 클라이언트 인스턴스를 재빌드/재시작합니다.
모드
- 출시 검토: 실행 또는 검증 전에 저장소 소유의 클라이언트 앱과 시작 명령어를 식별합니다.
- 창 증거: 프로세스, 런타임, 창 ID, 스크린샷 소스를 입증합니다.
- 상호작용: 좌표 클릭 전에 접근성/컨트롤 트리 경로를 사용합니다.
- AI 운용 UI: 에이전트가 안정적으로 컨트롤을 식별할 수 있도록 DOM 및 접근성 표면을 개선합니다.
사용하지 말아야 할 경우
- 일반 브라우저 페이지, 웹 미리보기, 양식 워크플로우, 다운로드 또는 브라우저 콘솔/네트워크 확인에는
ops-browser를 사용하세요. - 사용자가 클라이언트 출시 검토, 실제 창 검증 또는 브라우저 미리보기 무효화를 요청하지 않는 한 일반적인 저장소 검색에는 사용하지 마세요.
- 작업에 Tauri, Electron 또는 네이티브 데스크톱 런타임의 증거가 필요한 경우 브라우저 미리보기 증거를 사용하지 마세요.
- 로컬 diff 검토, 계획 또는 보안 전용 검토에는 관련
code-*스킬을 사용하세요.
엄격한 규칙
- 사용자가 명시적으로 브라우저 전용 확인을 요청하지 않는 한, 브라우저 미리보기, 개발 서버 페이지 또는 영역 스크린샷을 데스크톱 클라이언트 증거로 취급하지 마십시오.
- 시작 명령어 소스와 그것이 기존 앱 인스턴스, 활성 창 또는 사용자 워크플로우를 방해할 수 있는지 확인하기 전에는 클라이언트를 시작하거나 재시작하지 마십시오.
- 안정적인 컨트롤 경로가 없고 위험이 허용 가능한 수준이 아닌 한, 사용자의 마우스를 빼앗거나, 포인터를 이동시키거나, 관련 없는 창을 활성화하거나, 좌표 클릭을 하지 마십시오.
- 중요한 컨트롤에는 의미론적 컨트롤, 접근 가능한 이름,
aria-label,title,sr-only, 연결된 폼 레이블, 안정적인data-testid선택자를 선호하십시오. - 프로세스, 런타임, 창 소스 또는 상호작용 증거가 확인되지 않은 경우
Not verified라고 말하십시오.
출력 계약
지정된 클라이언트 대상, 저장소/클라이언트 소유권 증거, 시작 명령어 또는 Not found, 대상 프로세스/런타임, 실제 창 증거, 스크린샷 소스, 상호작용 방법, 접근성 또는 DOM 격차, 재시작/재빌드 상태, 그리고 Not verified된 모든 것을 보고하십시오.
스킬 유지보수
이 패키지를 유지보수할 때, 트리거 범위, 모드, 엄격한 규칙 또는 출력 계약이 변경되면 references/eval-cases.md, references/usage.md 및 agents/openai.yaml을 업데이트하십시오. AICraft에서 게시 전에 python3 scripts/validate-skills.py를 실행하고, GitHub에 게시한 후에는 npx skills add https://github.com/idaibin/aicraft --list를 실행하십시오.
참조
- 트리거 안내 및 워크플로우 세부사항은 references/usage.md를 참조하십시오.
- 트리거 및 품질 평가는 references/eval-cases.md를 참조하십시오.