zhihe-legal-research

name	zhihe-legal-research
title	智合法律研究
description	连接智合AI法律大模型平台进行法律研究。本技能应在用户需要进行法律问题研究、查找法律法规、检索类似案例、或获取法律研究报告时使用。需要智合AI平台会员账号。
author	cat-xierluo
author_url	https://github.com/cat-xierluo/legal-skills/tree/main/skills/zhihe-legal-research
license	MIT
version	0.1.0
execution_mode	open
jurisdiction	cn
practice	general
language	zh

智合法律研究

连接智合AI法律大模型平台，提供专业的法律调研分析服务。

⚠️ 异步任务处理机制

法律研究是异步长任务（3-10分钟）。采用用户主动查询机制，兼容所有 AI Agent 平台（Claude Code、OpenClaw 等）：

用户提交 → 获得任务 ID → 用户稍后主动查询 → 获取结果并归档

核心原则：

• 不在每次消息前自动检查结果——避免旧结果污染当前对话
• 仅在用户主动询问研究结果时才查询状态和结果
• 每次查询完毕后立即归档——确保状态干净，不留残留数据

---

工作流程

步骤 1：检查登录状态

./scripts/auth.sh check

• is_vip: true → 已登录，继续
• code: 401 → 需要登录（执行步骤 2）

步骤 2：登录（如需）

# 发送验证码（如果已保存手机号，可省略手机号参数）
./scripts/auth.sh send-code [手机号]

# 验证登录（自动保存 Token 和手机号）
./scripts/auth.sh verify <手机号> <6位验证码>

自动重登流程：如果 config 中已保存 LEGAL_RESEARCH_PHONE，token 失效时可直接执行 ./scripts/auth.sh send-code（无需传入手机号），系统自动使用保存的手机号发送验证码。用户只需提供验证码即可完成重登。

步骤 3：提交法律问题

# 提交问题
./scripts/research.sh submit "<用户的法律问题>"

提交成功后，记录 task_id 并告知用户：

✅ 您的法律问题已提交，后台正在进行调研分析。 ⏱️ 预计需要 3-4 分钟完成。 📋 任务 ID：{task_id}

👉 请在约 4 分钟后回复"查看结果"或"研究结果好了吗"来获取分析报告。

步骤 4：查询结果（仅当用户主动询问时）

触发条件： 用户主动询问研究结果（如"查看结果"、"结果出来了吗"等）。

如果用户提供了 task_id，直接查询；如果未提供，先查历史获取最近任务：

# 如果没有 task_id，先查历史
./scripts/research.sh history 1 3

然后查询状态：

# 查询状态
./scripts/research.sh status <task_id>

根据状态处理：

状态	处理方式
completed	获取结果 → 获取报告 → 归档 → 展示给用户
running	告知用户继续等待 1-2 分钟后再查询