Communitygithub.com

ai4s-research/open-science

Tauriアプリやライブモデルを起動せずに、デスクトップフロントエンドの変更を視覚的に検証します。

open-science とは?

このスキルは、OpenCodeのフルアプリ実行を必要とせず、デスクトップフロントエンド(React/TypeScript)の変更を迅速に視覚検証するための方法を提供します。通常、変更を確認するにはOpenCodeセッションとライブモデルが必要ですが、このスキルではViteのスタンドアロンHTMLページにコンポーネントをマウントし、Chrome HTTP APIを通じてブラウザ操作とスクリーンショット撮影を行います。対応プラットフォームはChromeブラウザ(ポート9528のHTTP API)とVite開発サーバーです。検証用のHTML/TSXファイルを作成し、Viteを起動、ブラウザ制御スキルで操作・スクリーンショットを取得した後、クリーンアップまでを自動化します。このアプローチにより、フルアプリの起動待ちやモデル応答に依存せず、フロントエンドの見た目の変更だけを迅速に確認・デバッグできます。

対応~Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/ai4s-research/open-science/tree/HEAD/apps/desktop/.claude/skills/verify

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

デスクトップフロントエンド変更の検証

フルアプリ実行にはOpenCodeセッションとライブモデルのターンが必要です。純粋なフロントエンドコンポーネントの変更の場合、代わりに使い捨てのViteページにコンポーネントをマウントします:

  1. apps/desktop/verify-<x>.html(プレーンHTML、<div id="root">、<script type="module" src="/src/verify-<x>.tsx">)とapps/desktop/src/verify-<x>.tsx(ReactDOM.createRoot、./index.cssをインポートしてTailwindを適用、@/経由でコンポーネントをインポート)を作成します。Viteはapps/desktop/配下の任意の.htmlを自動的に提供します。
  2. cd apps/desktop && npx vite --port 5199 --strictPort(バックグラウンド)。npxラッパーが二重起動して「ポート使用中」エラーを報告することがありますが、最初のインスタンスは正常に動作しています。リトライする前にlsof -iTCP:5199で確認してください。
  3. ブラウザ制御スキル(Chrome HTTP API、ポート9528)で操作します: createWindow → waitForSelector → readDom → screenshotTab(スクリーンショットは~/Downloads/に保存されます)。注意点: evalScriptは拡張機能のCSPによりブロックされるため、代わりにreadDom/scrollTabを使用します。readDomを使用する際は明示的に"attributes": []を指定しないと「Value is unserializable」エラーが発生します。
  4. 後片付け: closeTabでタブを閉じ、viteプロセスを終了し、両方のハーネスファイルを削除し、git statusがクリーンであることを確認します。

関連スキル