Hlzd Finance Risk

HLZD 信用证审单 v0.3（渐进式披露版）

v0.3 重构：v0.2 的 825 行 SKILL.md 收缩到 ~200 行，全部 ICC 规则原文从 SKILL.md 移出到 references/rules/*.md，SKILL.md 只保留触发 / 工作流 / 适配矩阵 / 检测算法。Claude 审单时按需 Read references/<file>.md 的对应章节，不一次性加载全文。

1. 三套规则库映射（先做这一步）

关键时限速查（细节条文按需读 references/）：

2. 工作流（14 步）

输入（L/C PDF / 扫描件 / MT700 SWIFT）
  ↓
[1]  OCR + 字段提取（Claude 直接 Read 文件，PDF/图片均可）
  ↓
[2]  文档类型识别（模板/草稿/已签发）→ scripts/detect_doc_type.py
  ↓       ├─ TEMPLATE → 列出 [Insert XXX] 字段，让用户填写后重提
  ↓       ├─ DRAFT → 提示等待正式版
  ↓       └─ ISSUED → 继续
  ↓
[3]  L/C 类型识别 → scripts/detect_lc_type.py
  ↓
[4]  HLZD 角色识别 → scripts/detect_role.py（受益人/申请人/担保人）
  ↓
[5]  按类型加载 references/ 索引：
  ↓       Commercial → references/index/ucp600_index.md + isbp745_index.md
  ↓       Standby    → references/index/isp98_index.md
  ↓       Guarantee  → references/index/urdg758_index.md
  ↓
[6]  按 Article/Rule 编号 → Read rules/<file>.md 的对应章节（grep 或行号）
  ↓
[7]  软条款扫描 → references/catalogs/soft_clauses_catalog.md（20+ 跨库条款）
  ↓
[8]  不符点检测 → references/catalogs/discrepancies_catalog.md
  ↓
[9]  装期/交单期/有效期协调（按 §1 时限表）
  ↓
[10] 银行国别风险评级（制裁名单 + 历史拒付，CRITICAL=制裁国）
  ↓
[11] 综合风险评级 = 不符点 + 软条款 + 银行风险 加权
  ↓
[12] 改单建议清单 + 谈判话术（references/catalogs/amendment_playbook.md）
  ↓
[13] 关联交叉验证（HLZD-智能报价 贸易术语 / HLZD-客户画像 国别风险）
  ↓
[14] 飞书卡片返回 + 审单报告 markdown（HLZD 抬头纸由 HLZD-办公文档 skill 生成 PDF）

3. 三个检测算法（伪代码，详细 Python 见 scripts/）

3.1 L/C 类型检测（scripts/detect_lc_type.py）

def detect_lc_type(text: str) -> str:
    t = text.upper()
    # 优先级 1: URDG 758
    if "URDG 758" in t or "DEMAND GUARANTEE" in t or "COUNTER-GUARANTEE" in t:
        return "DEMAND_GUARANTEE"
    # 优先级 2: ISP98
    if "STANDBY" in t or "ISP98" in t:
        for kw, lc_type in [
            ("PERFORMANCE", "PERFORMANCE_STANDBY"),
            ("ADVANCE PAYMENT", "ADVANCE_PAYMENT_STANDBY"),
            ("BID BOND", "BID_BOND_STANDBY"),
            ("DIRECT PAY", "DIRECT_PAY_STANDBY"),
        ]:
            if kw in t:
                return lc_type
        return "STANDBY"
    # 优先级 3: UCP 600 / 默认
    if "UCP 600" in t or "UCP600" in t or "DOCUMENTARY CREDIT" in t:
        return "COMMERCIAL_LC"
    return "UNKNOWN"

3.2 文档状态检测（scripts/detect_doc_type.py）

import re
def detect_doc_type(text: str) -> str:
    t = text.lower()
    # 模板: 3+ 个 [Insert XXX] 占位符
    placeholders = len(re.findall(r"\[insert [a-z\s]+\]", t))
    if placeholders >= 3:
        return "TEMPLATE"
    # 草稿: 含 draft / watermark / sample
    if any(k in t for k in ("draft", "watermark", "sample")):
        return "DRAFT"
    return "ISSUED"

3.3 HLZD 角色检测（scripts/detect_role.py）

def detect_role(text: str, hlzd_name: str) -> str:
    """根据 L/C 文本和 HLZD 公司名出现的位置判断角色"""
    upper = text.upper()
    hlzd_upper = hlzd_name.upper()
    for role, keyword in [("APPLICANT", "APPLICANT"),
                          ("BENEFICIARY", "BENEFICIARY"),
                          ("GUARANTOR", "GUARANTOR")]:
        idx = upper.find(keyword)
        if idx >= 0:
            window = upper[idx: idx + 300]
            if hlzd_upper in window:
                return role
    return "UNKNOWN"

完整实现见 scripts/。所有脚本遵循 _ensure_utf8_stdio() Windows 兼容模式（CLAUDE.md §1）。

4. 软条款 / 不符点 / 改单话术（按需读 references/catalogs/）

不要把 catalogs 一次性 Read 全文——先用 Grep 关键词定位，再用 Read 读目标行号。

5. 规则文件全文（只在条文引用时 Read）

索引文件（先用索引定位章节，再按行号 Read）：

• references/index/ucp600_index.md
• references/index/isbp745_index.md
• references/index/isp98_index.md
• references/index/urdg758_index.md

6. 错误地图

7. 协同串联

上游（被谁触发）：

• HLZD-智能报价：客户选 L/C 付款 → 自动调本 skill 预审 L/C 模板
• HLZD-询盘响应：客户提到 L/C → 自动加载本 skill
• HLZD-物流装箱：涉及担保/保函（L/G）→ 自动调本 skill

下游（触发谁）：

• 拒付风险高 → 自动调 HLZD-客户画像 更新客户风险等级
• 审单完成 → 自动调 HLZD-email-group 起草 L/C 接受通知
• 改单建议 → 自动调 HLZD-智能报价 生成修改后报价

被动提醒：

• 装期前 7 天 / 交单期前 3 天 / 有效期前 14 天 / 备用 L/C 修订前 7 天 / 保函到期前 30 天

8. 性能目标（p99）

9. 安全与合规

1. 不复述 ICC 规则原文——只引用 Article/Rule/Paragraph 编号 + 实务提示
2. 制裁合规——CRITICAL 风险国家自动阻止 + 法务通知
3. 审计日志——所有审单记录保存 5 年
4. 银行账号保密——只显示后 4 位
5. 反担保隔离——仅 HLZD 财务可见

10. 已知限制 + 路线图

11. 部署

# 打包（保留中文目录名 + Windows 兼容）
tar -czf hlzd-lc-review-v0.3.tar.gz HLZD-信用证审单/

# 部署到 Panmira
tar -xzf hlzd-lc-review-v0.3.tar.gz -C ~/.claude/skills/
mb skills install hlzd-lc-review 青囊

# Windows Junction（中文目录 + 英文别名）
mklink /J C:\Users\13864\.claude\skills\hlzd-lc-review C:\Users\13864\.claude\skills\HLZD-信用证审单

v0.3 vs v0.2 升级对比：

END of HLZD-信用证审单 v0.3 SKILL.md