xy-toolchain

XY Toolchain

権限。 このスキルは ariestools/ariestools-skills のみで管理されています。XYOracleNetwork/xyo-skills 内のコピーはリダイレクト用のスタブです。ここを編集し、あちらは編集しないでください。リポジトリに xylabs-* スキル、.claude/rules/xylabs-*.md、または .claude/commands/xy-*.md や xylabs-*.md も含まれている場合、それらは削除された xy claude コマンドが生成した廃止済みファイルです。このスキルがそれらに取って代わります。10.1.2 以降、xy skills lint はそれらを報告し、--fix はその大半を削除します（レガシーエージェントファイル）。

ツールチェーンのバージョン。 このスキルは @ariestools/toolchain 10.1.5 で検証されています。「（X 以降）」と記されていないものは、すべて 9.0.0 から利用できます。インストールされているバージョンは pnpm list @ariestools/toolchain --depth 0 で確認してください（pnpm xy --version が確実に使えるのは 10.0.6 以降のみです）。インストール済みのバージョンに存在しないトップレベルコマンドを実行すると、Command not found と表示されます。10.1.2 以降では終了コード 1 になります。新しいコマンドが存在しないバージョンである 10.1.1 以前では、--strict を指定していても終了コード 0 になります。サブコマンドが存在しない場合は、黙って無視されること（たとえば xy node <typo> はバナーだけを表示して終了コード 0 で終了します）もあれば、パッケージのターゲットとして解釈されることもあります。そのため、終了コードだけでなく、出力とバージョンに関する注記も確認してください。バージョンに関する注記に各コマンドの利用条件がまとめられています。

スキルの識別情報。 計画、確認応答、完了の要約を提示する際は、参考にしたスキルを xy-toolchain v<version> の形式で示し、このパック内のほかの有効なスキルも同じ形式でそれぞれ列挙してください。バージョンは、このファイルの metadata.version から読み取り、例や verified-toolchain から取得しないでください。

有効な @ariestools/toolchain パッケージを使用してください。新しい作業では、廃止された互換名 @xylabs/* をインストールしないでください。

チャンネル。 xy はセマンティックバージョニングに基づいて安定しています。xyex（9.2.0 以降）は、コマンド、フラグ、設定がマイナーリリースで変更される可能性がある実験的な上位版です。xy を優先してください。work、dead、plan など、pnpm xy --stability で実験的と示されるコマンドは、pnpm xyex <cmd> として実行してください（9.2.0 より前の場合は、チャンネルを参照してください）。

コマンドを選ぶ前に、リポジトリの package.json、ロックファイル、xy.config.ts、ESLint 設定、TypeScript 設定、テスト設定を確認してください。既存のリポジトリスクリプトを優先し、より限定的なラッパーがリポジトリにない場合は xy CLI を直接使用してください。

このスキルは、言語とワークフローの原則を解説する xy-development を基盤としています。タスクに必要なリファレンスだけを読み込んでください。

リファレンス

プロジェクトプロファイル

パッケージの役割（ライブラリ、ライブラリ／CLI、CLI、サービス、アプリ、ワークスペースのルート、ツール）、公開範囲、ランタイム、フレームワークを分類するとき、ニュートラル／Node／ブラウザー／React のガイダンスを選ぶとき、単一パッケージのサービスが workspace-root と誤検出される場合など、検出された deplint の役割を上書きするとき、モノレポと単一パッケージのセットアップの違いを判断するとき、または本番用の出力をフレームワークのツールと xy compile のどちらが管理するかを判断するときに、最初に読んでください。

ツールチェーンとプロジェクトのセットアップ

固定された TypeScript と ESLint の範囲でツールチェーンをインストールするとき、pnpm と pnpm-workspace.yaml をセットアップするとき、xy と xyex のどちらを使うか選ぶとき、ルートスクリプトと xy からの引き継ぎを設定するとき、xy コマンドと package-* フックを区別するとき、xy repo init でひな形を作成するか新規プロジェクトのベースラインを満たすとき、@xylabs/* から移行するとき、9.x から 10.x にアップグレードするとき、レガシーの xy claude エージェントファイルを削除するとき、コマンドが追加されたツールチェーンのバージョンを確認するとき、またはプロジェクトのセットアップに関する問題をトラブルシューティングするときに読んでください。

コンパイルとパッケージ出力

xy.config.ts の編集時（ルートからどの設定が引き継がれるかを含む）、neutral／node／browser ターゲットの選択時、library／bundle／transpile／monolith／vendor モードの選択時、型検証や実験的なネイティブコンパイラーの設定時、monolith の #imports と exports の整合性維持時、または出力ファイルや export のレイアウトのデバッグ時にお読みください。

コマンドとポリシーのカタログ

xy と xyex のコマンドを選ぶとき、ライフサイクルまたは CI のゲート（build、check、fix、test）を実行するとき、deplint（パッケージの役割、not-public、配置／存在、pick）、api-exposure、publint、license、secure、またはリポジトリポリシーの検出結果（nodeTrack を含む）を修正するとき、xy agent を使って AGENTS.md とドキュメントを確認するとき（10.1.1 以降。xy check は lint を実行します。10.1.2 以降は AGENTS.md が存在する場合、または commands.agentLint が宣言されている場合のみ実行します。実験的な --fix-interactive は 10.1.5 以降）、xy skills を管理するとき（ティア、package.json の xy.skills、スキルごとの存在、pick）、xyex work で作業を追跡するとき（GitHub Issues への二重書き込みと同期、複数フォルダーの --workspace スコープ）、clean を設定するとき、deploy と publish でリリースするとき（--tag、--defer）、依存関係を管理するとき（commands.updo.ignoreDeps を指定した install、reinstall、up、updo）、その他の実験的な xyex コマンド（dead、plan、npm-org、…）を使うとき、またはルールレベルを設定して --rules、--json、--strict、自動化の動作を使うときにお読みください。

計画ツール

xy-product-plan プロセス（papers、docs/ROADMAP.md、バージョンごとの PRD）向けにプロダクトリポジトリをスキャフォールドするとき、または実験的な xyex plan lint や .xy/plan.json を使うかどうか、その使い方を判断するときにお読みください。xy repo init と xy agent init が作成するもの、xy agent lint が papers、roadmap、PRD に対して確認する内容（バージョンの pin を確認するツールはないことも含む）、プロダクト接頭辞付きの Red および Light papers と競合する plan lint のルールとその無効化方法、manifest の paper スロットと roadmap のフェーズ、xyex work の項目と PRD のリンク方法について説明します。

ESLint の設定

ESLint のフラット設定を作成または修復するとき（xy lint init を使う場合も手動の場合も）、ルールのティアを選ぶとき、デフォルトのティアで適用されるルールを修正するとき、型情報を使った lint を有効化またはスコープ設定するとき、.gitignore を尊重するとき、共有の禁止ルールを削除せずに import の制限をオーバーライドするとき、lint のキャッシュやパフォーマンスを診断するとき、または lint lint と lint config を使うときにお読みください。

TypeScript の設定

pin された typescript の範囲（7 は不可）で @ariestools/tsconfig、-dom、または -react を選ぶとき、noEmit、erasableSyntaxOnly、デコレーターで必要となる tslib などのベースオプションを解釈するとき、Node の型とターゲットごとの型チェックを設定するとき、@ariestools/lib-neutral のアンビエントグローバルを使うとき、または型検証とツールチェーンによる出力を分けるときにお読みください。

Vitest によるテスト

Vitest を設定するとき（@ariestools/vitest-config プリセットと、バージョンに依存するデフォルトの include、または手書きの設定）、spec の配置場所と node／browser の振り分けを選ぶとき、ブラウザーテスト用に Chromium をインストールするとき、ワークスペースまたはパスを実行し、xy test がルートスクリプトに処理を引き渡す仕組みを理解するとき、アプリ全体の Playwright e2e を配置するとき、テストキャッシュをクリアするとき、またはテストの失敗とビルドの失敗を区別するときにお読みください。

関連スキル

これらはナビゲーションリンクであり、依存関係ではありません。各スキルは個別にインストールします。

• xy-development — 基本スキルです。TypeScript、Git、テストの原則、完了の定義を扱います。インストール：npx skills add ariestools/ariestools-skills --skill xy-development。
• ariestools-sdk — sdk-js の @ariestools/sdk ユーティリティと専門パッケージを扱います。このスキルを基盤とします。インストール：npx skills add ariestools/ariestools-skills --skill ariestools-sdk。
• ariestools-sdk-react — @ariestools/sdk-react* を使用した React UI、パッケージ、ピア依存関係、インポートルール、プロジェクト内のパターンを扱います。このスキルとその React プロファイルを基盤とします。インストール：npx skills add ariestools/ariestools-skills --skill ariestools-sdk-react、または 10.1.4 以降では pnpm xy skills pick --skill ariestools-sdk-react を使用します。こちらは必須スキルとしても記録されます。@ariestools/sdk-react* パッケージを使用している箇所では、xy skills lint によって必須であることが確認されます（xy skills）。
• ariestools-actor — cli-kit または browser-kit がホストする actor-kit のアクター、プロバイダー、アクターエンジンを扱います。このスキルを基盤とします。インストール：npx skills add ariestools/ariestools-skills --skill ariestools-actor、または 10.1.4 以降では pnpm xy skills pick --skill ariestools-actor を使用します。こちらは必須スキルとしても記録されます。actor-kit、cli-kit、browser-kit のパッケージを使用している箇所では、xy skills lint によって必須であることが確認されます（xy skills）。
• xy-agent — AGENTS.md、docs/、papers/ の規約を扱います。これらは安定版の xy agent lint でチェックされます（10.1.1 以降。xy check からも実行され、10.1.2 以降は AGENTS.md が存在する場合、または commands.agentLint が宣言されている場合にのみ実行されます）。補助コマンドとして xy agent init|audit|index|archive も利用できます（xy agent）。インストール：npx skills add ariestools/ariestools-skills --skill xy-agent、または pnpm xy skills pick --skill xy-agent（10.1.2 以降）。こちらも必須スキルとして記録されます。
• xy-product-plan — ツールに依存しないプロダクト計画プロセスを扱います。White、Yellow、Green、Red、Light の各ペーパー、ロードマップの MVP ライン、バージョンごとの PRD が含まれ、計画ツールがこれをサポートします。インストール：npx skills add ariestools/ariestools-skills --skill xy-product-plan。xy skills カタログには含まれないため、xy skills pick では拒否されます。
• ドメイン用のスキャフォールド（別の xyo-skills パックに含まれる XL1 アプリなど）も、ここで説明する、現在有効な @ariestools/* ツールチェーンパッケージに引き続き依存する必要があります。