Testsy

Testsy のインテグレーション

リリースチェックを保存可能な平易な英語のテストに変換し、失敗した実行を調査し、修正後も回帰テストのカバレッジを維持できます。これらのパッケージは、ホスト型 MCP エンドポイントを通じてコーディングエージェントを Testsy ワークスペースに接続します。

共通のスキルは testsy-check-release、testsy-investigate-run、testsy-regression-from-bug の 3 つです。リクエスト例を参照してください。すべてのスキルは期待される動作を維持し、アプリの失敗と、ブロックされた状態、結論が出ない状態、実行エラーの結果を区別します。

このディレクトリは、単独で利用できる MIT ライセンスのインテグレーションパッケージです。このライセンスの対象はこれらのインテグレーションファイルのみであり、Testsy サービスや親リポジトリは対象外です。

ビルドとチェック

Node.js 22 以降が必要です。依存関係や API 呼び出しは不要です。

npm run check
npm run build
npm run export
npm run archives

親リポジトリ内の integrations/testsy でこれらのコマンドを実行してください。単独でチェックアウトした場合は、リポジトリのルートで実行してください。dist/ には、独立したクライアントパッケージ、2 つのローカルマーケットプレイスカタログ、ピン留めされた GitHub Action、MCP Registry のメタデータが含まれます。各パッケージは同じ skills/ ソースから構成されます。生成されたマニフェストに認証情報は埋め込まれません。チェックにより、ローカルでのパッケージングとモック API の動作を確認できます。実際のクライアントとの互換性、マーケットプレイスでの承認、ホスト環境での実行成功を確認するものではありません。リリース要件を参照してください。

npm run export は、単独ソースパッケージ用の明示的なファイル許可リストを使い、release/ に独立したリポジトリルートを準備します。親リポジトリのチェックアウトやその Git 履歴をコピーすることはなく、Git の初期化や公開も行いません。release/export.json には、エクスポートされたすべてのファイルが SHA-256 で記録されます。npm run archives は、SHA256SUMS と release.json を含む、決定論的な testsy-<target>.tar.gz アーカイブを release/archives/ に準備します。各アーカイブは 1 つの testsy-<target>/ ディレクトリに展開されます。公開する際は、選んだリポジトリルートのみを確認してコピーしてください。非公開の親リポジトリのチェックアウトから公開コマンドを実行しないでください。

親の Testsy アプリケーションのチェックアウトから npm run downloads を実行すると、次回のデプロイに向けて、同じアーカイブとチェックサムのメタデータがランディングサイトの固定ディレクトリ apps/landing/public/downloads/testsy/ に書き込まれます。ダウンロード用の公開によってマーケットプレイスのリスティングが作成されることはありません。ダウンロードしたソースパッケージでは上記のビルドコマンドを使用できます。ネイティブクライアントパッケージはすでに構成済みで、インストールには独自の README を使用します。 親リポジトリのチェックアウトで npm run downloads:check を実行すると、チェックイン済みの公開アーカイブが現在のパッケージと一致していることを確認できます。このコマンドによって公開アセットが変更されることはありません。

親リポジトリでビルドする前に、そのルートから npx tsx scripts/v11/config-gen.ts を実行して共有設定を更新してください。アドレスは shared/hosts.ts で、正規の CLI は apps/customer/public/cli/qa-ai.mjs で編集します。ジェネレーターはこれらをこのパッケージにコピーします。エクスポートした単独チェックアウトでは、生成ファイルはチェックイン済みのリリース入力です。

ワークスペースを接続する

Testsy の「Settings → API keys」で、ワークフローに必要な実行権限と編集権限を持つワークスペース API キーを作成します。シークレットマネージャー、クライアント設定、または環境変数 QA_AI_API_KEY に保管してください。プロンプト、スクリーンショット、コミットする設定に貼り付けないでください。読み取り専用の調査には読み取りアクセスのみが必要です。実行ではワークスペースの利用枠を使用し、テストに記述された操作を実行する場合があります。

現在のエンドポイントとネイティブ設定は、config.json と manifests/ にあります。API キーは OAuth ディレクトリ接続とは独立して引き続きサポートされます。

Codex

ビルド後、codex plugin marketplace add ./dist/codex-marketplace を実行してローカルカタログを追加し、サポートされている Codex クライアントで、そのカタログから Testsy をインストールします。ダウンロードしたカタログを使用する場合は、testsy-codex-marketplace.tar.gz を展開し、このコマンドで ./testsy-codex-marketplace を指定します。プラグインにキーをそのまま保存するのではなく、Codex が環境変数からベアラートークンを読み込むように、MCP 接続を別途設定します。

codex mcp add testsy --url "$(node -p "require('./config.json').app + '/mcp'")" --bearer-token-env-var QA_AI_API_KEY

クライアントの環境変数に QA_AI_API_KEY を安全に設定して再起動し、MCP とスキルの一覧を確認します。Codex パッケージに含まれるのはスキルのみです。上記のコマンドで API キー接続を設定します。CLI／サーバー名は、ホストによって名前空間を付けられることがあります。

Claude Code

環境変数に QA_AI_API_KEY を安全に設定し、ローカルセッション用にパッケージを読み込みます。

claude --plugin-dir ./dist/claude

生成されたカタログからインストールする場合は、Claude Code で /plugin marketplace add /absolute/path/to/dist/claude-marketplace と /plugin install testsy@testsy を実行します。セッションを再起動し、/mcp と /skills を確認します。バンドルされた HTTP 設定は QA_AI_API_KEY を読み込みます。プラグインにその値は含まれていません。

Cursor

dist/cursor のパッケージには、QA_AI_API_KEY 変数と HTTP MCP 設定を宣言する、Cursor ネイティブのマニフェストが含まれています。リポジトリへの提出、またはチーム管理のプラグインインポート用に用意されています。Plugins → Configure から変数を設定します。Cursor の公開マーケットプレイスにはまだ掲載されていません。

掲載が承認される前に直接使用する場合は、3 つのスキルフォルダーをプロジェクトの .cursor/skills/ にコピーし、Cursor がサポートするシークレット／環境変数の仕組みを使って、manifests/cursor.mcp.json の mcpServers エントリーを MCP 設定に統合します。既存のプロジェクト設定を上書きしないでください。テストを実行する前に、Cursor でツールが検出されることを確認します。

Gemini CLI

gemini extensions install ./dist/gemini

プロンプトが表示されたら、機密情報を扱う Testsy API キー設定に API キーを入力します。Gemini CLI を再起動し、MCP とスキルの一覧を確認します。Gemini 拡張機能は継承された環境変数をサニタイズするため、マニフェストでは環境変数が明示的に宣言されています。

ChatGPT およびポータブルプラグインホスト

dist/portable-skills は、スキルのみを含む Agent Plugins v1 パッケージです。ツールを提供できる別途の Testsy 接続が必要です。dist/openai-oauth-candidate には、OAuth 検出用のリモート MCP エンドポイントも含まれています。デプロイ済みサービスで認可、ワークスペース分離、更新、失効を検証し、続いてクリーンインストールのテストとディレクトリレビューを完了するまでは、リリース候補として扱ってください。

ポータブル Agent Plugins v1 の HTTP ヘッダーは文字列として扱われます。ポータブルな mcp.json 内の ${QA_AI_API_KEY} は、そのまま送信されます。そのため、このパッケージでは API キーを直接使ってインストールする場合に、クライアント固有のシークレット機能を使用します。ポータブルな API キーの補間に対応しているとは主張しません。

skills.sh およびその他の Agent Skills ホスト

ソースの skills/ ディレクトリには、標準の SKILL.md ファイルが含まれています。選択したスキルフォルダーをクライアントのサポート対象スキルディレクトリにコピーし、Testsy MCP は別途接続します。リポジトリベースのスキルインストールコマンドを案内する前に、エクスポート済みのレビュー済みリポジトリを公開してください。このソースパッケージは、公開リポジトリやマーケットプレイスへの掲載を意味するものではありません。

CI とコマンドライン

バージョン固定された CLI は bin/testsy.mjs としてバンドルされており、アクションはこの固定コピーを実行します。実行時に変更可能なウェブサイトから実行可能コードを取得することはありません。CLI は互換性のため、既存の QA_AI_* 環境変数をサポートしています。

node bin/testsy.mjs version
node bin/testsy.mjs projects
node bin/testsy.mjs run --project p_myproject --junit testsy-junit.xml

終了コード：0 は設定されたゲートを満たした場合、1 は選択された失敗ステータスの場合、2 は使用方法／API／実行開始の失敗の場合、3 はポーリングのタイムアウトの場合です。デフォルトのゲートは failed,error で失敗します。リリース時に選択したすべてのテストの確実な完了が必要な場合は、--fail-on failed,error,blocked,inconclusive,cancelled を使用してください。

ビルド済みのアクションをアプリケーションリポジトリの .github/actions/testsy にコピーした後、次を実行します。

steps:
  - uses: actions/checkout@v4
  - uses: actions/setup-node@v4
    with:
      node-version: '22'
  - uses: ./.github/actions/testsy
    with:
      api-key: ${{ secrets.TESTSY_API_KEY }}
      project: p_myproject
      fail-on: failed,error,blocked,inconclusive,cancelled
  - uses: actions/upload-artifact@v4
    if: always()
    with:
      name: testsy-results
      path: testsy-junit.xml

dist/action を専用の公開アクションリポジトリとして公開し、リモートの uses: アドレスを記載する前に、レビュー済みのコミットにタグを付けてください。本番環境のワークフローでは、そのコミット SHA を固定してください。モバイルビルドの入力には APK と zip 圧縮された iOS Simulator アプリを指定できます。アプリの実行を前提とする前に、現在のランナーの利用状況を確認してください。

レジストリと公開

server.json は、秘密の Authorization ヘッダーを使用する既存のリモート MCP サーバーについて記述しています。dev.testsy/testsy 名前空間を利用するには、ドメイン所有権の認証が必要です。公開、公開リポジトリの作成、ディレクトリのレビューは、それぞれ別の外部手順です。RELEASING.md を参照してください。

2026-10-21 に確認した公式フォーマットの参考資料：OpenAI plugin packaging、Agent Plugins specification、Claude plugin manifest、Claude marketplaces、Cursor plugins、Gemini extensions、MCP Registry remote servers。