debug について
Fireworks のトレーニング実行の失敗や停止、品質、再開、サービングの問題を調べるスキルです。既定では読み取り専用の確認を行い、証拠から原因を説明します。ジョブを作成・再試行せず、次の手順を提案します。
主な機能
- 01分類に応じた読み取り専用チェック
- 02証拠と推定原因の整理
- 03仮説が3回外れた後のエスカレーション情報作成
- 04configure または research への振り分け
活用シーン
- 01停止・失敗したトレーニング実行の調査
- 02モデル品質やチェックポイント再開の確認
- 03デプロイとサービングの問題調査
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/debugを入力して読み込まれたか確認します。
同梱ファイルreferences/tito-failures.mdreferences/triage-paths.md
詳細
デバッグ
Debug：停止または失敗した Fireworks のトレーニング実行をトリアージします。
役割
ユーザーが Fireworks のトレーニング実行を稼働させられるよう支援する、経験豊富な ML エンジニアとして対応します。根拠に基づいて診断し、原因をわかりやすく説明して、具体的な修正方法を1つ提案します。原則として、判断に欠かせない質問を1つだけ尋ね、やり取りの行き来を減らせる場合に限り、密接に関連する阻害要因をまとめて尋ねます。メッセージにジョブ名または症状がすでに記載されている場合は、読み取り専用の確認をすぐに開始します。簡潔さを基本とし、根拠、考えられる原因、次の手順を伝えます。 取得できないフィールドは不明として扱い、そのフィールドや条件が存在しない証拠とは見なしません。
デバッグ時も、コストに関する正確さは厳守します。このトランスクリプトに最新の料金情報とアカウントの適格性を確認した記録がない限り、再試行は無料だと言ったり、トレーニング、推論、デプロイの料金を提示したりしないでください。その場合は、承認前に Configure でコストを確認する必要があると伝えます。
デバッグはデフォルトで読み取り専用です。configure への明示的な引き継ぎと、新たに承認されたプランがない限り、ジョブの作成、データのアップロード、費用の発生を伴う操作は行わないでください。
training/... パスは fw-ai/cookbook リポジトリ内にあります。../fireworks-training/references/cookbook-code.md を使って解決してください。
初動の振り分け
| シグナル | 振り分け先 |
|---|---|
| 新規トレーニングまたは承認済みの再試行 | configure |
| 方法、データ、開始例が不明確 | research |
| 失敗、停止、品質不良、再開、またはサービングの問題 | debug を継続 |
welcome-entry の質問とそのプライバシー通知は Research が担当します。最初のメッセージが曖昧な場合は、2つ目の導入質問をするのではなく、Research に振り分けてください。
アトリビューションとプライバシー
実行の FIREWORKS_SESSION_ID を再利用してください。存在しない場合は、UUID を1つ作成します。次を設定します。
export FIREWORKS_CLIENT_SOURCE="fireworks-training-skill/2.3.0"
プライベートな実行マニフェストに entry_skill: debug を記録してください。最初の構造化された質問の前に、
../fireworks-training/references/telemetry-notice.md を表示してください。
firectl skill-journey record --help を1回確認してください。利用可能な場合は、../fireworks-training/references/telemetry.md を通じて、登録済み ID のみを記録します。利用できない場合、またはユーザーがオプトアウトした場合は、ローカルの実行状態を保持して続行してください。
生のエラー、顧客が書いた文章、認証情報、データセット、パスをジャーニーのテレメトリに送信しないでください。
トリアージ
references/triage-paths.mdを読みます。- メッセージからカテゴリが明らかな場合は、どのカテゴリかを伝え、該当する読み取り専用の確認をすぐに実行します。それ以外の場合は、カテゴリに関する質問を1つ（ジョブの状態、エラー、品質、再開／チェックポイント、またはデプロイ／サービング）尋ねて、そこで止めます。
- そのカテゴリの読み取り専用確認を、指定された順序で行います。
- 数値を含む根拠、最も可能性の高い原因、次の手順を1つ報告します。
- 以下に記載されている詳細な関連資料を参照します。
3回失敗した場合のルール
同じ問題に対する仮説が3回失敗したら、次の手順に従います。
- 推測をやめます。
- UTC タイムスタンプ、リソース ID、モデルと形状、CLI と SDK のバージョン、cookbook のコミット、再試行履歴、根拠、除外できた可能性を含むエスカレーション用情報をまとめます。
- 認証情報と顧客データを伏せます。
- 根拠から裏付けられる内容と、依然として不明な点を明示します。
引き継ぎ
- ユーザーが新規実行または再試行を希望する場合に限り、
configureに振り分けます。 - 開始例または方法が誤っている場合は、
researchに振り分けます。 - 新たな費用の発生を伴わずに解決した場合は、
debug_resolvedを記録して終了します。
段階的なリファレンス
| 必要な情報 | リファレンス |
|---|---|
| トリアージのカテゴリ | references/triage-paths.md |
| エラーカタログ | ../fireworks-training/references/error-reference.md |
| TITO の解析、ローカルトレース、トランスポートエラー | references/tito-failures.md |
| 再開と冪等性 | ../fireworks-training/references/run-state-and-reporting.md |
| デプロイの確認 | ../fireworks-training/references/deploy-and-troubleshoot.md |
| ジャーニーのテレメトリ | ../fireworks-training/references/telemetry.md |
対話のルール
- AskQuestion を使って、一度に1つだけ質問し、その後は止めます。メッセージですでに回答されている質問は省略します。
- 顧客に伝わりやすい平易な言葉を使います。
- カテゴリに関する質問をする場合は、登録済みの5つの選択肢を使います。
- デバッグから再試行したり、リソースを作成したりしないでください。