xy-development

開発標準

権限。 このスキルは ariestools/ariestools-skills でのみ管理されています。XYOracleNetwork/xyo-skills 内のコピーはリダイレクト用スタブです。編集するのはこちらであり、あちらではありません。

スキルの識別情報。 計画、了承、または完了の概要を提示する際は、その作成に役立てたスキルを xy-development v<version> の形式で示し、このパック内で有効な他のスキルも同じ形式で列挙してください。バージョンはこのファイルの metadata.version から読み取り、例から取得しないでください。

このスキルでは、開発の基礎となる実践方法を定めています。リポジトリ独自の AGENTS.md または CLAUDE.md に異なる指示がある場合は、リポジトリ側の指示を優先します。現在のタスクに合ったサブトピックを読み込んでください。

アーキテクチャの判断。 分散ワーカーの責任、復旧ルール、または新たな調整権限を導入する変更の前に、利用可能であれば ariestools-architecture を参照してください。プロトコルで定義された、自律的で置き換え可能なワーカーを優先し、永続的な証跡と安全な並行処理を確保してください。調整を導入する場合は、その不変条件またはリソース上の制約に基づいて正当化してください。通常の保守作業では、承認済みのアーキテクチャを維持してください。ワークフローでは、アーキテクチャスキルがない場合を含め、この対象を絞ったレビューについて説明しています。

目次

TypeScript の規約

TypeScript コードの作成、レビュー、リファクタリング、またはインポートの整理を行う際に読みます。厳格性マーカーとコード構造の制限、any の方針、戻り値の型、interface と type の使い分け、readonly の使用、消去可能な構文に関するルール（enum、パラメーター・プロパティ、namespace の禁止）、明示的なインポート拡張子を使う ESM 専用モジュール、ルートバレルからのインポートとインポートのスタイル、条件分岐、nullish 値、Promise、命名、エクスポート、ファイルの規約について説明しています。

Git ワークフロー

コミット、ブランチ作成、プッシュ、マージ、PR の作成、変更の取り消し、プッシュの拒否の解決、またはリリースの準備を行う際に読みます。Conventional Commits と PR タイトル、アトミックなコミット、コミットの ID とリポジトリの衛生管理、履歴書き換えの方針、ブランチモデルの検出、マージ方法、リリースについて説明しています。

テストの原則

テストの作成、テスト戦略の検討、またはカバレッジの評価を行う際に読みます。フレームワークに依存しない原則として、動作に焦点を当てた名前、準備・実行・検証、テストごとに1つの概念を扱うこと、公開インターフェースのテスト、独立性と決定性のあるテスト、実際の配線もテストできる範囲でモックを最小限にすること、カバレッジの優先順位について説明しています。フレームワーク、ランナー、仕様ファイルの配置は xy-toolchain スキル（xy-toolchain のテスト）で定義されています。

開発ワークフロー

ビルド、lint、テスト、または開発用コマンドを実行する前、依存関係を追加またはアップグレードする前、PRD.md の受け入れ基準を記述する際、またタスクの完了を宣言する前に読みます。ツールチェーンの確認（場当たり的な単発作業の前に、リポジトリの指示、スクリプト、CI を確認すること）、依存関係と peer dependency のルール、認証情報の安全性、階層化された完了の定義（アプリのブラウザー検証を含む）、プロジェクト固有の受け入れ基準の作成について説明しています。

動作を保持するリファクタリング

ファイルまたはパッケージ間でコードを移動する、パッケージを分割または統合する、依存関係の循環を解消する、またはモノレポのパッケージグラフについて凝集度と結合度を監査する際に読みます。動作を変更しないという不変条件、最初の変更前にベースラインを実行すること、凝集度と結合度に関する所見とそのデフォルトの重大度およびオーナー承認の手順、パッケージをまたぐ移動の手順（テスト、エントリーポイント、インポート箇所、マニフェスト、パスエイリアス）、公開済みパッケージの破壊的変更、移動ごとの検証ルールについて説明しています。

関連スキル

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

• ariestools-architecture — 自律性、権限、並行性、復旧に関する共通の設計方針とレビュー基準です。アーキテクチャ上の判断時に参照してください。受け入れ済みの設計に沿った通常の実装では、設計を再検討する必要はありません。
• xy-toolchain — xy CLI、ビルド／lint／テストコマンド、およびこれらの原則が実行されるツール群です。インストール：npx skills add ariestools/ariestools-skills --skill xy-toolchain。
• ariestools-sdk — 使用する @ariestools/* ユーティリティと、そのインポート方法について説明します。リポジトリが sdk-js パッケージに依存している場合に参照してください。xy skills lint がこれを必須とするのはその場合のみなので、ほかのリポジトリでは存在しないことがよくあります。インストール：npx skills add ariestools/ariestools-skills --skill ariestools-sdk。
• ariestools-sdk-react — コンポーネントやフックを担当する @ariestools/sdk-react* パッケージ、そのピア依存関係、および React コンテキストを重複させないためのインポートルールについて説明します。リポジトリが sdk-react パッケージに依存している場合に参照してください。toolchain 10.1.4 以降、xy skills lint がこれを必須とするのはその場合のみです。インストール：npx skills add ariestools/ariestools-skills --skill ariestools-sdk-react。
• ariestools-actor — cli-kit または browser-kit がホストする actor-kit のアクター、プロバイダー、アクターエンジンについて説明します。リポジトリが actor-kit、cli-kit、または browser-kit のパッケージに依存している場合に参照してください。toolchain 10.1.4 以降、xy skills lint がこれを必須とするのはその場合のみです。インストール：npx skills add ariestools/ariestools-skills --skill ariestools-actor。
• xy-agent — 推奨ですが、必須ではありません。 リポジトリのドキュメント規約です。AGENTS.md のエントリーポイント、ツールごとのアダプター、docs/ と papers/ のライフサイクルを定めています。リポジトリのエージェント向けドキュメントを作成または再編成するとき、あるいはリポジトリがすでにこのパターンに従っているときに参照してください。それ以外の場合は、リポジトリですでに採用されている規約に従ってください。@ariestools/toolchain リポジトリでは、xy agent lint（toolchain 10.1.1 以降）がこの規約を適用します。10.1.2 以降、pnpm xy check は、リポジトリのルートに AGENTS.md がある場合、または commands.agentLint が宣言されている場合（ルールレベルの設定のみの場合を含む）に限ってこれを実行します。またデフォルトでは、ルートの AGENTS.md が存在しない場合、またはそこにある相対 Markdown リンクのリンク先が存在しない場合に限り、エラーになります。CLAUDE.md が @AGENTS.md のインポートから始まっていない場合や、必須の AGENTS.md セクションがない場合など、ほかの逸脱は警告され、--strict または XY_STRICT=1 の場合にのみ失敗します。toolchain 10.1.1 は、より多くのルールがエラーレベルで適用される状態で、すべてのリポジトリでこれを実行します（バージョンの注記）。ルールと commands.agentLint.rules については、xy-toolchain › xy agent を参照してください。pnpm xy agent init は、既存ファイルを上書きせずに規約に沿ったファイル一式を生成します。インストール：npx skills add ariestools/ariestools-skills --skill xy-agent、または toolchain 10.1.2 以降は pnpm xy skills pick --skill xy-agent を実行します。後者は必須スキルとしても記録するため、pnpm xy skills lint がバージョンをチェックし、--fix がインストールまたは更新を行います。10.1.2 以降、xy repo init --skills-optional は、新しいリポジトリにおいて none 以外のどのスキル階層でもこれをインストールします。ただし、このフラグのヘルプには現在も XL1 スキルのみが記載されています。その他の方法と注意点については、xy-toolchain › xy skills を参照してください。