Skip to content

Commit c2bb551

Browse files
aborrusoclaude
andcommitted
docs(skill-cli): distingui i due 403 del Senato (dimensione vs frequenza)
Stesso codice e stessa pagina di errore per due cause opposte: nel primo caso ritentare è inutile (va accorciata la query), nel secondo è dannoso. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
1 parent 37a8358 commit c2bb551

1 file changed

Lines changed: 5 additions & 0 deletions

File tree

skills/italian-parliament-cli/SKILL.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -115,6 +115,7 @@ Regole d'oro:
115115
- **Prova più sinonimi e radici di parola** prima di concludere. Preferisci la **radice** breve che copre più forme: `elett` → elettorale/elettori, `elez` → elezione/elezioni (occhio: `elezioni` al plurale non matcha un titolo con `elezione` al singolare — la radice sì); `ambient` → ambiente/ambientale. Se il tool matcha a confini di parola (es. `aic --keyword`), usa più keyword separate.
116116
- **Vuoto ≠ assente.** Se non trovi nulla, riformula con un sinonimo o una radice prima di dire all'utente che il dato non c'è. Solo dopo 2-3 varianti fallite l'assenza è credibile.
117117
- **Sindacato ispettivo (Senato) non è ricercabile per argomento**: `sindacato-ispettivo --keyword` non filtra sull'oggetto perché il LOD Senato non espone l'oggetto/testo dell'atto (solo tipo, numero, data, firmatari). Il testo vive solo nella pagina HTML esterna. Non promettere ricerche tematiche su questo tool.
118+
- **Sul Senato la keyword corta conviene due volte.** Oltre a matchare più forme, evita di sbattere contro il limite di dimensione delle richieste (vedi Tips): sui tool Senato la keyword entra tre volte nella query, quindi una frase lunga la fa crescere in fretta.
118119

119120
## Grounding (non inventare)
120121

@@ -133,3 +134,7 @@ Quando ricostruisci iter, voti o schede, il rischio è la **confabulazione su sc
133134
- **Senato confidence votes have empty `ddl_uri` at the source**, but `senato-votes list --ddl-uri <uri>` **now returns the *fiducia* anyway** (it resolves the DDL's seduta dates and re-links the confidence vote of that day). Still check `ddl_uri` on any "final" vote found by date: it may belong to a different act (unified text). `--ddl-uri` **derives the legislature from the DDL**, so a historical DDL (e.g. leg.18 `http://dati.senato.it/ddl/52988`) works without passing `--legislature`.
134135
- **Senato — quando c'è il voto individuale**: `senato-vote-detail` dà il sì/no del singolo senatore solo per i voti di **merito** (`type` = `elettronica`, `nominale con appello`, `controprova`). Per `segreta` (voto segreto) e `verifica numero legale` (conteggio del quorum) restituisce solo le presenze (`Presente non votante`, `In congedo/missione`), **mai** una scelta espressa (né `Favorevole`, né `Contrario`, né `Astenuto`): la scelta non è nel dato. Non dedurre il voto individuale su queste due modalità.
135136
- **Question time Camera per sede**: le interrogazioni a risposta immediata hanno la sede nel label in modo regolare, e `aic --type` matcha anche sul label. Quindi la sede è già filtrabile senza campo dedicato: `aic list --type "immediata in assemblea"` = question time in Aula, `aic list --type "immediata in commissione"` = in commissione (combinabile con `--keyword <tema>`).
137+
- **Senato: due errori diversi si presentano allo stesso modo.** L'endpoint del Senato accetta richieste fino a **2047 byte** di URL e rifiuta le più lunghe, ma risponde `403` sia in quel caso sia quando le richieste sono troppo ravvicinate — e la pagina di errore è identica. Regola pratica:
138+
- **"Query troppo lunga per l'endpoint del Senato"** (errore della CLI, prima di uscire in rete): accorcia la keyword — una radice breve basta, il match è per sottostringa — oppure restringi l'intervallo di date. Ritentare identico non serve a nulla.
139+
- **`403` restituito dall'endpoint**: sono troppe richieste ravvicinate. Aspetta qualche minuto, non ritentare a raffica. La CLI già distanzia di 2 secondi le proprie chiamate al Senato: il blocco arriva quando si sommano più comandi o test in sequenza.
140+
- Nota: il limite riguarda **solo il Senato**. La Camera accetta richieste molto più grandi.

0 commit comments

Comments
 (0)