threadwave-preflight

ThreadWave 事前チェック

唯一必須となる事前チェック、セットアップ、復旧の契約を担います。リリースインデックスに記載されたすべての操作スキルは、tw コマンドを実行する前に、このスキルを名前で呼び出します。threadwave-error-support は、失敗後の分類、解決策の検索、レポートの生成を担います。

greeting-balance モードは、唯一の軽量な例外です。スターターメニュー用に、契約で定められた固定の tw credits --format json 照会だけを実行し、更新確認と準備状況の確認を省略して、残高または利用不可を返します。修復は行いません。

必須フロー

references/preflight-contract.md を最後まで読んでください。呼び出し元が greeting-balance または issue-report-only モードを選択していない限り、新しい ThreadWave タスクを開始するたびに、そのスキルの更新確認と通常の CLI 事前チェックを実行します。レシート対応 CLI は、ローリング非アクティブ時間が 12 時間未満の間は永続的な準備状況／機能レシートを再利用し、古くなった場合や無効化された場合は完全なチェックを実行します。サポート対象の CLI 結果に data.readiness_reuse が含まれない場合は、レガシーの完全チェックモードを選択します。通常の事前チェックはすでに完全なチェックであるため、このモードでは --force を決して呼び出さないでください。レビューの判断だけでは、新しいタスクの開始とはなりません。

最初の CLI 準備状況確認を呼び出す前に、契約で定められたプラットフォーム呼び出しアダプターを選択し、以降も使用してください。Windows のパッケージ版インストールでは、固定の準備状況確認用テンプレートに限り、絶対パスで指定したシステムの cmd.exe と正規の管理対象 tw.cmd を使用します。バージョンディレクトリ内の tw.exe は呼び出さず、ユーザーコンテンツを cmd.exe /c に挿入することもありません。

パッケージ版 Windows の準備状況確認後、動的な値を含む後続コマンドでは、契約で定められた引数ごとに分離されるプロセス形式を使用します。PowerShell／.NET ホストでは、これは ProcessStartInfo.ArgumentList を意味します。& tw.cmd @args、Start-Process -ArgumentList、および手動で組み立てた Arguments や /c 文字列は禁止されています。これらの方法では、ひとつの論理値が分割されたり、別の意味に解釈されたりする可能性があるためです。

ネイティブ Windows の Codex ホストでは、最初の呼び出しから、すでに利用可能なサンドボックス外のローカルプロセス機能を使って、これらの固定された準備状況確認用テンプレートを実行します。サンドボックス内で探ったり、この実行境界をユーザーに承認または選択させたりしてはいけません。これは管理者権限や UAC による昇格ではなく、閉じたコマンドマッピングを広げることもありません。

一方向の依存関係は次のとおりです。

twitter operation skill -> threadwave-preflight -> threadwave-update
failed workflow -> threadwave-preflight -> threadwave-error-support

事前チェック中に操作スキルを呼び出してはいけません。チェックに合格したら、準備状況を呼び出し元のスキルに返してください。issue-report-only モードにルーティングする場合は、threadwave-update を再度呼び出さないでください。

セットアップの担当範囲

必須のスキル、CLI、または Chrome 拡張機能モジュールが見つからないか、互換性がない場合は、元のリクエストを保持し、次を使用してください。

https://www.threadwave.xyz/cli/setup/agent.md

サポート対象の旧バージョンのスキルまたは CLI は、処理を妨げるものではありません。ユーザーがこのエージェントセッションで、まったく同じ提示バージョンについてすでに決定していない場合に限り、ローカライズした選択肢を 1 つ提示してください。選択肢は、インストール済みのバージョンで続行するか、今すぐ更新するかです。発端となった機能のゲートを通過した後にのみ続行してください。

ガイドの対象は影響を受けるコンポーネントに限定してください。スキルの不足、互換性の問題、または承認済みのスキル更新では skills_only を使用し、CLI インストーラー、tw update、tw setup、デーモンの修復、ネイティブホストの登録は決して実行しないでください。CLI のみを更新する場合は cli_only を使用し、スキルを取得またはインストールしないでください。両方の更新が必要な場合は skills_and_cli を使用してください。これらのラベルはコンポーネントの対象範囲を示すものであり、インストール手順を示すものではありません。full_setup は初回セットアップ、またはコアランタイムの準備状況が不明・未確認の場合に限って使用してください。

ユーザーが更新を承認した場合は、選択したコンポーネントと現在のホストに対応するダウンロード参照先としてガイドを使用してください。利用可能な読み取りツールから適切なものを選び、適切なインストール方法を採用してください。https://www.threadwave.xyz/cli/setup の HTML 版は Markdown ガイドと同等です。ツールで可能な範囲で、取得とインストールは自身で対応し、必要な場合にのみ支援を求めてください。更新後は、契約で定められた 1 つの事前確認を実行し、保持していたリクエストに戻ってください。レガシーモードの場合、または CLI バージョン、インストールモード、アダプター、ランチャーが変更された場合は通常の事前確認を使用してください。同じ確認済みのレシート対応 CLI の場合に限り、強制事前確認を使用してください。ユーザーの権限、サインイン、支払いは、引き続きユーザー自身が管理します。セットアップや更新が成功しても、戦略、コンテンツ、投稿、返信、その他の X 上での変更が承認されたことにはなりません。

言語

英語と簡体字中国語のリクエストに対応してください。ユーザーが明示した希望を最優先し、次に最新のメッセージ、その次に会話の言語を基準とし、どれも該当しない場合は英語を既定としてください。スキル名、コマンド、JSON キー、参照名、スキーマ、安定したエラーコードは英語のままにしてください。投稿や返信の正確な内容は、決して翻訳したり表記を統一したりしないでください。

エラーサポートへの引き継ぎ

エラーへの直接的な対応、解決策の検索、レポートの作成を求めるリクエストでは、事前確認なしで threadwave-error-support を有効にしてください。レポート対象となる可能性のあるワークフローの失敗が発生した場合は、ワークフローを停止し、事前確認の契約で定義されたサニタイズ済みの引き継ぎフィールドのみを渡してください。

問題報告のみのモードは、互換性のための経路としてのみ維持します。このモードでは、すでにサニタイズ済みの診断メタデータを受け取り、更新・事前確認のループを省略して、ペイロードを別の threadwave-error-support タスク 1 件に引き渡します。タスクを作成できない場合は、貼り付けて使える引き継ぎ情報を 1 件返してください。ここでは、分類、検索、レポートの表示、再試行、失敗したワークフローの再開を行わないでください。

返却形式

State: <ready | waiting for you | blocked>
Completed: <verified checks or safe repairs>
Versions: <every roster skill's confirmed version>
Preflight: <skills / updates / CLI / setup / selected capability>
Problem: <stable code and localized meaning>
Waiting for you: <one user-owned action>
Next: <return to the originating skill or one setup action>
Error support: <separate task created | pasteable handoff | not needed>