SKILL.md — 合同履约追踪

简介

上传合同 PDF → AI 自动提取付款节点/交期/到期日 → 履约台账 + 飞书提醒。

履约状态： 🟡待执行 / 🟢已完成 / 🔴已逾期

核心流程

用户上传合同 PDF（或粘贴文本）
AI 自动提取字段：合同名称/编号、签署日期、付款节点、交期/交付节点、合同到期日、违约金条款
建立履约台账（本地 JSON，可导出 CSV）
飞书消息推送提醒

提醒规则：

节点前 3 天推送飞书
当天推送飞书
逾期每天推送飞书（直到标记完成）

输入方式

| 方式 | 说明 | |------|------| | PDF 上传 | 合同全文自动解析 | | 文本输入 | 粘贴关键条款，人工补全字段 | | 历史记录 | 查询已有合同状态 |

履约节点类型

付款节点：金额 + 日期
交期/交付节点：内容 + 日期
合同到期日：最终期限
违约金/罚则：金额或比例

套餐体系

| 套餐 | 价格 | 功能 | |------|------|------| | Free | 免费 | 3 合同/月，PDF 解析，基础提醒 | | Standard | ¥29/月 | 20 合同/月，文本+PDF，全功能提醒 | | Pro | ¥99/月 | 100 合同/月，逾期分析，导出 CSV | | Max | ¥299/月 | 无限合同，高级报表，数据看板 |

技术要求

Token 验证：POST https://api.yk-global.com/v1/verify，Authorization: Bearer {api_key}，请求体 {}，用 valid 字段判断
降级策略：网络错误 → FREE tier，不阻断使用
缓存：验证结果缓存本地 5 分钟（TTL 300s）
AI 模型：不绑定、不推荐、不限定，用户自行配置 API Key
数据存储：本地 JSON 文件

配置项

用户需配置：

api_key：Token（格式 CONT-TRACK-*）
ai_api_key：AI 模型 API Key
ai_base_url：AI 模型地址（可选）
feishu_webhook：飞书机器人 Webhook URL

履约状态说明

| 状态 | 含义 | |------|------| | 🟡待执行 | 节点未到截止日期 | | 🟢已完成 | 用户手动标记完成 | | 🔴已逾期 | 超过截止日期且未完成 |

输出格式

履约台账示例

{
  "contracts": [
    {
      "id": "uuid",
      "name": "采购合同-供应商A",
      "number": "PO-2026-001",
      "sign_date": "2026-01-15",
      "expiry_date": "2026-12-31",
      "nodes": [
        {
          "id": "node-1",
          "type": "payment",
          "description": "首付款 30%",
          "amount": 30000,
          "due_date": "2026-04-30",
          "status": "pending"
        }
      ],
      "created_at": "2026-04-22T00:00:00Z"
    }
  ]
}

飞书提醒消息格式

📋 合同履约提醒
合同：采购合同-供应商A
节点：首付款 30% | ¥30,000
截止日期：2026-04-30
状态：🟡 距截止还有 3 天

👉 [查看详情]