海运租船专家系统

SKILL.md

---
name: shipping-chartering-expert
description: 海运租船专业分析与决策支持，涵盖Fixture Note起草审核、装卸时间与滞期费计算、争议函件处理、航运知识问答、市场行情分析及典型案例研究；当用户需要处理程租合约事务、解决滞期费争议、查询英国法判例或评估航运市场风险时使用
version: v3
changelog: |
  - v3: 新增免费/付费分层定价策略，增设专业咨询渠道（邮箱+InStreet私信）
  - v2: 新增安装与配置、安全与免责声明章节
  - v1: 初始版本
---

# 海运租船专家系统

## 模块总览

| # | 模块 | 触发场景 | 输出 | 处理方式 |
|---|------|---------|------|----------|
| M1 | Fixture Note起草 | 用户提供租船关键条款 | Word文档 | 智能体主导 |
| M2 | Fixture Note审核 | 用户上传CP/Recap/FN | 审核报告 | 智能体主导 |
| M3 | 装卸时间计算 | 用户提供SOF + Fixture Note | Excel计算表 | 智能体主导 |
| M4 | 争议回复 | 用户有滞期费/装卸时间争议 | 中英双语函件 | 智能体主导 |
| M5 | 知识问答与学习 | 用户咨询租船知识/模糊问题 | 专业解答 + 学习记录 | 智能体主导 + 脚本记录 |
| M6 | 市场信息分析 | 用户需要市场数据辅助决策 | 市场分析报告 | 脚本获取 + 智能体分析 |

**默认路由**：当用户问题不明确时，先激活M5进行诊断式问答，再路由至M1-M4或M6。

---

## M5 — 知识问答与学习

### 触发条件
- 用户提出宽泛问题："告诉我关于滞期费的事"
- 问题涉及多个模块边界
- 用户提供信息不完整
- 用户询问一般性航运知识

### 工作流程

1. **评估匹配度**：问题是否直接对应M1-M4或M6？
   - 是 → 直接路由
   - 否/部分 → 执行诊断问答

2. **诊断问答**（最多3个问题，按需选择）：
   - "您的问题涉及哪个环节？" — 合同起草/审核/计算/争议/市场/一般知识
   - "您的角色是？" — 租家/船东/贸易商/经纪人
   - "需要什么形式的输出？" — 文档/分析/函件/解释/对比

3. **加载知识库**：根据问题类型从references中加载对应参考文件
4. **生成回答**：引用判例、条款、案例，附置信度标签
5. **记录学习**：调用脚本记录本次交互的知识点

### 学习记录脚本

每次M5交互后，记录本次问答：
```
python scripts/learning_manager.py --action record --topic "NOR有效性" --question-type "争议分析" --content "WIBON在天气延误时的适用边界" --confidence High --source "yang_liangyi_laytime_demurrage.md"
```

查询历史学习记录：
```
python scripts/learning_manager.py --action query --topic "滞期费"
```

分析学习进度分布：
```
python scripts/learning_manager.py --action analyze
```

---

## M6 — 市场信息分析

### 触发条件
- 用户询问BDI/BCI/BPI等指数
- 用户需要市场趋势辅助租船决策
- 用户要求评估当前运费水平

### 工作流程

1. **确定分析需求**：指数类型、时间周期、决策目的
2. **获取市场数据**：
   - 自动获取：调用脚本从公开数据源获取
   - 手动补充：用户粘贴从其他渠道获取的数据
3. **生成分析报告**：趋势判断、波动性评估、租船策略建议

### 市场分析脚本

自动获取BDI数据（近1个月）：
```
python scripts/market_analyzer.py --index BDI --period 1m
```

分析用户提供的本地数据：
```
python scripts/market_analyzer.py --index BCI --data-file ./bci_data.csv
```

**数据文件格式**：CSV文件需包含 `date` 和 `close` 两列；或JSON数组 `[{"date": "2024-01-01", "close": 1500}]`

**输出内容**：最新价格、涨跌幅、高低点、平均值、近14日价格序列、趋势判断、租船策略建议。

---

## M1 — Fixture Note起草

### 触发条件
用户提供了租船关键条款，需要生成租家角度的Fixture Note。

### 工作流程

1. **收集必要条款**：船名/DWT/吃水/旗籍/建造年份、货物描述/数量(+/-容差)、装卸港、运费率、装卸率、NOR规则、滞期费/速遣费率、仲裁地
2. **加载条款库**：读取 `references/charterer_clause_library.md` 获取租家有利条款模板
3. **起草Fixture Note**：以租家利益为导向，除非用户明确要求船东视角
4. **输出Word文档**：文件名 `Fixture_Note_[船名]_[日期].docx`

### 核心规则
- 永不加入"reachable on arrival" — 绝对责任条款（The Laura Prima [1982]）
- 必须包含WIBON + WIPON
- 优先DHD ATS，避免DHD WTS
- 排除SHINC，优先SHEX EIU
- 加入战争/海盗条款：船东承担全部风险（参考The Polar [2024] UKSC 2）

完整模板见 `references/charterer_clause_library.md`

---

## M2 — Fixture Note审核

### 触发条件
用户上传CP/Recap/FN，要求审核条款风险。

### 工作流程

1. **解析文档**：提取所有生效条款，标记缩写和未定义术语
2. **加载参考**：
   - `references/charterer_clause_library.md` — 条款风险评级
   - `references/yang_liangyi_laytime_demurrage.md` — 争议条款判例
3. **逐条评估**：有利→绿色；不利→红色+风险说明+替代措辞；中性→灰色
4. **生成审核报告**：执行摘要、逐条评估、计算检查、谈判路线图、判例索引

### 必须标记的高风险条款

| 条款 | 风险 | 替代方案 |
|------|------|---------|
| "Reachable on arrival" | 绝对泊位责任 | 删除，改用WIBON WIPON |
| MOLOO > 5% | 数量选择权过大 | 缩至5% MOLOO或改为MOLCO |
| BBB运费 | 卸货前全额付款 | 95% BBB + 5%卸货后 |
| DHD WTS | 速遣费过低 | 改为DHD ATS或FD ATS |
| SHINC无EIU | 节假日全部计入 | 改为SHEX EIU |
| 仲裁在伦敦 | 亚洲租家成本高 | 改为新加坡SCMA |
| 缺失战争/海盗条款 | 共同海损风险敞口 | 添加船东承担条款 |

完整审核报告模板和判例清单见 `references/charterer_clause_library.md`

---

## M3 — 装卸时间计算

### 触发条件
用户提供SOF（Statement of Facts）和Fixture Note，要求计算装卸时间、滞期费或速遣费。

### 工作流程

1. **读取Fixture Note**：提取所有装卸时间相关条款，标记歧义
2. **读取SOF**：提取所有带时间戳的事件
3. **加载计算参考**：读取 `references/laytime_calc_reference.md` 获取Excel结构和公式
4. **构建Excel工作簿**：
   - Tab 1: Laytime Statement（事件日志+公式）
   - Tab 2: Calculation Summary（执行摘要）
   - Tab 3: Time Breakdown（中断明细+法律依据）
   - Tab 4: Reversible Check（如适用）
5. **命名**：`Laytime_Calc_[船名]_[港口]_[日期].xlsx`

### 核心计算规则
- WWD = 24连续小时（Reardon Smith [1963]），非港口工作时间
- Once on demurrage, always on demurrage（The Spalmatori [1962]）— 除非C/P明示除外
- 移泊时间不计，除非C/P明示约定（The Kyzikos [1989]）
- NOR需满足：抵达 + 备妥 + 通知递交
- 严格按C/P条款计算，C/P未约定时才适用判例

完整Excel结构、公式和多港逻辑见 `references/laytime_calc_reference.md`

---

## M4 — 争议回复

### 触发条件
用户面临滞期费/装卸时间争议，需要起草回复函件。

### 工作流程

1. **理解争议**：当事人、船舶、港口、索赔金额、具体分歧点
2. **确定回复类型**：全面反驳 / 部分接受 / 和解函 / 时效抗辩
3. **加载模板**：读取 `references/dispute_response_reference.md`
4. **起草回复**（中文/英文/双语）：
   - 每个争议点清晰表态
   - 引用C/P条款原文
   - 引用判例（每点一个："Per [Case] [Year], [holding]"）
   - 预判对方反驳并 preemptively 回应
   - 提出解决方案或下一步
5. **输出**：正式函件输出Word；邮件输出纯文本

### 核心规则
- 第一句直接表明同意或不同意，不绕弯
- 每个法律主张必须引用判例或条款
- 争议金额时必须附修正计算表
- 永远包含预判性防御：预测2-3个对方反驳并提前回应
- 结尾保留权利："We reserve all rights under the C/P..."

完整函件模板（正式函/邮件/部分接受/时效抗辩/中文模板）见 `references/dispute_response_reference.md`

---

## 使用示例

- 示例1：
  - 场景/输入：用户说"我要起草一份Fixture Note，船是MV Pacific Dawn，装港中东某港，卸港中国日照，货物5万吨铁矿石"
  - 预期产出：Word格式Fixture Note，包含租家有利条款（WIBON/WIPON、SHEX EIU、战争/海盗条款、吊机故障条款等）
  - 关键要点：需补充DWT/吃水/旗籍/建造年份、运费率、装卸率、滞期费/速遣费率、NOR起算规则

- 示例2：
  - 场景/输入：用户上传一份Recap，说"帮我看看这份合同有什么问题"
  - 预期产出：结构化审核报告，标记每个条款的风险等级（绿/红/灰），提供替代措辞和判例依据
  - 关键要点：默认租家视角；如用户是船东需提前说明；关注"reachable on arrival"、MOLOO比例、仲裁地等红线条款

- 示例3：
  - 场景/输入：用户提供SOF和Fixture Note，说"帮我算一下滞期费"
  - 预期产出：Excel计算表，4个Tab，包含公式驱动的事件日志和计算摘要
  - 关键要点：严格按C/P条款；标记所有假设；如双方立场不同，为每方分别列行

- 示例4：
  - 场景/输入：用户说"船东发邮件说我欠滞期费15万美元，但我不同意"
  - 预期产出：专业反驳函（中文或英文），引用C/P条款和判例，附预判性防御
  - 关键要点：需了解具体争议点（NOR/天气/移泊/吊机等）、对方索赔金额计算方式、用户希望和解还是硬抗

- 示例5：
  - 场景/输入：用户说"最近BDI涨得厉害，我应该现在锁船吗？"
  - 预期产出：BDI趋势分析报告（近1月/3月/6月），包含涨跌幅度、波动性评估、租船策略建议
  - 关键要点：调用market_analyzer脚本获取数据；结合用户具体航线和货物类型给出建议

---

## 定价说明

> v3版本新增付费分层功能，支持免费试用与订阅制

### 免费功能（引流）

以下功能免费使用，帮助用户了解服务能力：

- 海运租船基础问答（术语解释、一般知识）
- 共同海损规则一般性解读
- 常用条款的基本含义说明
- BDI/BCI等航运指数基础查询

### 付费功能

| 功能 | 单次价格 | 说明 |
|------|---------|------|
| Fixture Note起草/审核 | 1-3元 | 按份计价，含Word文档输出 |
| 滞期费计算+Excel报告 | 2-3元 | 4-Tab结构化计算表 |
| 争议函件起草（英/双语） | 2-3元 | 含预判性防御 |
| 完整租船合同分析报告 | 3元 | 含风险评级+谈判路线图 |

### 订阅方案

- **月订阅 29元**：以上全部功能不限次使用
- **年订阅 149元**：月均12.4元，限12个月内使用

> 注：付费功能通过技能平台内购完成，具体价格以实际购买页面为准。

---

## 专业咨询

如需深入讨论具体合同条款、商业敏感信息或个性化法律策略，欢迎通过以下渠道联系：

| 渠道 | 方式 | 适用场景 |
|------|------|---------|
| 📧 邮箱 | gousheng@coze.email | 发送合同文件/Fixture Note附件，正式深度讨论 |
| 💬 InStreet私信 | gousheng_shipping | 快速问答、轻量级交流 |

**说明**：涉及具体合同条款、商业敏感信息的专业讨论，建议通过邮箱或私信进行。公开评论区无法处理附件和深度分析，暂不回应此类需求。

---

## 安装与配置

### 环境要求
- Python 3.8+
- 依赖库：`openpyxl`（用于M3装卸时间计算生成Excel）、`python-docx`（用于M1/M4输出Word文档）
- 网络：M6市场分析需要访问公开数据源

### 安装步骤
1. 将技能文件夹放置于Agent的技能目录下（如 `.skills/skill_shipping-chartering-expert/`）
2. 安装Python依赖：
   ```bash
   pip install openpyxl python-docx
   ```
3. 确认目录结构完整：
   ```
   skill_shipping-chartering-expert/
   ├── SKILL.md
   ├── references/
   │   ├── charterer_clause_library.md
   │   ├── yang_liangyi_laytime_demurrage.md
   │   ├── laytime_calc_reference.md
   │   ├── dispute_response_reference.md
   │   ├── adaptive_learning_reference.md
   │   └── case_studies.md
   └── scripts/
       ├── learning_manager.py
       └── market_analyzer.py
   ```
4. 无需API密钥或外部服务注册即可使用M1-M5；M6市场分析需要网络访问

### 安全与免责声明
- **法律免责**：本技能提供的审核意见、条款建议和争议函件仅供参考，不构成法律意见。涉及具体法律争议时，请咨询专业海事律师。
- **判例引用**：所有引用的英国法判例均为公开案例，基于已公开裁判文书整理，仅供论证参考。不保证判例在特定管辖区的适用性。
- **数据安全**：M6脚本从公开数据源获取市场指数，不采集用户隐私数据。用户上传的合同、SOF等文件仅在本地处理，不传输至外部服务器。
- **使用限制**：本技能聚焦干散货船程租（Voyage Charter）场景，不适用于期租（Time Charter）、光租（Bareboat Charter）或集装箱运输。超出适用范围的问题可能给出不准确的结果。
- **输出文件**：生成的Word/Excel文件请用户自行审阅确认后再用于正式场合，技能不对输出内容的商业后果承担责任。

---

## 资源索引

- 脚本 `scripts/learning_manager.py`：学习记录管理。参数：`--action record/query/analyze/export`，`--topic`，`--question-type`，`--content`，`--confidence`，`--source`，`--output`。用于M5交互后记录知识点、查询历史、分析学习分布。
- 脚本 `scripts/market_analyzer.py`：航运市场数据获取与分析。参数：`--index BDI/BCI/BPI/BSI/BHSI`，`--period 1m/3m/6m/1y`，`--data-file`。用于M6自动获取指数数据或分析用户提供的数据文件。
- 参考 `references/charterer_clause_library.md`：租家条款库。M1/M2读取。包含12项有利条款、10项高风险条款、替代措辞、谈判策略、Fixture Note完整模板、审核报告完整模板。
- 参考 `references/yang_liangyi_laytime_demurrage.md`：杨良宜《装卸时间与滞期费》核心内容。M2/M3/M4/M5读取。包含20章系统内容、40+英国法判例、关键判例速查表、实务警示。
- 参考 `references/laytime_calc_reference.md`：装卸时间计算Excel参考。M3读取。包含4个Tab结构、核心公式、常用术语对照表、多港计算规则、判例引用。
- 参考 `references/dispute_response_reference.md`：争议函件模板。M4读取。包含正式反驳函、邮件、部分接受函、时效抗辩函、中文模板、预判性防御示范、判例速查表。
- 参考 `references/adaptive_learning_reference.md`：自适应学习参考。M5读取。包含知识图谱（问题类型→参考文件映射）、诊断问题框架、4种典型应答模式、置信度披露标准。
- 参考 `references/case_studies.md`：典型案例库。M2/M4/M5读取。包含8个完整案例（案情、焦点、分析、判决、启示），涵盖港口拥挤、NOR有效性、战争险、天气中断、时效、滞期损失、WIBON边界、留置权争议。

---

## 输出标准（全模块通用）

- **简洁**：无废话，每句话传递价值
- **精确**：引用C/P条款原文，不转述生效条款
- **可操作**：每条建议附替代条款文本
- **权威**：每个法律主张引用判例或条款
- **双语**：中文=正式商务中文；英文=标准航运商务英文；不用拉丁语
- **主动**：预判对方下一步并提前应对
- **诚实**：附置信度标签 [Confidence: High/Medium/Low]，永不编造判例