competition-file-parser-chain

競技ファイルパーサーチェーン

このスキルは、$ctf-sandbox-orchestrator がすでに有効になっており、サンドボックスの前提、ノードの所有権、証拠の優先順位が確立されている場合にのみ、下流の専門化として使用してください。まだそれが行われていない場合は、まず $ctf-sandbox-orchestrator に戻ってください。

このスキルは、ファイルをイングレスから、重要なすべてのパーサー、エクストラクター、コンバーター、またはデシリアライザーの境界を通して追跡することが難しい部分である場合に使用してください。

ユーザーが明示的に英語を要求しない限り、簡体字中国語で回答してください。

クイックスタート

1. 元のアップロードと、そこから派生したすべての成果物を個別に保存します。
2. チェーンを順番にマッピングします: イングレス、一時ストレージ、アーカイブ展開、フォーマット変換、パーサー呼び出し、デシリアライズ、および最終コンシューマー。
3. 何かを変更する前に、ファイル名、MIME の推定、拡張子、一時パス、パーサーの選択を記録します。
4. クライアントから見える検証と、バックエンドのパーサーの動作を分離します。
5. 決定的な分岐または成果物を生み出す、最小のファイル処理チェーンを再現します。

ワークフロー

1. ファイルのイングレスと派生をマッピングする

• リクエストの形状、multipart 名、コンテンツタイプ、ファイル名、一時パス、アップロードのステージング、ストレージキーを記録します。
• すべての派生成果物を記録します: 展開されたアーカイブメンバー、変換されたプレビュー、生成されたサムネイル、一時ドキュメント、またはデシリアライズされたオブジェクト。
• 元のファイルと各派生ファイルに個別のラベルを付けます。

2. パーサーと変換の境界を追跡する

• 各ステップでどのパーサー、コンバーター、エクストラクター、またはデシリアライザーが実行されるかを示します。
• 拡張子、MIME、マジックバイト、スキーマ、アーカイブメンバー名、または埋め込みメタデータによって駆動される、パーサー固有の決定を記録します。
• パースの成功、プレビューの成功、変換の成功、およびビジネスロジックの受け入れを区別します。

3. 決定的なファイルチェーンまで削減する

• 結果を最小のシーケンスに圧縮します: アップロード -> 派生成果物 -> パーサー境界 -> 結果として生じる影響。
• 決定的な弱点が、アーカイブ処理、MIME 推論、ファイル変換、パス解決、またはデシリアライズのどこにあるかを明確に述べます。
• エンキュー後にチェーンが主に一般的な非同期ワーカーの問題になる場合は、より厳密なキューまたはワーカーのスキルに引き継ぎます。

このリファレンスを読む

• イングレスチェックリスト、パーサーチェックリスト、および証拠のパッケージングについては、references/file-parser-chain.md を読み込んでください。

保持すべきもの

• 元のアップロード、派生ファイル、一時パス、ストレージキー、パーサー名、および変換ステップ
• バックエンドの動作がユーザーから見える検証から逸脱する正確な境界
• 決定的な影響に到達する、再現可能な最小のファイル処理シーケンス