docs/client-logistics/README.md

# client-logistics

匠厂物流与货代技能组，当前包含 **123** 个技能仓库。

| 技能 slug | 说明 |
|---|---|
| `advise-fba-inventory` | FBA 库存水位预警与智能补货建议，结合销量预测和头程时效推荐补货时点 |
| `alert-overdue-receivables` | 应收账款账龄分析与逾期预警，按客户/账期/金额多维度分级告警 |
| `alert-transit-exception` | 运输异常主动告警（延误/丢柜/错运/掉箱/温控失效） |
| `allocate-shared-cost` | 共用费用分摊（拼箱/包板/包机），按重量/体积/件数自动分摊 |
| `amend-shipping-document` | 单证改单/更正处理，管理改单费用和客户确认流 |
| `analyze-customer-value` | 客户价值分层分析（RFM/ABC），识别大客户/流失风险/增长机会 |
| `analyze-lane-performance` | 航线贡献度分析，识别盈利航线和亏损航线 |
| `analyze-sales-pipeline` | 销售漏斗分析，从询价到成单的转化率诊断 |
| `analyze-shipment-profit` | 订单利润多维度分析（航线/客户/业务员/船司/订单粒度），支持毛利率排名与异常波动识别 |
| `analyze-win-loss` | 报价成交率分析，按客户/航线/业务员/价格竞争力维度诊断胜负原因 |
| `answer-customer-faq` | 智能客服机器人，支持常见问题自动应答 + 货物轨迹查询 + 业务咨询 |
| `apply-trade-preference` | 优惠原产地证与自贸协定税率适用性分析（RCEP/中韩/中澳等） |
| `assess-shipment-risk` | 单票货物综合风险评分（合规/价值/路由/客户信用） |
| `audit-carrier-invoice` | 承运人账单审核（船司/航司/拖车/报关行），自动识别乱收费和重复计费 |
| `audit-compliance-log` | 合规操作日志审计，为外审和监管检查提供可追溯证据链 |
| `benchmark-industry-metrics` | 行业对标数据分析，对比头部货代的时效、成本、服务水平 |
| `build-freight-quote` | 生成一站式综合报价单（含海运费/空运费/陆运费/报关/本地费/目的港费/杂费），支持多航线多方案对比 |
| `build-operations-dashboard` | 物流经营 KPI 驾驶舱（时效/利润/箱量/异常率），支持多维度钻取与周报月报自动生成 |
| `build-tender-response` | 投标书与年度招标应标文件生成，支持客户模板填充与历史投标复用 |
| `calculate-freight-charges` | 一体化智能计费与报价，整合海运/空运/陆运费率表，含附加费和折扣规则自动应用 |
| `calculate-fuel-surcharge` | BAF/EBS/燃油附加费/低硫附加费核算，基于船司公告和航线基准油价 |
| `check-brand-compliance` | 品牌与知识产权合规预检，识别仿牌/侵权风险 |
| `check-cargo-compliance` | 货物合规性自动预检（品牌/仿牌/知识产权/危险品/3C/濒危物种/双用途物项） |
| `check-credit-limit` | 客户信用额度实时检查，关联应收账龄自动判断是否放单 |
| `check-dual-use-control` | 军民两用物项管制检查，对照管制清单和出口许可证要求 |
| `check-hazmat-compliance` | 危险品合规检查，核对 UN 编号、包装类别、运输限制 |
| `check-restricted-goods` | 管制物品预检（3C 认证/濒危物种/双用途物项/战略物资） |
| `classify-hs-code` | HS 编码智能归类，基于商品品名/规格/材质/用途推荐最精准的海关商品编码及申报要素 |
| `collect-customer-feedback` | 客户满意度与 NPS 收集分析，识别流失风险 |
| `consolidate-lcl-cargo` | 拼箱配载优化（重量/体积/目的港匹配），最大化箱内空间利用率 |
| `convert-currency` | 多币种汇率实时换算、汇率波动监控与锁汇时机建议 |
| `coordinate-door-delivery` | 门到门派送协调，管理客户签收时间窗和特殊送货要求 |
| `create-shipment-file` | OMS/TMS 自动建档，分配 Job No，按业务类型智能派工到 OP |
| `detect-duplicate-booking` | 重复订舱识别，防止同一票货重复申请舱位造成资源浪费 |
| `dispatch-air-booking` | 空运订舱（航司/GSA），自动填写空运订舱表并提交给代理或航司 |
| `dispatch-ltl-booking` | 零担/快递渠道下单（DHL/UPS/FedEx/顺丰/中邮等） |
| `dispatch-ocean-booking` | 海运多船司/NVOCC 并行订舱，自动填写订舱表并提交订舱申请 |
| `dispatch-rail-booking` | 中欧班列/铁运订舱，对接各铁路运营商预订舱位 |
| `draft-apology-letter` | 服务异常道歉函与补偿方案生成 |
| `draft-collection-letter` | 分级催款话术生成，按账龄和客户关系匹配合适的催收语气 |
| `draft-internal-handover` | 班次与岗位交接文档自动生成，确保跨班次信息不丢失 |
| `draft-quote-followup` | 报价后客户跟进话术生成 + 长时间未回复自动提醒销售 |
| `escalate-service-issue` | 投诉升级路由，按严重程度和客户等级智能分派到相关责任人 |
| `estimate-duty-tax` | 关税/增值税/消费税预估，支持多国税率库和优惠关税适用性判断 |
| `evaluate-carrier-performance` | 供应商绩效评估，多维度打分支持年度评级和汰换决策 |
| `forecast-cashflow` | 现金流预测，基于应收账期和应付账期的滚动预测 |
| `forecast-rate-trend` | 运价走势预测，结合市场供需/油价/季节性因素 |
| `forecast-shipment-volume` | 箱量/货量预测，支持旺季提前锁仓和淡季降本决策 |
| `generate-air-waybill` | 空运单生成（MAWB/HAWB），符合 IATA 标准和航司模板 |
| `generate-certificate-origin` | 产地证自动生成（一般 CO/FORM E/FORM F/RCEP/中韩等优惠原产地证） |
| `generate-commercial-invoice` | 生成标准商业发票（Commercial Invoice），支持多币种、多贸易条款、多行项目 |
| `generate-dangerous-goods-doc` | 危险品申报单生成（DGD/MSDS），符合 IMDG/IATA DGR 规范 |
| `generate-fumigation-cert` | 熏蒸证书与植检证书申请，对接海关植检系统 |
| `generate-insurance-policy` | 货运保险单自动生成，支持 ICC(A)/(B)/(C) 等主流险种和保额计算 |
| `generate-meeting-minutes` | 会议纪要自动整理，识别决议事项和负责人 |
| `generate-ocean-bl` | 海运提单自动生成（MBL/HBL），支持正本单、电放单、海运单等多种放单方式 |
| `generate-packing-list` | 装箱单自动生成，支持多种包装方式（托盘/纸箱/散装）和多语言版本 |
| `generate-seaway-bill` | 海运单/电放单生成，用于信任客户的快速放货场景 |
| `handle-cargo-claim` | 货损/货差索赔处理，含立案、举证清单、赔付计算、保险对接 |
| `handle-customs-amendment` | 报关改单/退单处理，含修改申请、补税、罚没等情形 |
| `handle-customs-inspection` | 海关查验应对指引，自动生成查验材料清单和话术 |
| `handle-detention-demurrage` | 滞箱费/滞港费核算与预警，提前提醒客户避免超期费用 |
| `handle-rollover` | 甩柜/甩货处理与改配，自动寻找替代船期并通知客户 |
| `issue-customer-invoice` | 对客账单开立，支持多币种、多主体、分项费用明细 |
| `log-operation-audit` | 操作轨迹与审计日志，记录关键操作用于合规和追溯 |
| `logistics-commons` | 物流领域公共资产：行业标准编码、数据模型、适配层规范、仿真系统对接说明 |
| `logistics-tracker` | 货物运单统一追踪查询 |
| `manage-aeo-records` | AEO 高级认证相关记录维护，支持定期自查与外审准备 |
| `manage-carrier-contract` | 船司/航司/拖车/报关行合同管理，含费率、服务承诺、有效期 |
| `manage-haulage-order` | 拖车单管理，含派车、路单、回单、费用核算 |
| `manage-inbound-receipt` | 进仓验收与上架管理，含 SKU 核对、破损记录、上架规则 |
| `manage-inventory-count` | 库存盘点管理（动态盘点/循环盘点/全面盘点），差异分析与调整 |
| `manage-outbound-picking` | 拣货与复核管理，支持波次拣货、复核打包、装车核验 |
| `manage-payment-term` | 账期与信用条款管理，支持客户分级和动态调整 |
| `manage-rate-agreement` | 客户协议价/约价管理，含有效期、适用航线、最低舱量承诺等条款 |
| `manage-sku-mapping` | SKU/条码/唛头主数据管理，支持客户 SKU 与系统 SKU 映射 |
| `manage-space-allotment` | 协议舱位配额管理，实时监控使用率和剩余配额 |
| `manage-telex-release` | 电放放货指令管理，从客户申请到船司确认的全流程跟踪 |
| `manage-vendor-onboarding` | 供应商准入与资质核验，管理营业执照、保险、资质证书等材料 |
| `manage-vgm-submission` | VGM 称重申报管理，跟踪截止时间并自动提交给船司/码头 |
| `manage-warehouse-billing` | 仓储计费管理（按托位/按天/按件/按操作），自动生成仓储账单 |
| `monitor-cold-chain` | 冷链温控实时监控，支持冷藏柜温湿度曲线和告警阈值 |
| `monitor-competitor-rates` | 竞品货代运价监控与波动提醒，含航线/船司维度的价格对标 |
| `monitor-contract-expiry` | 合同与运价协议到期提醒，自动触发续约流程 |
| `monitor-market-rates` | 海运/空运/陆运大盘运价监控，抓取主流运价指数与市场盘口 |
| `monitor-port-congestion` | 全球主要港口拥堵、罢工、台风、潮汐等事件实时监控与风险预警 |
| `monitor-transshipment` | 中转港换船/转机监控，识别中转延误和衔接风险 |
| `negotiate-rate-adjustment` | 运价调整谈判辅助，基于市场数据和历史合作表现生成谈判依据 |
| `notify-customer-event` | 客户通知 |
| `optimize-delivery-route` | 尾程配送路径优化，综合考虑里程、时间窗、车辆容量、司机工时 |
| `optimize-truck-dispatch` | 拖车与最后一公里配送智能调度优化，综合考虑时效、成本、司机工时、车辆装载率 |
| `parse-booking-request` | 解析客户订舱申请（邮件/微信/EDI），自动识别订舱要素并结构化 |
| `parse-rfq-email` | 解析客户询价邮件/附件/截图，自动提取起运港、目的港、品名、箱型箱量、时效要求等询价要素 |
| `parse-shipping-instruction` | 智能解析客户托书/SI（PDF/Excel/邮件/图片），提取唛头、品名、箱型箱量、收发货人、贸易条款等要素 |
| `post-accounting-entries` | 财务凭证自动生成，对接主流 ERP（SAP/用友/金蝶/Oracle） |
| `prepare-customs-declaration` | 智能跨境清关制单，自动生成报关单及随附单证（报关委托书、申报要素等） |
| `prepare-export-declaration` | 出口报关单制作，自动生成随附单证与申报要素 |
| `prepare-import-declaration` | 进口报关单制作，含归类、估价、申报要素填写 |
| `process-crossdock` | 越库/分拨操作管理，不上架直接分配到出库订单 |
| `process-refund-chargeback` | 退款/退补差处理，管理审批流和账务冲销 |
| `recommend-routing` | 最优路由推荐，综合时效、价格、船司可靠性、中转次数推荐航线和船期 |
| `reconcile-statement-account` | SOA 智能对账核销（原 soa-auto-match 能力一并合入），覆盖 AR/AP 自动匹配、差异识别、人工确认流 |
| `report-carrier-performance` | 船公司/航司 KPI 表现报告（准点率、甩柜率、服务水平、响应时效） |
| `route-task-assignment` | 任务智能派工，按技能/工作量/熟练度匹配合适的员工 |
| `schedule-warehouse-inbound` | 仓库进仓预约管理，协调进仓时间和月台资源 |
| `schedule-warehouse-outbound` | 仓库出仓预约管理，协调出库时间和承运人到仓 |
| `screen-denied-party` | 拒绝交易方筛查，覆盖主要国家的实体清单 |
| `screen-sanctions-list` | 制裁名单筛查（OFAC/EU/UN/中国商务部），反洗钱与反恐合规 |
| `search-internal-knowledge` | 内部知识库问答（SOP/操作手册/客户特殊要求/历史工单） |
| `serve-customer-portal` | B2B 客户自助门户服务（订单查询/轨迹追踪/对账单下载/在线报价/投诉建议） |
| `soa-auto-match` | **[已废弃]** 能力已合入 `reconcile-statement-account`，此仓库保留历史代码 |
| `submit-ams-aci-ens` | AMS/ACI/ENS 等境外预舱单申报，覆盖美国、加拿大、欧盟等主要目的国 |
| `track-booking-confirmation` | 订舱全流程状态追踪（S/O、MAWB、订舱回执、VGM 截止、舱位确认） |
| `track-container-movement` | 集装箱动态追踪（装船、靠港、卸船、提箱、还箱），精确到码头节点 |
| `track-customs-clearance` | 报关进度全链路追踪 + 查验预警，覆盖申报、放行、查验、补税等节点 |
| `track-fba-delivery` | 跨境电商 FBA 尾程追踪（Amazon/Walmart/Shopee 等平台的签收、上架、异常监控） |
| `track-flight-status` | 航班状态与 ULD 追踪，覆盖全球主要航司和机场 |
| `track-shipment` | 货物全程统一追踪（海运/空运/陆运/铁运/快递），整合多家承运人数据源 |
| `track-vessel-schedule` | 船期变动实时监控，自动提醒 ETA/ETD 变更 |
| `validate-shipping-order` | 订单信息完整性与合规性自动校验，识别缺失字段和潜在风险点 |
| `verify-document-consistency` | 跨单证一致性校验（商业发票/装箱单/提单/报关单），自动比对品名、数量、金额、唛头等关键字段 |
| `verify-kyc-document` | 客户 KYC 尽调，核验营业执照、实控人、受益所有人等信息 |
| `verify-ocean-bl` | 海运提单极限核对，检查收发货人、品名、唛头、数量、运费条款等关键字段合规性 |

## 分类

### 公共基础

- **logistics-commons** — 物流领域公共资产：行业标准编码、数据模型、适配层规范、仿真系统对接说明
- **logistics-tracker** — 货物运单统一追踪查询

### 订单接入

- **create-shipment-file** — OMS/TMS 自动建档，分配 Job No，按业务类型智能派工到 OP
- **parse-booking-request** — 解析客户订舱申请（邮件/微信/EDI），自动识别订舱要素并结构化
- **parse-shipping-instruction** — 智能解析客户托书/SI，提取唛头、品名、箱型箱量、收发货人、贸易条款等要素
- **parse-rfq-email** — 解析客户询价邮件/附件/截图，自动提取询价要素
- **validate-shipping-order** — 订单信息完整性与合规性自动校验
- **detect-duplicate-booking** — 重复订舱识别
- **check-credit-limit** — 客户信用额度实时检查，关联应收账龄自动判断是否放单

### 订舱与舱位

- **dispatch-ocean-booking** — 海运多船司/NVOCC 并行订舱
- **dispatch-air-booking** — 空运订舱（航司/GSA）
- **dispatch-rail-booking** — 中欧班列/铁运订舱
- **dispatch-ltl-booking** — 零担/快递渠道下单
- **recommend-routing** — 最优路由推荐
- **consolidate-lcl-cargo** — 拼箱配载优化
- **manage-space-allotment** — 协议舱位配额管理
- **track-booking-confirmation** — 订舱全流程状态追踪
- **handle-rollover** — 甩柜/甩货处理与改配

### 单证制作

- **generate-ocean-bl** — 海运提单自动生成（MBL/HBL）
- **generate-seaway-bill** — 海运单/电放单生成
- **generate-air-waybill** — 空运单生成（MAWB/HAWB）
- **generate-commercial-invoice** — 商业发票生成
- **generate-packing-list** — 装箱单自动生成
- **generate-insurance-policy** — 货运保险单自动生成
- **generate-certificate-origin** — 产地证自动生成
- **generate-fumigation-cert** — 熏蒸证书与植检证书申请
- **generate-dangerous-goods-doc** — 危险品申报单生成
- **prepare-customs-declaration** — 智能跨境清关制单
- **prepare-export-declaration** — 出口报关单制作
- **prepare-import-declaration** — 进口报关单制作
- **manage-telex-release** — 电放放货指令管理

### 单证校验与改单

- **verify-document-consistency** — 跨单证一致性校验
- **verify-ocean-bl** — 海运提单极限核对
- **amend-shipping-document** — 单证改单/更正处理

### 报关与贸易合规

- **classify-hs-code** — HS 编码智能归类
- **apply-trade-preference** — 优惠原产地证与自贸协定税率适用性分析
- **submit-ams-aci-ens** — AMS/ACI/ENS 等境外预舱单申报
- **manage-aeo-records** — AEO 高级认证相关记录维护
- **manage-vgm-submission** — VGM 称重申报管理
- **check-cargo-compliance** — 货物合规性自动预检
- **check-brand-compliance** — 品牌与知识产权合规预检
- **check-restricted-goods** — 管制物品预检
- **check-hazmat-compliance** — 危险品合规检查
- **check-dual-use-control** — 军民两用物项管制检查
- **estimate-duty-tax** — 关税/增值税/消费税预估
- **screen-sanctions-list** — 制裁名单筛查
- **screen-denied-party** — 拒绝交易方筛查
- **verify-kyc-document** — 客户 KYC 尽调

### 全程追踪

- **track-shipment** — 货物全程统一追踪
- **track-container-movement** — 集装箱动态追踪
- **track-vessel-schedule** — 船期变动实时监控
- **track-flight-status** — 航班状态与 ULD 追踪
- **track-customs-clearance** — 报关进度全链路追踪
- **monitor-transshipment** — 中转港换船/转机监控
- **monitor-port-congestion** — 全球主要港口拥堵与风险预警
- **monitor-cold-chain** — 冷链温控实时监控
- **alert-transit-exception** — 运输异常主动告警

### 异常与索赔

- **handle-detention-demurrage** — 滞箱费/滞港费核算与预警
- **handle-customs-inspection** — 海关查验应对指引
- **handle-customs-amendment** — 报关改单/退单处理
- **handle-cargo-claim** — 货损/货差索赔处理
- **process-refund-chargeback** — 退款/退补差处理

### 报价与运价

- **build-freight-quote** — 生成一站式综合报价单
- **calculate-freight-charges** — 一体化智能计费与报价
- **calculate-fuel-surcharge** — 燃油附加费核算
- **convert-currency** — 多币种汇率实时换算
- **forecast-rate-trend** — 运价走势预测
- **monitor-market-rates** — 海运/空运/陆运大盘运价监控
- **monitor-competitor-rates** — 竞品货代运价监控与波动提醒
- **negotiate-rate-adjustment** — 运价调整谈判辅助

### 合同与供应商

- **manage-carrier-contract** — 船司/航司/拖车/报关行合同管理
- **manage-rate-agreement** — 客户协议价/约价管理
- **manage-vendor-onboarding** — 供应商准入与资质核验
- **monitor-contract-expiry** — 合同与运价协议到期提醒
- **report-carrier-performance** — 船公司/航司 KPI 表现报告
- **evaluate-carrier-performance** — 供应商绩效评估

### 财务与对账

- **manage-payment-term** — 账期与信用条款管理
- **allocate-shared-cost** — 共用费用分摊
- **issue-customer-invoice** — 对客账单开立
- **reconcile-statement-account** — SOA 智能对账核销
- **soa-auto-match** — **[已废弃]** 能力已合入 `reconcile-statement-account`
- **alert-overdue-receivables** — 应收账款账龄分析与逾期预警
- **draft-collection-letter** — 分级催款话术生成
- **audit-carrier-invoice** — 承运人账单审核
- **manage-warehouse-billing** — 仓储计费管理
- **post-accounting-entries** — 财务凭证自动生成
- **forecast-cashflow** — 现金流预测

### 仓储作业

- **manage-inbound-receipt** — 进仓验收与上架管理
- **manage-inventory-count** — 库存盘点管理
- **manage-sku-mapping** — SKU/条码/唛头主数据管理
- **manage-outbound-picking** — 拣货与复核管理
- **process-crossdock** — 越库/分拨操作管理
- **schedule-warehouse-inbound** — 仓库进仓预约管理
- **schedule-warehouse-outbound** — 仓库出仓预约管理

### 尾程配送

- **manage-haulage-order** — 拖车单管理
- **optimize-truck-dispatch** — 拖车与最后一公里配送智能调度优化
- **optimize-delivery-route** — 尾程配送路径优化
- **coordinate-door-delivery** — 门到门派送协调

### 跨境电商 FBA

- **track-fba-delivery** — 跨境电商 FBA 尾程追踪
- **advise-fba-inventory** — FBA 库存水位预警与智能补货建议

### 销售与客户服务

- **build-tender-response** — 投标书与年度招标应标文件生成
- **draft-quote-followup** — 报价后客户跟进话术生成
- **analyze-win-loss** — 报价成交率分析
- **analyze-sales-pipeline** — 销售漏斗分析
- **serve-customer-portal** — B2B 客户自助门户服务
- **answer-customer-faq** — 智能客服机器人
- **notify-customer-event** — 客户通知
- **collect-customer-feedback** — 客户满意度与 NPS 收集分析
- **draft-apology-letter** — 服务异常道歉函与补偿方案生成
- **escalate-service-issue** — 投诉升级路由

### 数据分析

- **analyze-shipment-profit** — 订单利润多维度分析
- **analyze-lane-performance** — 航线贡献度分析
- **analyze-customer-value** — 客户价值分层分析
- **assess-shipment-risk** — 单票货物综合风险评分
- **benchmark-industry-metrics** — 行业对标数据分析
- **forecast-shipment-volume** — 箱量/货量预测
- **build-operations-dashboard** — 物流经营 KPI 驾驶舱

### 内部运营

- **search-internal-knowledge** — 内部知识库问答
- **generate-meeting-minutes** — 会议纪要自动整理
- **route-task-assignment** — 任务智能派工
- **draft-internal-handover** — 班次与岗位交接文档自动生成
- **log-operation-audit** — 操作轨迹与审计日志
- **audit-compliance-log** — 合规操作日志审计