Ask Gina Spot

askgina/plugins

概要： Ask Gina プログラマブルクライアント（TypeScript SDK と Bun CLI）、掲載されているプラグイン（移植可能なコアとホストアダプター）、モデルがそのプラグインを正しく使用するかを確認する評価、および公開評価アプリのための Apache-2.0 ワークスペースです。ログイン機能はありません。SDK と CLI の呼び出し元は、それぞれ独自のトークンを用意してください（以下を参照）。

本番環境の Gina MCP は https://askgina.ai/ai/gina/mcp にあります。SDK と CLI の呼び出し元は、外部で取得した tools:read 権限付きの Gina ベアラートークンを指定します。どちらのクライアントもログインや OAuth 認証は実装していません。読み取り専用トークンの取得方法については、認証とエージェントのセットアップを参照してください。

初めての方は、目的に応じた案内があるこちらからご覧ください。その下のリファレンスは、ビルド、評価アプリ、または lint の設定を変更する方向けです。

こちらから

目的を選択

やりたいこと	移動先
TypeScript コードから Gina を呼び出す	packages/sdk/README.md
ターミナルから Gina を呼び出す	packages/cli/README.md
共通カタログとプロトコル型を使用する	packages/contracts/README.md
ホスト（Cursor、Grok Bot、Devin など）にプラグインをインストールする	plugins/ask-gina/README.md
ChatGPT、Claude、Codex、または別のクライアントを接続する	公開されている接続ガイド
評価を実行または変更する	packages/evals/README.md。まずはリプレイから始めてください。ネットワーク呼び出しがなく、シークレットも不要です。
公開評価アプリに取り組む	リファレンス内の公開評価アプリ
変更をコントリビュートする	ai_docs/contributing.mdを確認し、続けて以下の手順に進んでください
公開ドキュメントサイトを編集する	docs/ が Mintlify のソースです。執筆ルールは ai_docs/docs/authoring.mdにあります

コントリビューターの作業手順

Bun 1.4.x が必要です（ルートの packageManager は [email protected] です）。リポジトリのルートで実行します。

bun install --frozen-lockfile
bun run fmt:check
bun run lint
bun run check
bun run test
bun run check:target-conformance
bun run artifacts
bun run verify:artifacts
bun run check:public-boundary

変更を提案する前に実行するよう、ai_docs/contributing.md で求められているコマンド一覧です。プルリクエストの CI では、これらに加えていくつかのチェックが実行されます（Reference のCI で実行される内容を参照）。main には必須の保護チェックが設定されていないため、CI はマージやパッケージの公開をブロックしません。

意外に思われる点：

• スキルは 1 か所で編集します。 正式なスキルのソースは plugins/ask-gina/skills/ のみにあります。ホスト向けのスキルツリーはパッケージ作成時に生成されるため、コミットしてはいけません。
• bun run check は lint だけではありません。 evals:check-public、evals:check-grading、TypeScript コンパイラー、TypeScript のインポートチェックも実行します。
• ドキュメントには専用のチェックがあります。 docs/ または tools/docs/ を変更した場合は、bun run docs:test と bun run docs:check も実行してください。ユーザー向け機能をリリースする場合は、ai_docs/release-docs-checklist.md に記載された手順も追加で実施します。
• Effect の診断は発生元で修正します。 抑制したり、ベースラインを追加したりしないでください。例外は、2 つの同期 SHA-256 ヘルパー（packages/contracts/src/sha256.ts と packages/evals/src/canonical-json.ts）に対する nodeBuiltinImport です。Effect の Crypto は非同期であり、スキーマフィルターとストリーミングファイルのハッシュには同期ダイジェストが必要です。node:crypto の代わりに、これらのヘルパーから sha256Hex をインポートしてください。

リポジトリの構成

パス	内容
packages/contracts	@askgina/contracts：公開カタログ、プロトコルのリテラル、レシートスキーマ。
packages/sdk	@askgina/sdk：TypeScript クライアント。
packages/cli	@askgina/cli：コンパイル済みの ask-gina Bun バイナリ。
packages/evals	@askgina/evals：リプレイ、ライブランナー、評価、サニタイズ、公開用エクスポート。
plugins/ask-gina	@askgina/plugin-core：プラグインの正式な入力（マニフェスト、スキル、評価ケース、ターゲット）と Devin のインストール手順。
apps/evals	公開されている評価用 React/Vite アプリと Storybook。npm 公開パッケージではありません。
tools/	ビルド、パッケージ作成、検証、境界チェックのスクリプト、評価の再採点と公開アーティファクトのチェック、ドキュメントチェック。
docs/	公開用 Mintlify ドキュメントのソース。
ai_docs/	内部エンジニアリングドキュメント：コントリビューション、アーキテクチャ、セキュリティ、評価の引き継ぎ、ドキュメント作成。
patches/	依存関係のパッチ。Storybook の docgen 互換性パッチ 2 件を含みます。
scripts/	Effect TSGo パッチを適用するヘルパー。
specs/	設計計画。

---

リファレンス

パッケージとランタイム

• @askgina/contracts：公開カタログ、プロトコルのリテラル、レシートのスキーマ。Node >=24 および Bun >=1.4 向けのルート限定 ESM
• @askgina/sdk：TypeScript クライアント。Node >=24 および Bun >=1.4 向けのルート限定 ESM
• @askgina/cli：コンパイル済みの Bun ask-gina バイナリ。Bun 1.4.x のみ
• @askgina/plugin-core：ホスト固有のプラグインコアとローダー。plugins/ask-gina 内
• @askgina/evals：コンパイル済みの hermetic/live eval ツール、共有コントラクト、アダプター、リプレイ、採点、サニタイズ。Bun 1.4.x のみ

contracts と SDK のパッケージには、CommonJS、ブラウザー、エッジ、サブパスのエントリーポイントはありません。

コマンド

目的別にまとめた package.json のルートスクリプト：

# Setup and quality
bun install --frozen-lockfile
bun run audit
bun run fmt:check
bun run lint
bun run check                 # quality: evals:check-public, evals:check-grading, vp check, tsc, check:typescript-imports
bun run typecheck
bun run test
bun run check:typescript-imports
bun run check:target-conformance
bun run effect-tsgo:diagnostics

# Packaging and verification
bun run build
bun run artifacts
bun run verify:artifacts
bun run verify:packages
bun run verify:targets
bun run smoke:install
bun run check:public-boundary
bun run check:marketplace:codex

# Public evals app
bun run evals:dev            # Vite dev server (default port 5173)
bun run evals:build
bun run evals:typecheck
bun run evals:check-public
bun run evals:check-grading
bun run storybook            # Storybook on port 6006
bun run build-storybook

# Evals
bun run eval:replay
bun run eval:responses
bun run eval:codex
bun run eval:openrouter
bun run eval:claude
bun run eval:omp
bun run eval:export-public

# Docs
bun run docs:check
bun run docs:test

CI で実行される処理

プルリクエストの CI（.github/workflows/ci.yml）では、次の処理が順番に実行されます。

bun install --frozen-lockfile
bun run audit
bun run fmt:check
bun run lint
bun run check
bun run evals:typecheck
bun run evals:build
bun run build-storybook
bun run test
bun run check:target-conformance
bun run artifacts
bun run verify:artifacts
bun run smoke:install
bun run check:public-boundary

続いて、公開済みリビジョンの Codex CLI を固定して、Codex マーケットプレイスのスモークテストを実行します。ドキュメントのワークフロー（.github/workflows/docs.yml）は、docs/、tools/docs/、プラグインのスキル、.mcp.json、または contracts のエントリーポイントに変更があるプルリクエストで実行されます。ドキュメントのチェック、スキルカタログ、比較テストの一連の実行（bun run docs:test）、および node tools/docs/check.mjs --external を実行します。

公開 evals アプリ

apps/evals は公開 React/Vite アプリです（npm 公開パッケージではありません）。Ask Gina のランディングページのタイポグラフィ、水彩画のアートワーク、UI コンポーネント、Storybook を備えています。リーダーボード、モデルのプロフィール、タスクのエビデンスエクスプローラー、方法論のページがあります。9 月の測定済みレポートと、明示的に例示用としたフィクスチャが共存しています。測定済みの行が対象とするのはツールの適合性であり、最終回答の正確性ではありません。公開ダウンロードはレビュー済みの投影データであり、会話の全アーカイブではありません。ビューアーからツールやウォレットへのライブ呼び出しは行いません。

CI では evals:build と build-storybook も実行されます。出力先は apps/evals/dist/app と apps/evals/dist/storybook で、公開パッケージの成果物とは分離されています。Storybook は既存の TypeScript 7 ツールチェーンに加え、TypeScript 5 の Compiler API エイリアスと、patches/ にある 2 つの docgen 互換性パッチを使用します。ローカルのフォントとアートワークは tools/public-source-assets.ts に固定されています。

バンドルの前に、公開アーティファクトのゲートで、過去の Claude レポートが厳格な投影フィールドと、レビュー済みの正確なパス／ハッシュ許可リストに適合しているかをチェックします。変更または新規作成された Claude JSON には、プライバシーレビューと、それに対応する来歴／許可リストの更新が必要です。生のプロバイダー出力を受け入れるためだけにハッシュを更新してはいけません。会話の全文は公開リポジトリの外部に保管されます。現行ファイルをサニタイズしても、過去の Git オブジェクト、フォークネットワークのコピー、以前のデプロイ／キャッシュの内容は削除されません。

Lint の設定

@shadcn/lint はルートの vite.config.ts に登録されています。 apps/evals/src では、shadcn/no-raw-colors、allow: ["layout"] を指定した shadcn/no-arbitrary-values、allow: ["layout"] に加えてプリミティブ上の名前付き evals CSS フックを許可する shadcn/no-restyle、および shadcn/require-static-classes が有効になっています。 apps/evals/src/components/ui では、プリミティブが構造的な値や内部バリアントを保持できるように、no-arbitrary-values、no-restyle、require-static-classes が無効になっています。bun run lint はワークスペース全体をチェックし、bun run check にも lint が含まれます。追加のルールは、まず effectTsgoRecommended.rules を展開したうえで lint.rules に追加するか、アプリ単位の lint.overrides に追加してください。利用可能なルールと設定例を参照してください。

成果物

bun run artifacts は vp pack で 5 つのパッケージ出力をビルドし、カスタムパッカーで 5 つのパッケージ tarball、6 つの完全なホストアーカイブ、4 スキルの候補アーカイブ 1 つ、および contract、package、target、eval のレシートを無視対象の dist/ 内に作成します。bun run verify:artifacts は tarball をクリーンな環境にインストールして、ランタイムチェックを実行します。プルリクエストの CI では、公開、リリース、デプロイ、提出、本番環境への呼び出しは行われません。

評価ランナー

ライブ評価ランナーは bun run eval:responses、eval:codex、eval:openrouter、 eval:claude、eval:omp です。隔離されたリプレイには eval:replay を使用します。認証情報、 フラグ、各ランナーで検証できることとできないこと、キャプチャ、公開ルールについては、 packages/evals/README.md をご覧ください。

評価 README に記載されていない詳細が 1 つあります。OpenRouter の --server-url が受け付けるのは、 https://askgina.ai/ai/gina/mcp（デフォルト）または https://alpha.askgina.ai/ai/gina/mcp のみです。それ以外の URL、末尾のスラッシュ、 および各会場の MCP エンドポイントは拒否されます。OMP ネイティブモードの合成保存済み認証情報 スモークテストは、実際の OAuth 認証テストでもサブスクリプション認証テストでもありません。