mcpField
A
adversarial-tanstack

adversarial-tanstack

github.com/pproencaテスト・品質21872 回インストール11 週間前に更新
リポジトリ

adversarial-tanstack について

adversarial-tanstackは、TanStack StartとTypeScriptの変更を審査するマージゲート用スキルです。単一のブラインドレビュアーが厳格に合否を判定し、コード修正や助言的なフィードバックは行いません。

主な機能

  1. 01単一サブエージェントによるブラインドレビュー
  2. 02失敗時に通さない合否判定
  3. 03セキュリティと境界のルール
  4. 04現行TanStack Start APIの検査
  5. 05失敗項目ごとの具体的な修正案

活用シーン

  1. 01マージ前のTanStack Start変更の審査
  2. 02エージェント作成コードの独立レビュー
  3. 03クライアント／サーバー境界のセキュリティ監査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pproenca/dot-skills --skill adversarial-tanstack

インストール後、Claude Code で/adversarial-tanstackを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

gotchas.md
metadata.json
assets/templates/
verdict.md
references/
_sections.md
boundary-client-env-prefix.md
boundary-env-server-context.md
boundary-loader-no-secrets.md
reviewer-prompt.md
sec-auth-at-handler.md
sec-csrf-with-custom-start.md
sec-no-account-enumeration.md
sec-private-cache-control.md
sec-session-cookie-flags.md
serverfn-current-api.md
serverfn-post-mutations.md
serverfn-static-imports.md
serverfn-validate-input.md
ssr-deterministic-render.md
ssr-per-request-instances.md
ssr-suspense-for-loader-data.md
tscfg-erasable-syntax.md
tscfg-no-verbatim-module-syntax.md
tscfg-strict-baseline.md
types-exhaustive-switch.md
types-justified-nonnull.md
types-no-escape-hatches.md
types-parse-external-data.md

詳細

Adversarial TanStack Gate

TanStack Start ＋ TypeScript のウェブアプリの変更に対するマージゲートです。合否を判定するゲートであり、単一のブラインドレビュアーサブエージェントが、このゲートのルールに対して敵対的な姿勢で作業を評価します。すべてのルールが PASS または N/A の場合にのみ、作業は合格となります。このスキルは判定を出すだけで、作業を修正することはありません。

ルールは @tanstack/react-start 1.168 以降（v1 RC、2026 年 7 月）と TypeScript 5.8～6.x の仕様に基づいています。

適用するタイミング

  • TanStack Start の機能、ルート、またはサーバー関数をマージする前に、助言的なフィードバックではなく、客観的な PASS／FAIL が必要な場合。
  • エージェント（Claude、Codex）が Start アプリのコードを作成し、作成者の偏りによる安易な承認を避けるために独立したチェックを行いたい場合。
  • 差分がクライアント／サーバー境界（環境変数、ローダー、サーバー関数、認証など）に触れており、誤った PASS によって秘密情報の漏洩や不正なデータアクセスが発生する可能性がある場合。
  • 既存の Start コードベースのファイル群を、現在の v1 RC API サーフェス（古くなった .inputValidator()、削除された createServerFileRoute）に照らして監査する場合。

Start 以外の React アプリには適用しないでください（ほとんどの serverfn／boundary／ssr ルールが N/A となり、ゲートが TypeScript チェックだけになってしまいます）。また、ユーザーが判定ではなく説明やリファクタリングを求めている場合にも適用しないでください。

レビュープロトコル

以下の手順に厳密に従ってください。すべてのレビューが同じ方法で実施されることに、このゲートの価値があります。

  1. 対象を特定する。 レビュー対象（差分、ファイル群、PR）を正確に特定し、レビューが曖昧さのない固定された対象に対して行われるよう、ref／パスを記録します。差分で触れていなくても、複数のルールがこれらのファイルによって決まるため、対象パスには必ず tsconfig.json、src/router.tsx、および存在する場合は src/start.ts を含めます。
  2. ルールを読み込む。 references/_sections.md と、references/ 内のすべてのルールファイル（すべての boundary-*.md、serverfn-*.md、sec-*.md、ssr-*.md、types-*.md、tscfg-*.md ファイル）を読みます。
  3. レビュアー用プロンプトを作成する。 ルールと対象を references/reviewer-prompt.md に記入します。作成したプロンプトは完全に自己完結していなければなりません。レビュアーには会話履歴が表示されないため、プロンプト外のコンテキストを参照してはなりません。
  4. ブラインドレビュアーを 1 人起動する。 作成したプロンプトだけを入力全体とする Task サブエージェントを 1 つ起動します。会話のコンテキストを渡したり、プロンプトに解説を添えたりしてはいけません。
  5. 失敗時に閉じる形で判定する。 レビュアーの構造化出力を判定とします。マージステップはありません。すべてのルールが PASS または N/A の場合にのみ、全体の判定を PASS とします。1 つでも FAIL があれば、ゲート全体が FAIL です。平均を取ったり、重大度を考慮したり、ルール適用を免除したりしてはいけません。「軽微な」FAIL も FAIL です。
  6. 判定を出力する。 assets/templates/verdict.md に記入します。FAIL の場合は、レビュアーの「PASS に必要な不足事項」の提案を修正リストにまとめ、それぞれ場所を示し、カテゴリの重要度順に並べます。最終結果が FAIL のルールはすべて修正リストに記載し、そのまま適用できる具体的な変更内容を示さなければなりません。レビュアーの提案が違反の言い換えにすぎない場合は、出力する前にルールの Correct の例を参考に修正方法を導き出してください。

変更のない対象を再レビューするたびに同じルールの判定が変わる場合、または人間が証拠を確認して判定を覆す場合、それはルールの判定可能性に関するバグです。gotchas.md に記録し、ルールを明確化してください。ゲートの判定を覆してはいけません。

判定形式

レビュアーはルールごとに、PASS | FAIL | N/A、証拠（file:line または引用。PASS と FAIL の両方で必須）を返します。また、FAIL ごとに、適用すればそのルールが PASS になる修正を示します。修正には、違反の言い換えではなく、変更内容とその場所を明記します。最終レポートは assets/templates/verdict.md に従います。

ルールのカテゴリ

#カテゴリプレフィックス対象
1クライアント／サーバーの境界boundary-サーバーコンテキスト内のみの環境変数、ローダーの同型性、公開プレフィックスの規律
2サーバー関数とルートserverfn-入力バリデーター、変更処理での POST、現行の v1 RC API、静的インポート
3認証とセキュリティsec-ハンドラーでの認証、カスタムの開始設定での CSRF、キャッシュのプライバシー、Cookie フラグ、列挙
4SSR とデータ読み込みssr-リクエストごとのルーター／QueryClient、ローダーデータでの useSuspenseQuery、決定論的なレンダリング
5境界における型安全性types-外部データのスキーマ解析、網羅的な switch、エスケープハッチの監査、非 null アサーション
6コンパイラー設定tscfg-strict + noUncheckedIndexedAccess、erasableSyntaxOnly、verbatimModuleSyntax off（Start 固有）

参照ファイル

ファイル説明
references/reviewer-prompt.mdブラインドレビュアー向けの自己完結型プロンプトテンプレート
assets/templates/verdict.md判定レポートのテンプレート
references/_sections.mdカテゴリの定義と順序
metadata.jsonバージョンとソースの参照情報

コメント

Markdown 対応