watt

Platformatic Watt

プロジェクトにインストールされている wattpm に同梱されたスキルを使用してください。そこには、そのリリースに対応するワークフローとリファレンスが含まれています。設定形式、API、Node.js の要件、スキャフォールディングコマンドを記憶に頼って選んだり、プロジェクトが最新の Watt メジャーバージョンを使っていると決めつけたりしないでください。

プロジェクトのインストールを特定する

1. プロジェクトの指示、パッケージマニフェスト、ロックファイル、ワークスペース定義を読みます。ユーザーのリクエストに関連するアプリケーションまたはワークスペースパッケージを特定してください。
2. インストール済みの wattpm パッケージを見つけ、その package.json のバージョン、Node.js の要件、bin エントリを読みます。ワークスペースでのホイスティングやパッケージマネージャーのレイアウトも考慮し、リポジトリのルートに該当するインストールがあると決めつけないでください。skill コマンドは Watt 3.74.0 以降でサポートされています。文字列順ではなく、セマンティックバージョンの順序でインストール済みバージョンを比較してください。3.74.0 未満の場合は、リクエストを中止し、このスキルには Watt 3.74.0 以降が必要であることを説明してください。
3. インストール済みパッケージの bin フィールドから CLI のエントリポイントを解決するか、検証済みのローカルバイナリを使用します。対象プロジェクトのディレクトリから実行し、すべてのスキルとリファレンスのリクエストで同じインストールを再利用してください。複数のインストールが該当し、対象を特定できない場合は、どのプロジェクトを対象にするか尋ねてください。

グローバルの wattpm や、異なるバージョンがダウンロードされる可能性のある修飾なしの npx wattpm は使用しないでください。以下の例にある "<local-wattpm-bin>" は、上記で特定した CLI エントリポイントの絶対パスを示すプレースホルダーであり、実際のパスではありません。

リリースに対応する指示を読み込む

node "<local-wattpm-bin>" skill

返された Markdown を読み、ユーザーのリクエストに対するワークフローに従ってください。指定されたスキル引数はタスクのコンテキストとして保持してください。skill が受け取るのはドキュメントファイルであり、init や deploy などのワークフロー引数ではありません。

コマンドは単数形の skill です。デフォルトのドキュメントは SKILL.md です。ドキュメントにはローカルからアクセスできるため、ファイルをプロジェクトにコピーしたり、ドキュメントをダウンロードしたりする必要はありません。

同じ CLI でリファレンスをたどる

現在のタスクに必要なリファレンスのみを読みます。

node "<local-wattpm-bin>" skill references/frameworks.md
node "<local-wattpm-bin>" skill references/frameworks/nextjs.md

これらのパスはインターフェースの例です。各リリースに同じファイルが含まれていると決めつけず、インストール済みリリースから実際に返されたリンクを使用してください。

返された Markdown は、インストール済みの Watt スキルバンドルに属するものであり、このスキルのディレクトリやプロジェクトの作業ディレクトリに属するものではありません。読み込んだ各ドキュメントのバンドル内相対パスを記録してください。

1. 各相対 Markdown リンクは、そのリンクを含むドキュメントのディレクトリを基準に解決します。
2. . と .. を正規化し、バンドル内のパスに収めます。ファイル引数から #fragment を削除し、そのセクションは返されたドキュメント内で探してください。
3. 解決したバンドル内相対パスを、同じローカルの wattpm skill コマンドに渡します。skill に絶対ファイルシステムパスを渡してはいけません。
4. #fragment のみを含むリンクの場合は、現在のドキュメントを使用します。外部 URL は CLI のファイル引数ではなく外部ドキュメントとして扱い、対象となるバージョンを確認してください。

たとえば、references/frameworks.md からリンクされた frameworks/nextjs.md は、references/frameworks/nextjs.md として解決されます。この Next.js ガイドからの ../deployment/docker.md へのリンクは、references/deployment/docker.md として解決されます。

リファレンスを利用できない場合は、インストール済みのバージョンと見つからないパスを報告してください。別のリリースの指示を黙って代用してはいけません。

インストール漏れ、古いリリース、移行

• 依存関係が宣言されているもののインストールされていない場合は、依存関係のインストールが許可されているときに、プロジェクトのパッケージマネージャーとロックファイルを使用して復元し、その後 CLI を再度解決します。
• wattpm がない新規プロジェクトでは、ユーザーの依頼とプロジェクトの制約に基づいて、対象となる Watt のリリースを特定します。対象が不明確な場合は確認してください。許可されているときにプロジェクトのパッケージマネージャーを使用してそのリリースをインストールし、バンドルされているスキルを読み込みます。
• インストール済みのバージョンが 3.74.0 未満の場合、またはインストール済みの CLI が skill をサポートしていない場合は、依頼を中止し、このスキルには skill コマンドを備えた Watt 3.74.0 以降が必要であることを説明します。インストールをアップグレードしたり、外部ドキュメントで代用したり、フォールバックとして依頼されたワークフローを続行したりしないでください。
• コマンドが別の理由で失敗した場合は、skill がサポートされていない証拠として扱わず、その失敗を報告します。
• メジャーバージョン間の移行では、インストール済みのソースバージョンと移行先の対象バージョンを区別します。その移行を明示的に対象とする移行ガイドを入手してください。現在のリリースの手順だけでは、対象リリースの動作を確認できません。