case-forecast：类案预判 + 法律检索

配置说明

获取 API Key：打开 https://h5.wintaocloud.com，登录后在个人中心或开发者中心获取
API Key 必须通过环境变量配置，不写入磁盘文件
```
export API_KEY=你的Key
```
requiredEnvVars: ["API_KEY"] — 运行时必须存在此环境变量
每日调用额度见问道云平台说明

⚠️ API Key 属于敏感信息，请妥善保管，不要泄露给他人。发现泄露请及时在问道云开放平台作废。

⚠️ 隐私与数据泄露风险（重要）：本技能将用户描述的案件内容（可能包含姓名、金额、纠纷细节等个人隐私）发送至问道云第三方 API 进行检索。这是一种固有风险——案件信息会被传输至外部服务器。如处理涉及当事人隐私的案件时，请确认符合当地隐私法规和道德准则，必要时建议用户自行判断是否适合使用本技能，或改用本地法律数据库替代。

配置

Base URL: https://h5.wintaocloud.com
认证: Authorization: Bearer {api_key}
请求方式: POST
载荷: {"content": "检索内容", "top_k": 3}（top_k 默认 3，最大 5）

接口

接口	完整路径	用途
法律条文	`https://h5.wintaocloud.com/prod-api/api/invoke/get-laws`	查询相关法律条文
类似案例	`https://h5.wintaocloud.com/prod-api/api/invoke/get-cases`	查询类似判例

调用方式

直接用 exec + curl 调用：

法律条文检索：

curl -s -X POST "https://h5.wintaocloud.com/prod-api/api/invoke/get-laws" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_KEY}" \
  -d '{"content": "检索关键词", "top_k": 3}'

类似案例查询：

curl -s -X POST "https://h5.wintaocloud.com/prod-api/api/invoke/get-cases" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_KEY}" \
  -d '{"content": "案例描述", "top_k": 3}'

输出格式

法律条文

[
  {
    "legalNature": "法律",
    "laws": [
      {
        "legalName": "中华人民共和国专利法",
        "total": 2,
        "items": [
          {
            "dataName": "第七十七条",
            "chapterName": "第一章",
            "content": "条文内容...",
            "score": 0.6233
          }
        ]
      }
    ]
  },
  {
    "legalNature": "行政法规",
    "laws": [
      {
        "legalName": "中华人民共和国专利法实施细则",
        "total": 3,
        "items": [
          {
            "dataName": "第一百二十条",
            "chapterName": "第三章",
            "content": "条文内容...",
            "score": 0.8567
          }
        ]
      }
    ]
  }
]

类似案例

[
  {
    "caseNumber": "（2024）粤知民终XX号",
    "caseFact": "案情摘要...",
    "content": "判决书内容...",
    "score": 0.6275
  },
  {
    "caseNumber": "（2023）沪民终XXX号",
    "caseFact": "案情摘要...",
    "content": "判决书内容...",
    "score": 0.7856
  },
  {
    "caseNumber": "（2024）京民终XX号",
    "caseFact": "案情摘要...",
    "content": "判决书内容...",
    "score": 0.8923
  }
]

展示时需格式化：

法律条文：标题 → 条号/章节 → 内容 → 相关度
类似案例：案号 → 摘要 → 预览（取前100字）

调用前检查

必须在使用 skill 之前检查 API_KEY 是否已配置。

检查方式：运行 [ -n "${API_KEY}" ] 或 test -n "${API_KEY}"，根据退出码判断是否已配置（退出码0=已设置，非0=未设置）。严禁使用 echo 打印 API_KEY 内容，否则会泄露到日志或对话历史中。

未配置时 → 立即告知用户"法律检索服务需要配置 API Key 才能使用"，并提供获取步骤。不再尝试调用接口。
已配置时 → 正常调用接口。

⚠️ 严禁在未确认 API_KEY 存在的情况下直接调用接口，失败后再告知用户。这是本 skill 的硬性规则，违者视为 bug。

错误处理

未设置 API_KEY → 事前告知（见上方"调用前检查"）
接口返回非 200 → 告知用户检查网络或 token
请求超时 → 告知用户稍后重试

触发场景

用户询问法律条文、法律依据
用户描述纠纷案例（"小明骗我2万"、"签合同被坑"）
用户明确说"帮我查 XX 的类似案例"
模糊时主动询问："需要我帮你检索相关法律条文和类似案例吗？"

Pre judgment of similar cases

安装技能