idaibin/aicraft

Ops Client

概要

実際のデスクトップクライアントウィンドウを操作し、検証します。現在のガイダンスはTauriに焦点を当てていますが、このスキルはブラウザプレビューが有効な証拠として不十分なクライアントアプリにも適用されます。

ワークフロー

1. 指定されたクライアントターゲットを特定します：アプリ名、リポジトリパス、パッケージ/アプリディレクトリ、プロセス、PID、表示されているウィンドウ、要求された証拠。
2. リポジトリから作業する場合、src-tauri/、tauri.conf.*、Electron設定、ネイティブアプリターゲット、パッケージスクリプト、justfileタスク、README実行手順などのマニフェストとソースレイアウトを確認して、デスクトップ/クライアントアプリが含まれているかどうかを確認します。
3. 検証前に起動コマンドとランタイムソースを確認します：pnpm tauri dev、デバッグバンドル、リリースアプリ、Electron/ネイティブ実行コマンド、または不明な場合はNot found/Not verified。
4. 実際のウィンドウを列挙し、所有者、PID、タイトル、境界によって一致するCGWindowIDを特定します。
5. フォアグラウンドフォーカスに依存せずに実際のウィンドウをキャプチャします： screencapture -x -l<CGWindowID> /private/tmp/desktop-client-window.png
6. 視覚的証拠を主張する前に、view_imageでスクリーンショットを検査します。
7. バックグラウンドで安全な検査と、名前付きコントロールに対するAXPressなどのアクセシビリティアクションを優先します。
8. UI、バンドル、またはアクセシビリティの変更後、再検証する前に目的のクライアントインスタンスを再ビルド/再起動します。

モード

• Launch Review: 実行または検証する前に、リポジトリが所有するクライアントアプリとその起動コマンドを特定します。
• Window Evidence: プロセス、ランタイム、ウィンドウID、スクリーンショットソースを証明します。
• Interaction: 座標クリックの前に、アクセシビリティ/コントロールツリーパスを使用します。
• AI-Operable UI: DOMとアクセシビリティサーフェスを改善し、エージェントが確実にコントロールを識別できるようにします。

使用しない場合

• 通常のブラウザページ、Webプレビュー、フォームワークフロー、ダウンロード、またはブラウザコンソール/ネットワークチェック。代わりにops-browserを使用してください。
• ユーザーがクライアント起動レビュー、実際のウィンドウ検証、またはブラウザプレビューの無効化を要求しない限り、通常のリポジトリ発見。
• タスクでTauri、Electron、またはネイティブデスクトップランタイムからの証明が必要な場合のブラウザプレビュー証拠。
• ローカル差分レビュー、計画、またはセキュリティのみのレビュー。関連する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を参照してください。