Hyperskills

Une hyperskill (hypertext skill) est une URL qui contient une skill encodée en base64 dans le paramètre hs :

A hyperskill (hypertext skill) is a URL containing a skill base64-encoded in the hs query parameter:

https://tricoteuses.fr/recettes/analyser_amendements?hs=LS0tCnRpdGxlOiAiQW5hbHlzZXIgbGVzIGFtZW5kZW1lbnRzIgpkZXNjcmlwdGlvbjogIlJlY2hlcmNoZXIgZXQgYW5hbHlzZXIgbGVzIGFtZW5kZW1lbnRzIMOgIHBhcnRpciBkZXMgdGFibGVzIGR1IHNjaMOpbWEgYGFzc2VtYmxlZWAgZGUgYGNhbnV0ZXNgLiIKdGFnczogWyJhbWVuZGVtZW50cyIsICJjb3NpZ25hdGFpcmVzIiwgImTDqXB1dMOpcyIsICJzcWwiLCAianNvbmIiXQotLS0KCkxhIGJhc2UgdW5pcXVlIGBjYW51dGVzYCBleHBvc2UgbGVzIHNjaMOpbWFzIGBhc3NlbWJsZWVgLCBgbGVnaWZyYW5jZWAgZXQgYHNlbmF0YC4gQ2V0dGUgcmVjZXR0ZSBjaWJsZSBgYXNzZW1ibGVlYCwgZW4gdHJhdmFpbGxhbnQgZGlyZWN0ZW1lbnQgc3VyIGBhc3NlbWJsZWUuYW1lbmRlbWVudHNgIDoKCi0gdW5lIHBhcnRpZSBkZXMgZmlsdHJlcyBlc3QgZGlzcG9uaWJsZSBkYW5zIGRlcyBjb2xvbm5lcyBkw6lub3JtYWxpc8OpZXMgKGB0ZXh0ZV9sb2lfdWlkYCwgYGxlZ2lzbGF0dXJlYCksCi0gbGVzIHNpZ25hdGFpcmVzIGTDqXB1dMOpcyBkaXNwb3NlbnQgZCd1bmUgdGFibGUgZGUgam9pbnR1cmUgYGRlcHV0ZXNfc2lnbmF0YWlyZXNfYW1lbmRlbWVudHNgLAotIGlsIG4nZXhpc3RlIHBhcyBkZSB0YWJsZSByZWxhdGlvbm5lbGxlIGTDqWRpw6llIHBvdXIgdG91dGVzIGxlcyBjb3NpZ25hdHVyZXMsIGlsIGZhdXQgZG9uYyBjb21iaW5lciBqb2ludHVyZSBldCBKU09OQiBzZWxvbiBsZSBiZXNvaW4uCgojIyAxLiBSZWNoZXJjaGVyIGxlcyBhbWVuZGVtZW50cyBkJ3VuIGTDqXB1dMOpCg...

Format

URL source + ?hs= + base64 du contenu. Le contenu est libre (Markdown, SQL, YAML, HTML, texte) et la license aussi. Le format Agent Skills est recommandé mais pas obligatoire.

Source URL + ?hs= + base64 of the content. Content is free (Markdown, SQL, YAML, HTML, text) and so is the license. The Agent Skills format is recommended but not required.

Traçabilité

Traceability

Le hash SHA-256 de l'URL source + contenu sert de trace. Chaque version peut référencer le hash de la version précédente. Recommandé, pas obligatoire.

The SHA-256 hash of source URL + content serves as a trace. Each version can reference the previous version's hash. Recommended, not required.

Signature

L'auteur peut signer le hash. Ed25519 recommandé.

The author can sign the hash. Ed25519 recommended.

Taille

Size

La taille maximum du paramètre hs dépend du navigateur :

The maximum size of the hs parameter depends on the browser:

Chrome        ~32 000 caractères / characters
Firefox       ~65 000 caractères / characters
Safari        ~80 000 caractères / characters
Edge          ~32 000 caractères / characters
Android       ~8 000 caractères / characters

La recette analyser_amendements de tricoteuses fait 4 895 octets en clair, 6 528 caractères en base64. Elle passe sur tous les navigateurs modernes. Avec compression (préfixe gz. ou br.), des skills de 250-500 Ko tiennent dans ~32 000 caractères.

The analyser_amendements recipe from tricoteuses is 4,895 bytes raw, 6,528 characters in base64. It fits in all modern browsers. With compression (prefix gz. or br.), skills of 250-500 KB fit in ~32,000 characters.

Voir aussi

See also

Skillpedia, MCP, WebMCP, Agent Skills.

Générer une hyperskill

Generate a hyperskill

URL source :

Source URL:

Contenu de la skill :

Skill content:

---
title: "Analyser les amendements"
description: "Rechercher et analyser les amendements à partir des tables du schéma `assemblee` de `canutes`."
tags: ["amendements", "cosignataires", "députés", "sql", "jsonb"]
---

La base unique `canutes` expose les schémas `assemblee`, `legifrance` et `senat`. Cette recette cible `assemblee`, en travaillant directement sur `assemblee.amendements` :

- une partie des filtres est disponible dans des colonnes dénormalisées (`texte_loi_uid`, `legislature`),
- les signataires députés disposent d'une table de jointure `deputes_signataires_amendements`,
- il n'existe pas de table relationnelle dédiée pour toutes les cosignatures, il faut donc combiner jointure et JSONB selon le besoin.

## 1. Rechercher les amendements d'un député

La façon la plus robuste pour les députés est d'utiliser la table de jointure `deputes_signataires_amendements`.

### Amendements dont il est auteur principal

```sql
SELECT
  a.uid,
  a.texte_loi_uid,
  a.legislature,
  a.data->'identification'->>'numeroLong' AS numero_long,
  a.data->'cycleDeVie'->>'dateDepot' AS date_depot,
  a.data->'cycleDeVie'->'etatDesTraitements'->'etat'->>'libelle' AS sort,
  a.data->'pointeurFragmentTexte'->'division'->>'articleDesignationCourte' AS article
FROM assemblee.deputes_signataires_amendements dsa
JOIN assemblee.amendements a ON a.uid = dsa.amendement_uid
WHERE dsa.depute_uid = 'PA722142'
  AND dsa.auteur = true
ORDER BY a.data->'cycleDeVie'->>'dateDepot' DESC;
```

### Amendements qu'il a signés, auteur compris

```sql
SELECT
  a.uid,
  dsa.auteur,
  a.data->'identification'->>'numeroLong' AS numero_long,
  a.data->'signataires'->'auteur'->>'acteurRef' AS auteur_uid,
  a.data->'cycleDeVie'->>'dateDepot' AS date_depot
FROM assemblee.deputes_signataires_amendements dsa
JOIN assemblee.amendements a ON a.uid = dsa.amendement_uid
WHERE dsa.depute_uid = 'PA722142'
ORDER BY a.data->'cycleDeVie'->>'dateDepot' DESC;
```

### Amendements cosignés mais non écrits

```sql
SELECT
  a.uid,
  a.data->'identification'->>'numeroLong' AS numero_long,
  a.data->'signataires'->'auteur'->>'acteurRef' AS auteur_uid,
  a.data->'cycleDeVie'->>'dateDepot' AS date_depot
FROM assemblee.deputes_signataires_amendements dsa
JOIN assemblee.amendements a ON a.uid = dsa.amendement_uid
WHERE dsa.depute_uid = 'PA722142'
  AND dsa.auteur = false
ORDER BY a.data->'cycleDeVie'->>'dateDepot' DESC;
```

## 2. Fallback JSONB sur les signataires

Pour des analyses ponctuelles ou pour préparer une future recette Sénat, on peut repartir du JSONB :

```sql
SELECT uid
FROM assemblee.amendements
WHERE data->'signataires'->'auteur'->>'acteurRef' = 'PA722142';
```

```sql
SELECT uid
FROM assemblee.amendements
WHERE data->'signataires'->'cosignatairesRefs' ? 'PA722142'
  AND data->'signataires'->'auteur'->>'acteurRef' <> 'PA722142';
```

## 3. Filtrer les amendements d'un texte législatif

La colonne `texte_loi_uid` est plus pratique que le JSON quand on part d'un document.

```sql
SELECT
  uid,
  data->'identification'->>'numeroLong' AS numero_long,
  data->'cycleDeVie'->>'dateDepot' AS date_depot,
  data->'cycleDeVie'->'etatDesTraitements'->'etat'->>'libelle' AS sort
FROM assemblee.amendements
WHERE texte_loi_uid = 'PRJLANR5L16B0760'
ORDER BY data->'cycleDeVie'->>'dateDepot' DESC;
```

## 4. Relier les amendements au document et au dossier

Le couple `amendements.texte_loi_uid -> documents.uid` permet de relier un amendement à son document et à son dossier.

```sql
SELECT
  a.uid,
  a.data->'identification'->>'numeroLong' AS numero_long,
  d.uid AS document_uid,
  d.dossier_uid,
  d.data->'titres'->>'titrePrincipal' AS titre_document
FROM assemblee.amendements a
LEFT JOIN assemblee.documents d ON d.uid = a.texte_loi_uid
WHERE a.uid = 'AMANR5L16PO420120B0760P0D1N001227';
```

## 5. Regrouper les amendements d'un acteur par dossier

```sql
SELECT
  d.dossier_uid,
  dos.data->'titreDossier'->>'titre' AS titre_dossier,
  COUNT(*) AS nb_amendements
FROM assemblee.deputes_signataires_amendements dsa
JOIN assemblee.amendements a ON a.uid = dsa.amendement_uid
LEFT JOIN assemblee.documents d ON d.uid = a.texte_loi_uid
LEFT JOIN assemblee.dossiers dos ON dos.uid = d.dossier_uid
WHERE dsa.depute_uid = 'PA722142'
GROUP BY d.dossier_uid, dos.data->'titreDossier'->>'titre'
ORDER BY nb_amendements DESC, titre_dossier NULLS LAST;
```

## 6. Rechercher les députés qui collaborent sur un amendement

Il n'y a pas de table `coSignatairesAmendement` complète, mais on peut lister les députés liés à un amendement :

```sql
SELECT
  dsa.amendement_uid,
  dsa.auteur,
  a.uid AS acteur_uid,
  a.nom_complet,
  a.depute_groupe_parlementaire_uid
FROM assemblee.deputes_signataires_amendements dsa
JOIN assemblee.acteurs a ON a.uid = dsa.depute_uid
WHERE dsa.amendement_uid = 'AMANR5L16PO420120B0760P0D1N001227'
ORDER BY dsa.auteur DESC, a.nom_complet;
```

Hyperskill :

Hyperskill:

Décoder une hyperskill

Decode a hyperskill

Coller une hyperskill :

Paste a hyperskill:

URL source :

Source URL:

Contenu :

Content:

CC-BY-SA-4.0 — hyperskills.net

GitHub