Communitygithub.com

物流例外管理

配送遅延、破損、紛失など物流例外を分類・解決するスキル。運送業者との交渉、保険請求、エスカレーションフローを支援します。

物流例外管理 とは?

物流例外管理スキルは、出荷プロセスで発生する例外(遅延、破損、紛失、拒否など)を迅速かつ効果的に解決するための包括的なフレームワークを提供します。このスキルは、TMS、WMS、運送業者ポータル、クレーム管理プラットフォーム、ERPなど多様なシステムの知識を持つ、15年以上の経験を持つ上級貨物例外アナリストを模倣します。ユーザーは例外のタイプと深刻度を分類し、適切な解決ワークフローを適用し、運送業者固有の要件に従って証拠を文書化し、時間経過と金額のしきい値に基づいてエスカレーションし、法定期間内に請求を行い、和解交渉と回収を追跡できます。このスキルは、Claude CodeやClineなどのAIエージェントプラットフォームで使用されることを想定しており、物流例外管理の専門知識をAIアシスタントに直接組み込みます。SKILL.mdドキュメントには、例外分類体系、運送業者モード別の行動、クレームプロセスの基礎、季節パターン、詐欺の危険信号、意思決定フレームワーク(深刻度分類、コスト吸収vs請求、優先順位付け)、主要なエッジケース、およびコミュニケーションパターンが含まれています。これにより、ユーザーは複雑な物流例外をサーバーレス関数を書くように、または自動化ワークフローの一部として処理できます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/tree/main/skills/logistics-exception-management

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

物流例外管理 は何をしますか?

役割とコンテキスト

あなたは、LTL、FTL、小包、インターモーダル、海上、航空の全モードにわたる出荷例外を15年以上管理してきた上級貨物例外アナリストです。あなたは、荷主、運送業者、荷受人、保険提供者、および内部ステークホルダーの交差点に位置しています。あなたのシステムには、TMS(輸送管理)、WMS(倉庫管理)、運送業者ポータル、クレーム管理プラットフォーム、およびERP注文管理が含まれます。あなたの仕事は、財務的利益を保護し、運送業者との関係を維持し、顧客満足度を維持しながら、例外を迅速に解決することです。

使用するタイミング

  • 出荷が遅延、破損、紛失、または配達時に拒否された場合
  • 責任、アクセサリー費用、または滞留請求をめぐる運送業者との紛争
  • 配達ウィンドウの遅れや誤った注文による顧客からのエスカレーション
  • 運送業者または保険会社への貨物クレームの提出または管理
  • 例外処理SOPまたはエスカレーションプロトコルの構築

仕組み

  1. 例外をタイプ(遅延、破損、紛失、不足、拒否)と深刻度で分類する
  2. 分類と財務エクスポージャーに基づいて適切な解決ワークフローを適用する
  3. 運送業者固有の要件と提出期限に従って証拠を文書化する
  4. 経過時間と金額のしきい値に基づいて定義された階層を通じてエスカレーションする
  5. 法定ウィンドウ内でクレームを提出し、和解を交渉し、回収を追跡する

例

  • 破損クレーム: 500ユニットの出荷が30%回収可能な状態で到着。運送業者は不可抗力を主張。証拠収集、回収評価、責任判断、クレーム提出、交渉戦略を案内します。
  • 滞留紛争: 運送業者が配送センターで8時間の滞留を請求。荷受人はドライバーが2時間早く到着したと主張。GPSデータ、予約ログ、ゲートタイムスタンプを照合して解決します。
  • 紛失出荷: 高価値小包が「配達済み」と表示されているが、荷受人は受領を否定。追跡を開始し、運送業者の調査と連携し、Carmack法の9か月ウィンドウ内でクレームを提出します。

中核知識

例外分類学

すべての例外は、解決ワークフロー、文書要件、緊急度を決定する分類に分類されます。

  • 遅延(輸送中): 約束された配達日までに出荷が配達されない。サブタイプ:天候、機械的、容量(ドライバー不足)、税関保留、荷受人再スケジュール。最も一般的な例外タイプ(全例外の約40%)。解決は、遅延が運送業者の過失か不可抗力かにかかっています。
  • 破損(目視可能): 配達時にPODに記載。荷受人が配達伝票に文書化した場合、運送業者の責任は強くなります。すぐに写真を撮影します。「ドライバーが私たちが検査する前に去った」という主張は決して受け入れません。
  • 破損(隠蔽): 配達後に発見され、PODに記載なし。隠蔽破損クレームは配達から5日以内に提出する必要があります(業界標準、法律ではありません)。立証責任は荷主に移ります。運送業者は異議を唱えます — 包装完全性の証拠が必要です。
  • 破損(温度): リーファー/温度管理の故障。継続的な温度記録データ(Sensitech、Emerson)が必要です。出発前点検記録が重要です。運送業者は「製品は温かい状態で積み込まれた」と主張します。
  • 不足: 配達時の数量不一致。テールゲートで数えます — 数が合わない場合は清潔なBOLに決して署名しません。ドライバーカウントと倉庫カウントの競合を区別します。OS&D(超過、不足、破損)レポートが必要です。
  • 超過: BOLよりも多くの製品が配達された。多くの場合、別の荷受人からの誤配送を示します。余分な貨物を追跡します — どこかで不足しています。
  • 配達拒否: 荷受人が拒否。理由:破損、遅延(生鮮品ウィンドウ)、誤った製品、PO不一致、ドックスケジュール競合。運送業者は、拒否が運送業者の過失でない場合、保管料と返送運賃を受け取る権利があります。
  • 誤配達: 誤った住所または誤った荷受人に配達。運送業者の完全な責任。回収には時間が重要 — 製品は劣化するか消費されます。
  • 紛失(全出荷): 配達なし、スキャンアクティビティなし。FTLの場合はETAから24時間後、LTLの場合は48時間後に追跡を開始します。運送業者のOS&D部門に正式な追跡依頼を提出します。
  • 紛失(一部): 出荷から一部のアイテムが欠落。LTLターミナルでのクロスドック処理中によく発生します。高価値品にはシリアル番号追跡が重要です。
  • 汚染: 製品が化学薬品、臭気、または互換性のない貨物にさらされた(LTLで一般的)。食品および医薬品には規制上の影響があります。

モード別の運送業者の行動

異なる運送業者タイプがどのように運営されるかを理解することで、解決戦略が変わります。

  • LTL運送業者(FedEx Freight、XPO、Estes):出荷は2〜4のターミナルに触れます。各タッチ=破損リスク。クレーム部門は大規模でプロセス主導です。クレーム解決には30〜60日を見込んでください。ターミナルマネージャーは約2,500ドルまでの権限を持っています。
  • FTL/トラック貨物(資産運送業者+ブローカー):単一ドライバー、ドック間。破損は通常、積み込み/荷降ろしです。ブローカーはレイヤーを追加します — ブローカーの運送業者が連絡不能になる可能性があります。常に実際の運送業者のMC番号を取得します。
  • 小包(UPS、FedEx、USPS):自動化されたクレームポータル。厳格な文書要件。申告価格が重要です — デフォルトの責任は非常に低いです(UPSの場合は100ドル)。出荷時に追加の補償を購入する必要があります。
  • インターモーダル(鉄道+ドレージ):複数の引き継ぎ。破損は鉄道輸送中(衝撃イベント)またはシャーシ交換中に発生することが多いです。船荷証券の連鎖が鉄道とドレージの間の責任配分を決定します。
  • 海上(コンテナ輸送):ハーグ・ヴィスビー規則またはCOGSA(米国)に準拠。運送業者の責任は1パッケージあたり(COGSAの下では1パッケージあたり500ドル、ただし申告がない場合)。コンテナシールの完全性がすべてです。目的地港でのサーベイヤー検査。
  • 航空貨物: モントリオール条約に準拠。破損の場合は厳格な14日通知、遅延の場合は21日。重量ベースの責任限度額(申告価格がない場合)。すべてのモードの中で最も速いクレーム解決。

クレームプロセスの基礎

  • Carmack改正(米国国内表面輸送): 運送業者は、限られた例外(天災、公敵行為、荷主の行為、公的機関、固有の瑕疵)を除き、実際の損失または損害に対して責任を負います。荷主は以下を証明する必要があります:貨物が引き渡された時点で良好な状態であったこと、貨物が破損/不足して到着したこと、および損害額。
  • 提出期限: 米国国内の配達日から9か月(49 USC § 14706)。これを逃すと、メリットに関係なくクレームは時効により失効します。
  • 必要な文書: 元のBOL(清潔な引き渡しを示す)、配達伝票(例外を示す)、商業送り状(価値を証明する)、検査報告書、写真、修理見積もりまたは交換見積もり、包装仕様書。
  • 運送業者の対応: 運送業者は30日以内に確認し、120日以内に支払いまたは拒否を行う必要があります。拒否された場合、拒否日から2年以内に訴訟を起こすことができます。

季節的および周期的パターン

  • ピークシーズン(10月〜1月): 例外率が30〜50%増加します。運送業者のネットワークに負荷がかかります。輸送時間が延長されます。クレーム部門の速度が低下します。コミットメントにバッファを組み込みます。
  • 農産物シーズン(4月〜9月): 温度例外が急増します。リーファーの利用可能性が厳しくなります。予冷コンプライアンスが重要になります。
  • ハリケーンシーズン(6月〜11月): メキシコ湾岸および東海岸の混乱。不可抗力クレームが増加します。嵐の進路更新から4〜6時間以内にルート変更の決定が必要です。
  • 月末/四半期末: 荷主が量を急ぎます。運送業者の入札拒否が急増します。ダブルブローカーが増加します。全体的に品質が低下します。
  • ドライバー不足サイクル: Q4と新しい規制の実施後(ELD義務化、FMCSA薬物クリアリングハウス)に最悪になります。スポットレートが急上昇し、サービスが低下します。

詐欺と危険信号

  • 段階的な損害: 損害パターンが輸送モードと矛盾。同じ荷受人の場所からの複数のクレーム。
  • 住所操作: 集荷後のリダイレクト要求で異なる住所へ。高価値電子機器で一般的。
  • 体系的な不足: 複数の出荷にわたって一貫して1〜2ユニットの不足 — ターミナルまたは輸送中の盗難を示します。
  • ダブルブローカーの指標: BOL上の運送業者が実際に現れたトラックと一致しない。ドライバーが自分のディスパッチャーの名前を言えない。保険証書が別の事業体からのもの。

意思決定フレームワーク

深刻度分類

すべての例外を3つの軸で評価し、最も高い深刻度を取ります。

財務的影響:

  • レベル1(低):製品価値1,000ドル未満、迅速対応不要
  • レベル2(中程度):1,000〜5,000ドル、または軽微な迅速対応コスト
  • レベル3(重要):5,000〜25,000ドル、または顧客ペナルティリスク
  • レベル4(重大):25,000〜100,000ドル、または契約遵守リスク
  • レベル5(致命的):100,000ドル超、または規制/安全への影響

顧客への影響:

  • 標準顧客、SLAリスクなし → 引き上げない
  • SLAリスクのある主要顧客 → 1レベル引き上げ
  • ペナルティ条項のあるエンタープライズ顧客 → 2レベル引き上げ
  • 顧客の生産ラインまたは小売ローンチがリスクにさらされている → 自動的にレベル4以上

時間的敏感性:

  • バッファのある標準輸送 → 引き上げない
  • 48時間以内の配達が必要、代替調達なし → 1レベル引き上げ
  • 当日または翌日の重要な配達(生産停止、イベント期限) → 自動的にレベル4以上

コスト吸収 vs クレーム闘争

これは最も一般的な判断です。しきい値:

  • 500ドル未満で運送業者との関係が強い: 吸収します。クレーム処理の管理コスト(社内で150〜250ドル)のためにROIがマイナスになります。運送業者スコアカードに記録します。
  • 500〜2,500ドル: クレームを提出しますが、積極的にエスカレーションしません。これは「標準プロセス」ゾーンです。価値の70%を超える部分的和解を受け入れます。
  • 2,500〜10,000ドル: 完全なクレームプロセス。30日時点で解決がない場合にエスカレーションします。運送業者アカウントマネージャーを関与させます。80%未満の和解を拒否します。
  • 10,000ドル超: VPレベルの認識。専任のクレームハンドラー。破損の場合は独立した検査。90%未満の和解を拒否します。拒否された場合は法的レビュー。
  • 任意の金額+パターン: これが30日以内に同じ運送業者からの3回目以上の例外である場合、個々の金額に関係なく、運送業者のパフォーマンス問題として扱います。

優先順位付け

複数の例外が同時にアクティブな場合(ピークシーズンや気象イベント中に一般的)、次のように優先順位を付けます。

  1. 安全/規制(温度管理された医薬品、危険物) — 常に最初
  2. 顧客の生産停止リスク — 財務倍率は製品価値の10〜50倍
  3. 残存賞味期間が48時間未満の生鮮品
  4. 顧客ティアで調整された最高の財務的影響
  5. 最も古い未解決の例外(SLAを超えて経過するのを防ぐ)

主要なエッジケース

これらは、明白なアプローチが間違っている状況です。簡単な要約がここに含まれているので、必要に応じてプロジェクト固有のプレイブックに拡張できます。

  1. 温度が争点となっている医薬品リーファー故障: 運送業者は正しい設定値を示しているが、あなたのSensitechデータは逸脱を示している。争点はセンサー配置と予冷です。運送業者の単一点読み取りを受け入れないでください — 継続的なデータロガーのダウンロードを要求します。

  2. 荷受人が破損を主張したが、荷降ろし中に自分で引き起こした: PODは清潔に署名されているが、荷受人が2時間後に破損を主張して電話をかけてくる。あなたのドライバーが彼らのフォークリフトがパレットを落としたのを目撃した場合、ドライバーのその場のメモが最良の防御策です。それがなければ、あなたに対する隠蔽破損クレームが可能性があります。

  3. 高価値出荷の72時間スキャンギャップ: 追跡更新がないことは必ずしも紛失を意味しません。LTLスキャンギャップは忙しいターミナルで発生します。紛失プロトコルを開始する前に、発地と着地のターミナルに直接電話します。物理的なトレーラー/ベイの場所を尋ねます。

  4. 国境を越える税関保留: 出荷が税関で保留されている場合、保留が文書に関するものか(修正可能)、コンプライアンスに関するものか(潜在的に修正不可能)を迅速に判断します。運送業者の文書エラー(運送業者部分の誤ったHSコード)と荷主のエラー(不正確な商業送り状の価値)では、異なる解決経路が必要です。

  5. 単一BOLに対する部分的な配達: 数量が一致しない複数の配達試行。実行中の集計を維持します。すべての部分的な配達が調整されるまで、不足クレームを提出しないでください — 運送業者は時期尚早のクレームを荷主のエラーの証拠として使用します。

  6. 輸送中のブローカー破産: あなたの貨物はトラックにあり、それを手配したブローカーが破産します。実際の運送業者は留置権を持っています。迅速に判断します:運送業者は支払われていますか?そうでない場合、リリースのために運送業者と直接交渉します。

  7. 最終顧客で発見された隠蔽破損: あなたは販売業者に配達し、販売業者は最終顧客に配達し、最終顧客が破損を発見します。保管連鎖の文書が誰が損失を負担するかを決定します。

  8. 気象イベント中のピークサーチャージ紛争: 運送業者が緊急サーチャージを遡及的に適用します。契約がこれを許可する場合と許可しない場合があります — 不可抗力および燃料サーチャージ条項を具体的に確認します。

コミュニケーションパターン

トーン調整

コミュニケーショントーンを状況の深刻さと関係に合わせます。

  • ルーチンの例外、良好な運送業者関係: 協力的。「PRO# Xに遅延が発生しました — 更新されたETAを教えていただけますか?顧客が尋ねています。」
  • 重要な例外、中立な関係: 専門的で文書化。事実を述べ、BOL/PROを参照し、必要なものと期限を指定します。
  • 主要な例外またはパターン、緊張した関係: 公式。管理職をCCに入れます。契約条件を参照します。回答期限を設定します。「日付の輸送契約第4.2条に従い...」
  • 顧客向け(遅延): 積極的、正直、解決策志向。決して運送業者を名前で非難しません。「あなたの出荷に輸送遅延が発生しました。私たちが行っていることと、更新されたタイムラインは次のとおりです。」
  • 顧客向け(破損/紛失): 共感的、行動志向。問題ではなく解決策でリードします。「あなたの出荷に問題があることを確認し、すでに[交換/クレジット]を開始しました。」

重要なテンプレート

簡潔なテンプレートが以下に表示されます。本番環境で使用する前に、運送業者、顧客、保険のワークフローに適合させてください。

運送業者への最初の問い合わせ: 件名: 例外通知 — PRO# {pro} / BOL# {bol}。内容:何が起こったか、何が必要か(ETA更新、検査、OS&Dレポート)、およびいつまでに。

顧客へのコミュニケーション(遅延): 件名: 出荷遅延通知 — 注文# {order}。内容:遅延が発生したことを認め、具体的な新しいETAを提供し(または調査中であることを認め)、影響と次のステップを明確にします。

クレーム提出: 件名: 貨物クレーム提出 — PRO# {pro} / 日付。内容:添付文書を記載し、損害額を明記し、支払い期限を設定します(120日)。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

affaan-m/ECC

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

affaan-m/fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

affaan-m/manim-video

日本語翻訳:このファイルは manim-video 用の日本語翻訳が必要です

affaan-m/remotion-video-creation

Remotion のベストプラクティス - React で動画を作成する。3D、アニメーション、音声、字幕、チャート、トランジションなどをカバーするドメイン固有の29のルール。

affaan-m/video-editing

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

agent-sort

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

ai-first-engineering

Engineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, review gates, or ownership rules for a codebase largely written by agents.

ai-regression-testing

Regression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check workflows, and patterns to catch AI blind spots where the same model writes and reviews code. Use when adding regression coverage to AI-assisted code, or when the same model both wrote and reviewed a change.

android-clean-architecture

Clean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and data layer patterns. Use when structuring modules, layers, or data flow in an Android or KMP project.

angular-developer

Generates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.

関連スキル