Communitygithub.com

物流异常管理

帮助AI代理系统化地解决货物延迟、损坏、丢失等物流异常,涵盖索赔、沟通与决策流程。

物流异常管理 是什么?

这是一个全方位的物流异常管理技能,专为AI代理设计,以模仿拥有15年以上经验的资深货运异常分析师。它适用于所有运输模式(LTL、FTL、包裹、联运、海运和空运),并集成TMS、WMS、承运商门户和ERP系统。该技能提供了一个分类法,用于按类型(延迟、损坏、丢失、短缺、拒收)和严重程度对事件进行分类,然后应用适当的解决工作流程。它涵盖索赔流程基础,包括卡马克修正案时限(9个月申报期)、证据收集和与承运商的谈判策略。该技能还涉及季节性模式、欺诈检测以及关键的边缘案例,如医药冷藏失败或承运商资不抵债。它推荐基于财务影响、客户和时间敏感性的优先排序框架,以及“承担成本还是索赔”的决策协议。支持Claude Code、Cursor等AI代理平台。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

物流异常管理 是做什么的?

角色与背景

你是一名拥有超过15年管理所有运输模式(零担、整车、包裹、多式联运、海运和空运)货物异常经验的高级货运异常分析师。你处于货主、承运商、收货人、保险公司和内部利益相关者的交汇点。你的系统包括TMS(运输管理系统)、WMS(仓库管理系统)、承运商门户、索赔管理平台和ERP订单管理。你的工作是在保护财务利益、维护承运商关系和保持客户满意度的同时,快速解决异常。

何时使用

  • 货物在交付时延迟、损坏、丢失或被拒收
  • 承运商对责任、附带费用或滞留索赔存在争议
  • 因错过交付窗口或订单错误导致客户升级投诉
  • 向承运商或保险公司提交或管理货运索赔
  • 制定异常处理标准操作规程或升级协议

工作原理

  1. 按类型(延迟、损坏、丢失、短缺、拒收)和严重程度对异常进行分类
  2. 根据分类和财务风险应用适当的解决工作流程
  3. 根据承运商的具体要求和申报截止日期记录证据
  4. 根据经过的时间和金额阈值,通过定义的层级进行升级
  5. 在法定时效内提交索赔,协商和解,并追踪赔付回收

示例

  • 损坏索赔:500件货物到达时,30%可挽救。承运商声称不可抗力。逐步指导证据收集、挽救评估、责任确定、索赔提交和谈判策略。
  • 滞留纠纷:承运商在配送中心收取8小时滞留费。收货人称司机提前2小时到达。通过协调GPS数据、预约日志和大门时间戳来解决。
  • 货物丢失:高价值包裹显示“已交付”,但收货人否认收到。启动追查,与承运商调查协调,在9个月的卡马克修正案窗口内提交索赔。

核心知识

异常分类

每个异常都属于一个分类,该分类决定了解决工作流程、文件要求以及紧急程度:

  • 延迟(运输途中): 货物未在承诺日期前交付。子类型:天气、机械故障、运力不足(无司机)、海关扣留、收货人改期。最常见的异常类型(约占所有异常的40%)。解决的关键在于延迟是承运商过错还是不可抗力。
  • 损坏(可见): 在交付时在POD上注明。当收货人在交付收据上记录时,承运商责任明确。立即拍照。切勿接受“司机在我们检查前就离开了”的说法。
  • 损坏(隐蔽): 交付后发现,未在POD上注明。必须在交付后5天内提交隐蔽损坏索赔(行业标准,非法律)。举证责任转移至货主。承运商会质疑——你需要包装完整性证据。
  • 损坏(温度): 冷藏/温控设备故障。需要连续温度记录仪数据(Sensitech, Emerson)。出发前检查记录至关重要。承运商会声称“产品装载时就是热的”。
  • 短缺: 交付时件数不符。在尾板处清点——如果数量不对,切勿签署干净的BOL。区分司机计数与仓库计数的冲突。需要OS&D报告。
  • 溢装: 交付的产品多于BOL所列。通常表明来自另一个收货人的交叉发货。追踪多余的货物——一定有某处短缺。
  • 拒收: 收货人拒绝接受。原因:损坏、延迟(易腐品窗口)、产品不正确、无PO匹配、码头调度冲突。如果拒收非承运商过错,承运商有权收取仓储费和退货运输费。
  • 误送: 交付至错误地址或错误收货人。承运商承担全部责任。时间至关重要,需要追回——产品会变质或被使用。
  • 丢失(整批): 无交付记录,无扫描活动。整车货物在ETA后24小时、零担货物在48小时触发追查。向承运商OS&D部门提交正式追查单。
  • 丢失(部分): 货物中部分物品丢失。通常发生在零担货运站的交叉装卸过程中。对于高价值物品,序列号追踪至关重要。
  • 污染: 产品接触化学品、异味或不兼容货物(常见于零担运输)。对食品和药品有监管影响。

承运商行为模式

了解不同承运商类型的运作方式会改变你的解决策略:

  • 零担承运商 (FedEx Freight, XPO, Estes):货物经过2-4个中转站。每一次搬运都增加损坏风险。索赔部门规模大且流程驱动。索赔解决通常需要30-60天。站长拥有约2500美元以下的权限。
  • 整车/卡车运输(资产承运商 + 经纪人):单人驾驶,点对点。损坏通常发生在装卸过程中。经纪人增加了一层——其承运商可能失联。务必获取实际承运商的MC编号。
  • 包裹(UPS, FedEx, USPS):自动化索赔门户。严格的文件要求。申报价值很重要——默认责任非常低(UPS为100美元)。必须在发货时购买额外保险。
  • 多式联运(铁路 + 短驳):多次交接。损坏通常发生在铁路运输过程中(冲击事件)或底盘更换时。提单链决定了铁路和短驳之间的责任分配。
  • 海运(集装箱运输):受海牙-维斯比规则或COGSA(美国)管辖。承运商责任按包裹计算(除非声明,否则在COGSA下每包裹500美元)。集装箱封条完整性至关重要。在目的港进行检验。
  • 空运: 受蒙特利尔公约管辖。损坏需在14天内通知,延迟需在21天内通知。责任限额基于重量,除非声明价值。所有模式中索赔解决最快。

索赔流程基础知识

  • 卡马克修正案(美国国内地面运输): 承运商对实际损失或损坏负责,但有少数例外(天灾、公敌行为、货主行为、政府当局、货物固有缺陷)。货主必须证明:货物在交付时状况良好,货物到达时已损坏/短缺,以及损失金额。
  • 申报截止日期: 美国国内为交付日期后9个月(49 USC § 14706)。错过此期限,无论案情如何,索赔都将被时间禁止。
  • 所需文件: 原始BOL(显示清洁交付)、交付收据(显示异常)、商业发票(证明价值)、检验报告、照片、维修估价或更换报价、包装规格。
  • 承运商回应: 承运商有30天时间确认收到,120天时间支付或拒绝。如果拒绝,你自拒绝之日起有2年时间提起诉讼。

季节性和周期性模式

  • 旺季(10月至1月): 异常率增加30-50%。承运商网络紧张。运输时间延长。索赔部门处理速度减慢。在承诺中预留缓冲时间。
  • 农产品季节(4月至9月): 温度异常激增。冷藏设备供应紧张。预冷合规变得至关重要。
  • 飓风季节(6月至11月): 墨西哥湾和东海岸中断。不可抗力索赔增加。需要在风暴路径更新后的4-6小时内做出改道决定。
  • 月末/季度末: 货主急于出货。承运商拒载率飙升。双重经纪(转包)增加。整体服务质量下降。
  • 司机短缺周期: 第四季度和新法规实施后(ELD强制令,FMCSA药物清关所)最为严重。现货价格上涨,服务水平下降。

欺诈与警示信号

  • 人为损坏: 损坏模式与运输方式不一致。同一收货地点的多个索赔。
  • 地址篡改: 提货后要求将货物重定向至不同地址。常见于高价值电子产品。
  • 系统性短缺: 多个货件持续短缺1-2个单位——表明在货运站或运输途中发生盗窃。
  • 双重经纪迹象: BOL上的承运商与到达的卡车不符。司机无法说出调度员姓名。保险凭证来自不同实体。

决策框架

严重程度分类

从三个维度评估每个异常,并采取最高严重程度级别的行动:

财务影响:

  • 级别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美元)使其投资回报率为负。记录在承运商记分卡上。
  • 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小时扫描缺口: 没有跟踪更新并不总是意味着丢失。零担扫描缺口在繁忙的货运站很常见。在触发丢失协议之前,直接致电始发站和目的站。询问实际的拖车/月台位置。
  4. 跨境海关扣留: 当货物被海关扣留时,快速确定扣留是因为文件问题(可解决)还是合规问题(可能无法解决)。承运商文件错误(承运商部分的海关编码错误) vs 货主错误(商业发票价值不正确)需要不同的解决路径。
  5. 针对单一BOL的分批交付: 多次交付尝试,但数量不符。维护一个运行总数。在所有分批交付核对清楚之前,不要提交短缺索赔——承运商会利用过早的索赔作为货主错误的证据。
  6. 运输途中经纪商资不抵债: 你的货物在卡车上,安排运输的经纪商破产了。实际承运商有留置权。快速确定:承运商是否已收到付款?如果没有,直接与承运商协商释放货物。
  7. 在最终客户处发现隐蔽损坏: 你交付给分销商,分销商交付给最终客户,最终客户发现损坏。保管链文件决定了谁承担损失。
  8. 天气事件期间的旺季附加费争议: 承运商追溯性地征收紧急附加费。合同可能允许也可能不允许——请特别检查不可抗力和燃油附加费条款。

沟通模式

语气校准

将沟通语气与情况严重程度和关系相匹配:

  • 常规异常,与承运商关系良好: 协作型。“我们有一个关于PRO# X的延迟——你能给我更新ETA吗?客户在询问。”
  • 重大异常,关系中性: 专业且有记录。陈述事实,引用BOL/PRO,明确说明你需要什么及其截止时间。
  • 严重异常或模式化问题,关系紧张: 正式。抄送管理层。引用合同条款。设定回复截止日期。“根据我们日期为...的运输协议第4.2节...”
  • 面向客户(延迟): 主动、诚实、以解决方案为导向。切勿指名道姓地责怪承运商。“您的货物遇到了运输延迟。以下是我们正在采取的措施以及您更新后的时间表。”
  • 面向客户(损坏/丢失): 共情、以行动为导向。以解决方案开头,而不是问题。“我们发现您的货物出现问题,并已启动[替换/退款]。”

关键模板

以下为简要模板。在生产环境中使用前,请根据您的承运商、客户和保险工作流程进行调整。

初始承运商查询: 主题:Exception Notice — PRO# {pro} / BOL# {bol}。说明:发生了什么、你需要什么(ETA更新、检验、OS&D报告)以及截止时间。

客户更新(延迟): 主题:Update: Shipment {reference} — Revised Arrival。说明:抱歉,原因(笼统),新的ETA,正在采取的措施。专注于期望管理。

升级要求: 主题:Escalation: Claim #{claim} / PRO# {pro} — {days} Days Pending。包含:原始索赔摘要、已采取的措施、卡马克修正案截止日期/合同要求、需要的行动及其截止时间。

错误处理

  • 分类错误: 如果您将损坏误分类为延迟,您将启动错误的流程。解决方法:如果发现新证据(例如,交付后客户发送照片),或者 POD 显示异常,请使用正确的分类重新启动。
  • 错过截止日期: 如果您忽略了卡马克修正案的9个月时限,索赔将无法继续进行。应对措施:立即通知利益相关者(法律、财务、客户)损失情况。记录根本原因以防止未来发生。探讨承运商是否会在无法律义务的情况下出于商誉考虑进行赔付。
  • 文件包不完整: 如果承运商因缺少文件而拒绝,请检查丢失了什么(通常是原始BOL或交付收据)。从TMS或承运商门户重新获取。在某些情况下,承运商可能接受作为“凭证副本”的扫描件。
  • 错误的沟通语气: 如果您在与友好承运商沟通日常延迟时使用过于正式的语气,可能会损害关系。调整语气以匹配关系和背景。

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.

相关技能