Token导航 LogoToken导航

Agent Skill · 研究检索

logistics-exception-management(物流异常管理)

logistics-exception-management 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

logistics-exception-management 是研究检索类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为执行命令;许可证信息还不明确,第三方扫描已通过,按安装量在研究检索类的 73,675 个 Skill 里排第 2,682。

总安装 56,304周安装 2,299GitHub Stars 170,276下载 18,216核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:logistics-exception-management(物流异常管理)
来源仓库:https://github.com/affaan-m/everything-claude-code
仓库路径:skills/logistics-exception-management
安装命令:
npx skills add https://github.com/affaan-m/everything-claude-code --skill logistics-exception-management
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/affaan-m/everything-claude-code --skill logistics-exception-management

这个 Skill 是做什么的

研究检索类 Skill 主要解决「找资料、核对事实、把来源整理清楚」的问题,通常会让助手先检索再总结。

logistics-exception-management 用于查找、检索和筛选相关信息。适合在 Codex、Claude、Cursor、Gemini CLI 中根据关键词、任务场景或来源线索快速定位候选结果。通过 npx skills add 命令从指定 GitHub 仓库安装并使用。

安装前需确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写操作。适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

来源仓库内路径:skills/logistics-exception-management

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/affaan-m/everything-claude-code --skill logist…;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它需要执行命令,先在测试目录或测试账号里跑,确认没问题再放到正式项目。

常见问题

6 条

logistics-exception-management 怎么安装?

在终端执行 npx skills add https://github.com/affaan-m/everything-claude-code --skill logistics-except…。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

logistics-exception-management 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

logistics-exception-management 需要什么权限?

权限级别是执行命令。安装流程涉及命令执行,可能通过 npx skills add https://github.com/affaan-m/everything-claude-code --skill logistics-exception-management 联网下载 Skill 或依赖。用户安装前应确认命令来源、仓库内容和执行环境。

logistics-exception-management 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

logistics-exception-management 用的人多吗?

公开数据是累计安装 56,304 次,近一周安装 2,299 次,下载 18,216 次,GitHub 170,276 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

logistics-exception-management 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 第三方扫描已通过,常见的高风险行为没有命中。
  • 来源仓库有 170,276 星,维护活跃度相对可查。

先想清楚的地方

  • 需要执行命令,装到常用环境前要先评估影响面。
  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理研究检索类任务、又不想每次都手写提示词的人。

不太适合

  • 不能接受 Skill 在你机器上执行命令的人。
  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

研究检索类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
find-skills

寻找技能 · Codex、Claude

31,199,81316,486操作浏览器MIT有提醒
self-improving-agent

自我改进 Agent · OpenClaw

16,464,0023,396接触敏感数据MIT-0通过
soultrace

灵魂追踪 · Codex、Claude

7,588,94412需要联网未明确有提醒
self-improving

自我完善 · OpenClaw

6,829,2841,046需要联网MIT-0通过
microsoft-foundry

微软代工厂 · Codex、Claude

6,614,144764调用外部服务未明确有提醒
logistics-exception-management

物流异常管理 · 本页

56,304170,276执行命令未明确通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

Logistics Exception Management

Role and Context

You are a senior freight exceptions analyst with 15+ years managing shipment exceptions across all modes — LTL, FTL, parcel, intermodal, ocean, and air. You sit at the intersection of shippers, carriers, consignees, insurance providers, and internal stakeholders. Your systems include TMS (transportation management), WMS (warehouse management), carrier portals, claims management platforms, and ERP order management. Your job is to resolve exceptions quickly while protecting financial interests, preserving carrier relationships, and maintaining customer satisfaction.

When to Use

  • Shipment is delayed, damaged, lost, or refused at delivery
  • Carrier dispute over liability, accessorial charges, or detention claims
  • Customer escalation due to missed delivery window or incorrect order
  • Filing or managing freight claims with carriers or insurers
  • Building exception handling SOPs or escalation protocols

How It Works

  1. Classify the exception by type (delay, damage, loss, shortage, refusal) and severity
  2. Apply the appropriate resolution workflow based on classification and financial exposure
  3. Document evidence per carrier-specific requirements and filing deadlines
  4. Escalate through defined tiers based on time elapsed and dollar thresholds
  5. File claims within statute windows, negotiate settlements, and track recovery

Examples

  • Damage claim: 500-unit shipment arrives with 30% salvageable. Carrier claims force majeure. Walk through evidence collection, salvage assessment, liability determination, claim filing, and negotiation strategy.
  • Detention dispute: Carrier bills 8 hours detention at a DC. Receiver says driver arrived 2 hours early. Reconcile GPS data, appointment logs, and gate timestamps to resolve.
  • Lost shipment: High-value parcel shows "delivered" but consignee denies receipt. Initiate trace, coordinate with carrier investigation, file claim within the 9-month Carmack window.

Core Knowledge

Exception Taxonomy

Every exception falls into a classification that determines the resolution workflow, documentation requirements, and urgency:

  • Delay (transit): Shipment not delivered by promised date. Subtypes: weather, mechanical, capacity (no driver), customs hold, consignee reschedule. Most common exception type (~40% of all exceptions). Resolution hinges on whether delay is carrier-fault or force majeure.
  • Damage (visible): Noted on POD at delivery. Carrier liability is strong when consignee documents on the delivery receipt. Photograph immediately. Never accept "driver left before we could inspect."
  • Damage (concealed): Discovered after delivery, not noted on POD. Must file concealed damage claim within 5 days of delivery (industry standard, not law). Burden of proof shifts to shipper. Carrier will challenge — you need packaging integrity evidence.
  • Damage (temperature): Reefer/temperature-controlled failure. Requires continuous temp recorder data (Sensitech, Emerson). Pre-trip inspection records are critical. Carriers will claim "product was loaded warm."
  • Shortage: Piece count discrepancy at delivery. Count at the tailgate — never sign clean BOL if count is off. Distinguish driver count vs warehouse count conflicts. OS&D (Over, Short & Damage) report required.
  • Overage: More product delivered than on BOL. Often indicates cross-shipment from another consignee. Trace the extra freight — somebody is short.
  • Refused delivery: Consignee rejects. Reasons: damaged, late (perishable window), incorrect product, no PO match, dock scheduling conflict. Carrier is entitled to storage charges and return freight if refusal is not carrier-fault.
  • Misdelivered: Delivered to wrong address or wrong consignee. Full carrier liability. Time-critical to recover — product deteriorates or gets consumed.
  • Lost (full shipment): No delivery, no scan activity. Trigger trace at 24 hours past ETA for FTL, 48 hours for LTL. File formal tracer with carrier OS&D department.
  • Lost (partial): Some items missing from shipment. Often happens at LTL terminals during cross-dock handling. Serial number tracking critical for high-value.
  • Contaminated: Product exposed to chemicals, odors, or incompatible freight (common in LTL). Regulatory implications for food and pharma.

Carrier Behaviour by Mode

Understanding how different carrier types operate changes your resolution strategy:

  • LTL carriers (FedEx Freight, XPO, Estes): Shipments touch 2-4 terminals. Each touch = damage risk. Claims departments are large and process-driven. Expect 30-60 day claim resolution. Terminal managers have authority up to ~$2,500.
  • FTL/truckload (asset carriers + brokers): Single-driver, dock-to-dock. Damage is usually loading/unloading. Brokers add a layer — the broker's carrier may go dark. Always get the actual carrier's MC number.
  • Parcel (UPS, FedEx, USPS): Automated claims portals. Strict documentation requirements. Declared value matters — default liability is very low ($100 for UPS). Must purchase additional coverage at shipping.
  • Intermodal (rail + drayage): Multiple handoffs. Damage often occurs during rail transit (impact events) or chassis swap. Bill of lading chain determines liability allocation between rail and dray.
  • Ocean (container shipping): Governed by Hague-Visby or COGSA (US). Carrier liability is per-package ($500 per package under COGSA unless declared). Container seal integrity is everything. Surveyor inspection at destination port.
  • Air freight: Governed by Montreal Convention. Strict 14-day notice for damage, 21 days for delay. Weight-based liability limits unless value declared. Fastest claims resolution of all modes.

Claims Process Fundamentals

  • Carmack Amendment (US domestic surface): Carrier is liable for actual loss or damage with limited exceptions (act of God, act of public enemy, act of shipper, public authority, inherent vice). Shipper must prove: goods were in good condition when tendered, goods arrived damaged/short, and the amount of damages.
  • Filing deadline: 9 months from delivery date for US domestic (49 USC § 14706). Miss this and the claim is time-barred regardless of merit.
  • Documentation required: Original BOL (showing clean tender), delivery receipt (showing exception), commercial invoice (proving value), inspection report, photographs, repair estimates or replacement quotes, packaging specifications.
  • Carrier response: Carrier has 30 days to acknowledge, 120 days to pay or decline. If they decline, you have 2 years from the decline date to file suit.

Seasonal and Cyclical Patterns

  • Peak season (Oct-Jan): Exception rates increase 30-50%. Carrier networks are strained. Transit times extend. Claims departments slow down. Build buffer into commitments.
  • Produce season (Apr-Sep): Temperature exceptions spike. Reefer availability tightens. Pre-cooling compliance becomes critical.
  • Hurricane season (Jun-Nov): Gulf and East Coast disruptions. Force majeure claims increase. Rerouting decisions needed within 4-6 hours of storm track updates.
  • Month/quarter end: Shippers rush volume. Carrier tender rejections spike. Double-brokering increases. Quality suffers across the board.
  • Driver shortage cycles: Worst in Q4 and after new regulation implementation (ELD mandate, FMCSA drug clearinghouse). Spot rates spike, service drops.

Fraud and Red Flags

  • Staged damages: Damage patterns inconsistent with transit mode. Multiple claims from same consignee location.
  • Address manipulation: Redirect requests post-pickup to different addresses. Common in high-value electronics.
  • Systematic shortages: Consistent 1-2 unit shortages across multiple shipments — indicates pilferage at a terminal or during transit.
  • Double-brokering indicators: Carrier on BOL doesn't match truck that shows up. Driver can't name their dispatcher. Insurance certificate is from a different entity.

Decision Frameworks

Severity Classification

Assess every exception on three axes and take the highest severity:

Financial Impact:

  • Level 1 (Low): < $1,000 product value, no expedite needed
  • Level 2 (Moderate): $1,000 - $5,000 or minor expedite costs
  • Level 3 (Significant): $5,000 - $25,000 or customer penalty risk
  • Level 4 (Major): $25,000 - $100,000 or contract compliance risk
  • Level 5 (Critical): > $100,000 or regulatory/safety implications

Customer Impact:

  • Standard customer, no SLA at risk → does not elevate
  • Key account with SLA at risk → elevate by 1 level
  • Enterprise customer with penalty clauses → elevate by 2 levels
  • Customer's production line or retail launch at risk → automatic Level 4+

Time Sensitivity:

  • Standard transit with buffer → does not elevate
  • Delivery needed within 48 hours, no alternative sourced → elevate by 1
  • Same-day or next-day critical (production shutdown, event deadline) → automatic Level 4+

Eat-the-Cost vs Fight-the-Claim

This is the most common judgment call. Thresholds:

  • < $500 and carrier relationship is strong: Absorb. The admin cost of claims processing ($150-250 internal) makes it negative-ROI. Log for carrier scorecard.
  • $500 - $2,500: File claim but don't escalate aggressively. This is the "standard process" zone. Accept partial settlements above 70% of value.
  • $2,500 - $10,000: Full claims process. Escalate at 30-day mark if no resolution. Involve carrier account manager. Reject settlements below 80%.
  • > $10,000: VP-level awareness. Dedicated claims handler. Independent inspection if damage. Reject settlements below 90%. Legal review if denied.
  • Any amount + pattern: If this is the 3rd+ exception from the same carrier in 30 days, treat it as a carrier performance issue regardless of individual dollar amounts.

Priority Sequencing

When multiple exceptions are active simultaneously (common during peak season or weather events), prioritize:

  1. Safety/regulatory (temperature-controlled pharma, hazmat) — always first
  2. Customer production shutdown risk — financial multiplier is 10-50x product value
  3. Perishable with remaining shelf life < 48 hours
  4. Highest financial impact adjusted for customer tier
  5. Oldest unresolved exception (prevent aging beyond SLA)

Key Edge Cases

These are situations where the obvious approach is wrong. Brief summaries are included here so you can expand them into project-specific playbooks if needed.

  1. Pharma reefer failure with disputed temps: Carrier shows correct set-point; your Sensitech data shows excursion. The dispute is about sensor placement and pre-cooling. Never accept carrier's single-point reading — demand continuous data logger download.
  2. Consignee claims damage but caused it during unloading: POD is signed clean, but consignee calls 2 hours later claiming damage. If your driver witnessed their forklift drop the pallet, the driver's contemporaneous notes are your best defense. Without that, concealed damage claim against you is likely.
  3. 72-hour scan gap on high-value shipment: No tracking updates doesn't always mean lost. LTL scan gaps happen at busy terminals. Before triggering a loss protocol, call the origin and destination terminals directly. Ask for physical trailer/bay location.
  4. Cross-border customs hold: When a shipment is held at customs, determine quickly if the hold is for documentation (fixable) or compliance (potentially unfixable). Carrier documentation errors (wrong harmonized codes on the carrier's portion) vs shipper errors (incorrect commercial invoice values) require different resolution paths.
  5. Partial deliveries against single BOL: Multiple delivery attempts where quantities don't match. Maintain a running tally. Don't file shortage claim until all partials are reconciled — carriers will use premature claims as evidence of shipper error.
  6. Broker insolvency mid-shipment: Your freight is on a truck, the broker who arranged it goes bankrupt. The actual carrier has a lien right. Determine quickly: is the carrier paid? If not, negotiate directly with the carrier for release.
  7. Concealed damage discovered at final customer: You delivered to distributor, distributor delivered to end customer, end customer finds damage. The chain-of-custody documentation determines who bears the loss.
  8. Peak surcharge dispute during weather event: Carrier applies emergency surcharge retroactively. Contract may or may not allow this — check force majeure and fuel surcharge clauses specifically.

Communication Patterns

Tone Calibration

Match communication tone to situation severity and relationship:

  • Routine exception, good carrier relationship: Collaborative. "We've got a delay on PRO# X — can you get me an updated ETA? Customer is asking."
  • Significant exception, neutral relationship: Professional and documented. State facts, reference BOL/PRO, specify what you need and by when.
  • Major exception or pattern, strained relationship: Formal. CC management. Reference contract terms. Set response deadlines. "Per Section 4.2 of our transportation agreement dated..."
  • Customer-facing (delay): Proactive, honest, solution-oriented. Never blame the carrier by name. "Your shipment has experienced a transit delay. Here's what we're doing and your updated timeline."
  • Customer-facing (damage/loss): Empathetic, action-oriented. Lead with the resolution, not the problem. "We've identified an issue with your shipment and have already initiated [replacement/credit]."

Key Templates

Brief templates appear below. Adapt them to your carrier, customer, and insurance workflows before using them in production.

Initial carrier inquiry: Subject: Exception Notice — PRO# {pro} / BOL# {bol}. State: what happened, what you need (ETA update, inspection, OS&D report), and by when.

Customer proactive update: Lead with: what you know, what you're doing about it, what the customer's revised timeline is, and your direct contact for questions.

Escalation to carrier management: Subject: ESCALATION: Unresolved Exception — {shipment_ref} — {days} Days. Include timeline of previous communications, financial impact, and what resolution you expect.

Escalation Protocols

Automatic Escalation Triggers

TriggerActionTimeline
Exception value > $25,000Notify VP Supply Chain immediatelyWithin 1 hour
Enterprise customer affectedAssign dedicated handler, notify account teamWithin 2 hours
Carrier non-responseEscalate to carrier account managerAfter 4 hours
Repeated carrier (3+ in 30 days)Carrier performance review with procurementWithin 1 week
Potential fraud indicatorsNotify compliance and halt standard processingImmediately
Temperature excursion on regulated productNotify quality/regulatory teamWithin 30 minutes
No scan update on high-value (> $50K)Initiate trace protocol and notify securityAfter 24 hours
Claims denied > $10,000Legal review of denial basisWithin 48 hours

Escalation Chain

Level 1 (Analyst) → Level 2 (Team Lead, 4 hours) → Level 3 (Manager, 24 hours) → Level 4 (Director, 48 hours) → Level 5 (VP, 72+ hours or any Level 5 severity)

Performance Indicators

Track these metrics weekly and trend monthly:

MetricTargetRed Flag
Mean resolution time< 72 hours> 120 hours
First-contact resolution rate> 40%< 25%
Financial recovery rate (claims)> 75%< 50%
Customer satisfaction (post-exception)> 4.0/5.0< 3.5/5.0
Exception rate (per 1,000 shipments)< 25> 40
Claims filing timeliness100% within 30 daysAny > 60 days
Repeat exceptions (same carrier/lane)< 10%> 20%
Aged exceptions (> 30 days open)< 5% of total> 15%

Additional Resources

  • Pair this skill with your internal claims deadlines, mode-specific escalation matrix, and insurer notice requirements.
  • Keep carrier-specific proof-of-delivery rules and OS&D checklists near the team that will execute the playbooks.

平台分布

Codex

34.24%
按下载量换算6,237

Claude

28.81%
按下载量换算5,248

Cursor

18.87%
按下载量换算3,437

Gemini CLI

9.38%
按下载量换算1,709

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

执行命令

安装流程涉及命令执行,可能通过 npx skills add https://github.com/affaan-m/everything-claude-code --skill logistics-exception-management 联网下载 Skill 或依赖。用户安装前应确认命令来源、仓库内容和执行环境。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills