| 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 密钥和经授权的网络访问。
-
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 以明文包含密钥：绝不要显示或分享它。
-
网络。 出站调用发往 *.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。
