物流与运输结算专家（免费版）
一句话：这一类问题，一个问题一处问清楚 —— 覆盖 10 个子技能，贴一张表就自动分诊。
什么时候用
这一类问题共 10 个子技能；做这一类工作的人每次结账/投标/检查都要过一遍。
这个技能覆盖哪些子问题（10 个）
| # | 子问题（能力 id） | 它管什么 |
|---|---|---|
| 1 | cargo-insurance-claim-check |
货运险投保与货损理赔核对 |
| 2 | courier-settlement-check |
网点运费与代收货款结算核对 |
| 3 | driver-freight-settlement-check |
承运司机运费结算核对 |
| 4 | fleet-fuel-cost-check |
车队油耗与运费核对 |
| 5 | freight-loss-claim-check |
货运破损理赔与扣款核对 |
| 6 | logistics-fuel-card-check |
车队油卡与油耗核对 |
| 7 | logistics-storage-fee-check |
物流仓储与操作费核对 |
| 8 | warehouse-fee-check |
仓储费与超期费核对 |
| 9 | warehouse-storage-fee-check |
仓储费与库龄结算核对 |
| 10 | waybill-pod-cod-check |
运单回单与代收货款核对 |
怎么用
node scripts/run.mjs --list # 看覆盖了哪些子问题
node scripts/run.mjs --sample # 用内置样例跑一遍
node scripts/run.mjs --text "把表贴在这里" # 贴材料，自动判断属于哪类问题
node scripts/run.mjs --sub-skill cargo-insurance-claim-check --input 材料.json --json
声明与实现的一致性（可逐条核对）
ClawHub 的 skillspector 会检查"文档声明的范围"与"真实实现"是否一致，这里把话说死：
| 声明 | 你怎样自己核对 |
|---|---|
| 覆盖 10 个子技能，与下表一一对应 | node scripts/run.mjs --list 的条数必须等于 10 |
包内清单就是权威：scripts/engine/expert-manifest.json |
打开它，subs[] 的 id 与下表逐条相同 |
| 分诊只按材料表头词匹配到子技能 | 匹配不到或并列时不给结论（退出码 3，并列出候选） |
| 输出是机器可读的 | --json 返回 {subSkill, subSkillName, result}；result 是该子技能的完整结论 |
| 不做超出子技能范围的判断 | 每个子技能只跑它自己的检查项；材料不足时如实说缺什么，不用默认值编"没问题" |
版本约定：技能库新增子技能会升小版本号（
version字段），并在此表下方追加一行—— 文档、清单、--list三者必须同时变，不允许只改一处。
边界（请务必知道）
- 材料不足不给结论：订阅版会点名缺哪些列/哪些段，不用默认值编"没问题"；
- 分诊只按材料表头匹配；匹配不到会直说匹配不到（不猜），你也可以用
--sub-skill点名； - 「没报问题」不等于「没有问题」：每个子技能只执行它自己的检查项，超出范围的判断不在本能力内。
参数与未执行项（如实声明，避免"以为全查了"）
- 部分子技能的部分检查项需要你额外提供参数才会执行（例如报价类子技能的"最高投标限价 / 投标保证金 / 中文大写金额 / 总价"）；
- 没有提供这些参数时，结果里会逐条列出"本次未执行的检查项"（这是设计，不是漏查）；
- 因此："没报问题"只代表已执行的那些检查项通过了，不代表这一类问题的全部检查都跑过；
- 你可以用
--sub-skill <子技能id>点名只跑某一个子技能，输出里同样会列出它这次的未执行项。
常见错法
| 常见错法 | 会发生什么 | 正确做法 |
|---|---|---|
| 只贴数据行、不贴表头 | 分诊拿不到列名 ⇒ 匹配不到子问题（会如实说"没匹配上"，不给结论） | 从 Excel 里把表头与数据行一起复制（Tab 分隔最稳） |
| 一列里混着合并单元格 | 导出后该列在文本里是空的 ⇒ 判"关键字段缺失" | 先取消合并、把值填满每一行再复制 |
| 金额写成「约 1.2 万」「1,200 元」 | 数值列认不出，判"数值无法解析" | 只填数值（单位统一），千分位逗号可以带，但别带"约/元"等字 |
| 同一份材料里混两类问题 | 分诊会判"并列"⇒ 不给结论 | 拆成两张表分别跑，或用 --sub-skill 点名 |
| 空值写「/」「—」「无」 | 被判字段缺失或数值非法 | 空就留空（Tab 分隔留一个空列） |