案件云 AI Agent Skill

让 AI 通过自然语言操作案件云系统 —— 查询案件、管理日程、查看客户、更新记录等。

这是什么

这是一个 AI Agent 的自定义 Skill，通过案件云 Open API 实现自然语言交互。

用户只需说"查询我的案件"、“今天有什么安排”、“更新客户信息”，AI 即可自动调用对应 API 完成操作。

更多信息可参考：https://www.law086.com/products/skill

快速开始

1. 安装

将本目录复制到你的 AI Agent（openclaw、hermes、workbody、claudecode等） skills 目录下：

cp -r skill/ ~/.claude/skills/law086/

2. 配置

复制 .env.example 为 .env，填入你的 PAT Token：

cp .env.example .env

编辑 .env：

# 生产环境
API_BASE_URL=https://open.law086.com/api/v1

# 在案件云 OA「个人设置 > AI管理」中生成 PAT
PAT_TOKEN=law086_pat_你的令牌

3. 生成 PAT Token

1. 登录案件云 OA: https://oa.law086.com
2. 进入 个人设置 > AI管理
3. 点击"生成新令牌"，选择权限范围
4. 复制 Token（以 law086_pat_ 开头）到 .env

4. 更新 Skill

⚠️ 不要删除重装！ 删除会丢失 .env 配置（包括 PAT Token），导致需要重新生成。

正确方式 — 进入 skill 目录拉取更新：

cd ~/.claude/skills/law086/ && git pull

.env 文件不在 git 管理范围内，git pull 不会覆盖你的配置。

5. 使用

在 AI Agent 中直接用自然语言：

支持的功能

目录结构

law086/
├── SKILL.md                    # Skill 定义文件（AI Agent 读取）
├── .env.example                # 环境配置模板
├── scripts/
│   └── api.py                  # API 调用脚本（自动处理认证和编码）
└── references/
    └── api-reference.md        # 完整 API 参考文档

API 调用脚本

scripts/api.py 是统一 API 调用入口，自动处理认证、中文编码和错误格式化：

# GET 请求
python3 scripts/api.py GET /cases
python3 scripts/api.py GET "/cases?keyword=张三"

# POST 请求（中文直接写，无需担心编码）
python3 scripts/api.py POST /calendar '{"title":"开庭","htime":"2026-05-10 14:00","endtime":"2026-05-10 15:00"}'

# PATCH 请求
python3 scripts/api.py PATCH /records/abc123 '{"hstatus":1}'

数据权限

律所拥有者全所范围（始终开启，无灰度开关）：律所拥有者（顶层律所 org + OWNER 角色）的 PAT，可见范围自动展开为「顶层律所 + 所有直接子团队 org」。

• 读端点（GET 类）：全所可见（cases/clients/projects/finance/dashboard/search/calendar/team/records/contracts 等）。
• 团队/律所管理员或拥有者：本 org 下全部数据；其中团队拥有者/管理员可修改本 org 团队成员的日程（PUT /calendar/{id} 不限于本人主办/协办）。
• 编辑端点（PATCH/PUT/上传）：owner 可跨子团队编辑/上传全所任意记录；编辑不改归属（保留记录自身 org_id）；成员校验用记录自身 org。
• 新建端点（POST /cases、/clients、/projects、/calendar、/contracts）：支持可选请求参数 org_id（hashid），owner 可指定新记录归属到本所内任意子团队；解码后校验 ∈ 全所集合，不在则报错「目标组织不在本所范围」；未传默认归属 PAT 绑定 org。
• 普通成员（非管理员/拥有者、非律所顶层 owner）PAT 行为零变化：读只看本 org/自己参与；写端点传非自身 org 会报「目标组织不在本所范围」。
• owner 角色被撤销后最多 60s 内（子树缓存 TTL）收缩为单 org。
• 组织结构目前仅支持扁平一层；多级团队（律所→部门→小组）的递归展开为二期。
• 跨子团队 host/assit 改派未开放（指案件层面主办/协办律师改派，update 不暴露 host/assit 字段；待办层面 团队/律所管理员或拥有者通过 POST /calendar 创建日程时已支持指定主办人 huser，详见 SKILL.md「主办人指派」）。

技术栈

• API: 案件云 Open API V2.0
• 认证: PAT (Personal Access Token)
• 协议: HTTPS + JSON
• Base URL: https://open.law086.com/api/v1

License

MIT