skill-pour-interroger-judilibre-allison-fiorentino

name	skill-pour-interroger-judilibre-allison-fiorentino
description	>本技能提供对 judilibre API 的访问。您以法语提出请求，它查询 Judilibre 数据库并返回回答。 注意：本技能仅在使用了附加域名且用户输入了自己的 Judilibre 密钥时才能运行。 本技能及其作者与最高法院或 Judilibre 无任何关联。
metadata	{"author":"Allison Fiorentino","license":"agpl-3.0","version":"2026-06-25"}

Judilibre——司法判例

本技能查询 Judilibre API（最高法院）以检索和阅读司法序列的法院判决。工作通过脚本 scripts/judilibre_client.py 完成，该脚本处理身份验证并返回 JSON。

范围——如有需要告知用户

• ✅ 涵盖：最高法院（全部分庭），以及越来越多的上诉法院和一审法院（逐步扩容）。
• ❌ 不涵盖：文本（法典、法律、法令）和行政判例（最高行政法院、行政上诉法院、行政法院）。对此，引导至 OpenLegi / Légifrance 或其他来源。

配置（仅一次）

脚本需要一把 PISTE 密钥和经授权的网络访问。

1. API 密钥（KeyId 模式——推荐）。 一把简单的 API 密钥即可：即 KeyId 模式，密钥在 HTTP 请求头中发送。脚本按此顺序读取密钥：--key 参数、环境变量 JUDILIBRE_KEY_ID，然后是 scripts/config.json。如果未找到密钥，脚本返回明确错误。在这种情况下，向用户索取密钥，然后从 scripts/config.example.json 创建 scripts/config.json，将密钥粘贴到 key_id 字段并将 env 设为 prod（或 sandbox）。OAuth 客户端（client_id / client_secret）在 KeyId 模式下不需要：将这些字段留空。

   OAuth2 模式（高级，回退）。 如果用户没有 KeyId 但有 client_id / client_secret 对，填写这两个字段并将 key_id 留空；脚本将自动获取并缓存 Bearer 令牌。

   ⚠️ scripts/config.json 以明文包含密钥：绝不要显示或分享它。

2. 网络。 出站调用发往 *.piste.gouv.fr。如果脚本返回「无法连接到 piste.gouv.fr」或「网络域名未授权」错误，告知用户必须在 Claude 代码执行的网络设置中授权该域名：

   • api.piste.gouv.fr——必需（生产环境，KeyId 模式）；
   • sandbox-api.piste.gouv.fr——仅用于沙箱；
   • oauth.piste.gouv.fr 和 sandbox-oauth.piste.gouv.fr——仅用于 OAuth2 模式。

验证一切正常：python3 scripts/judilibre_client.py test。 此命令执行一次真实的认证检索（而非简单的健康检查），因此成功即确认密钥被接受。

用法

必要时安装依赖：pip install requests（已存在则静默）。

检索

python3 scripts/judilibre_client.py search "période d'essai rupture abusive" \
  --chamber soc --page-size 10

可用过滤器（全部可选）。类别过滤器接受多个值（用空格分隔）： --chamber（soc、civ1、civ2、civ3、comm、crim……）、--jurisdiction（cc、ca、tj）、 --type、--theme、--publication、--solution、--field、 --operator（and|or|exact）、--date-start AAAA-MM-JJ、--date-end AAAA-MM-JJ、 --page、--page-size（最大 50）、--sort（score|date）、--order（asc|desc）。

多值示例：--chamber soc comm 在两个分庭中检索。

输出为 JSON。每个结果的有用字段：id、number/numbers、 jurisdiction、chamber、formation、decision_date、solution、ecli、 publication、summary、themes、score，以及 url（courdecassation.fr 上决定的直接公开链接，由脚本添加）。

阅读完整决定

取用搜索结果中的 id：

python3 scripts/judilibre_client.py decision <id>

返回全文（text）、公开链接（url）和分区（zones：引言、案情陈述、理由、论证、判项、附件）。

了解某过滤器的取值

python3 scripts/judilibre_client.py taxonomy chamber

向用户呈现结果——始终如此

检索后，不要原样输出原始 JSON。呈现一份按相关性排序的清晰清单，每项决定注明：司法机构和分庭、上诉编号、日期、裁判结果（撤销、驳回……）、公布级别（P、B……）、可用时的简短摘要，以及指向文本的公开链接（url）。保留 id 以便按请求打开全文。提议显示完整判决或细化检索（分庭、时期）。

始终提醒这些仅是司法序列的决定。

出现错误时

脚本返回明确的 JSON 消息（error + fix）。将其简单转达给用户：

• 密钥缺失 → 索取密钥并保存在 scripts/config.json 中；
• 401 → 密钥错误或环境错误（sandbox 与 prod）；
• 403 → Judilibre CGU 未接受或 API 未挂靠到 PISTE 应用程序；
• 429 / 5xx → 达到配额或 API 不可用；脚本自动重试，否则稍候再运行；
• 无法连接 / 域名未授权 → 在网络设置中授权 api.piste.gouv.fr。