Multipart Upload

概要

大容量ファイルのマルチパートアップロードを専門とするスキル。 ネットワークの不安定性を前提とした堅牢なファイル転送を設計し、 チャンク分割、リトライ、進捗追跡、チェックサム検証を統合的に提供する。

ワークフロー

Phase 1: 要件分析と設計方針決定

目的: アップロード要件を分析し、最適な設計方針を決定

参照エージェント: agents/requirements-analysis.md

アクション:

1. references/basics.md でマルチパートアップロードの基本概念を理解
2. ファイルサイズとネットワーク環境を確認
3. references/chunk-strategies.md でチャンクサイズ戦略を選定
4. scripts/analyze-upload-config.mjs で設定の妥当性を検証

Phase 2: 実装

目的: チャンク分割、リトライ、進捗追跡機能を実装

参照エージェント: agents/implementation.md

アクション:

1. references/patterns.md で実装パターンを確認
2. assets/chunk-uploader-template.ts をベースに実装
3. references/progress-tracking.md で進捗表示を実装
4. references/checksum-verification.md でデータ整合性検証を追加

Phase 3: 検証

目的: アップロード機能の検証と最適化

参照エージェント: agents/validation.md

アクション:

1. scripts/validate-upload.mjs でチェックサム検証
2. 中断再開機能のテスト
3. ネットワーク障害時のリトライ動作確認
4. scripts/log_usage.mjs で実行記録を保存

リソース参照

参照ドキュメント

エージェント

スクリプト

テンプレート

ベストプラクティス

すべきこと

• ファイルサイズに応じたチャンクサイズの動的決定
• 各チャンクのチェックサム検証
• 中断再開可能な状態管理
• リトライ時の指数バックオフ
• 進捗のリアルタイム表示
• ネットワーク状況に応じた並列数調整

避けるべきこと

• 固定チャンクサイズの使用（ファイルサイズ無視）
• リトライなしのアップロード
• 進捗情報なしの長時間アップロード
• チェックサム検証の省略
• 状態管理なしの大容量アップロード