steel-session-debugging

Steel セッションのデバッグ

スキルの適用範囲

Steel セッションが失敗した際に何が起きたのか、次に何を変更すべきかを説明するために、このスキルを使用します。推測ではなく、証拠から始めてください。

ボット検出の緩和、プロキシ戦略、CAPTCHA 戦略、ログインの信頼性、リトライポリシーについては、このスキルを主な調査先として使用しないでください。証拠がこれらの問題を示している場合は、十分な証拠を集めて steel-reliability に引き継いでください。

セットアップの確認

1. ユーザーが Steel のセッション ID、またはセッションを特定するのに十分な情報を提供していることを確認します。
2. CLI 認証または API アクセスに不確かな点がある場合は、steel doctor --preflight を実行します。
3. 生の API 呼び出しよりも、Steel CLI の診断を優先します。
4. ローカルの成果物は .steel-debug/ の下に作成します。ユーザーから求められない限り、生のログをチャットに貼り付けないでください。

調査ワークフロー

1. セッションのメタデータ、ブラウザーログ、生のエージェントログ、セマンティックエージェントトレース、ビューアー／リプレイのリンクを収集します。
2. 要約する前に、Cookie、ベアラートークン、API キー、パスワード、フォームの値、明らかな個人情報（PII）をマスキングします。
3. タイムラインを作成します。セッションの作成、ページ遷移、操作、待機、コンソールエラー、失敗したリクエスト、CAPTCHA／プロキシの兆候、最終状態を記録します。
4. references/failure-taxonomy.md の分類に基づいて、失敗を分類します。
5. 証拠に基づく診断と、最小限で有効な検証手順を提示します。
6. 修正にボット検出、プロキシ、CAPTCHA、ID、処理間隔、ログイン状態の維持が関わる場合は、steel-reliability に引き継いでください。

出力形式

Diagnosis:
- What happened:
- Most likely cause:
- Evidence:
- What to change:
- Verification step:
- Confidence:

便利なコマンド

steel --json sessions get <session-id>
steel --json sessions logs <session-id>
steel --json sessions agent-logs <session-id>
steel --json sessions traces <session-id>
node scripts/collect-session-debug.mjs <session-id>
node scripts/redact-session-debug.mjs .steel-debug/<session-id>/bundle.json
node scripts/summarize-session-debug.mjs .steel-debug/<session-id>/redacted-bundle.json

リファレンス

• references/investigation-workflow.md：詳細な収集およびタイムライン作成の手順です。
• references/log-event-types.md：メタデータ、ブラウザーログ、生のエージェントログ、トレースを区別する方法です。
• references/agent-traces.md：セマンティックエージェントトレースのイベントの読み方です。
• references/network-forensics.md：リクエストの失敗、リダイレクト、ブロックページの証拠について説明します。
• references/replay-and-screenshots.md：ビューアー、プレーヤー、HLS、スクリーンショットの使用方法です。
• references/failure-taxonomy.md：標準的な失敗の分類です。
• references/reliability-handoff.md：steel-reliability を読み込むタイミングについて説明します。