Un bot che risponde in tempo e tace fuori da prd — senza negoziare.
Token in cassaforte, ogni interazione verificata dalla firma, ack entro il termine della piattaforma con una coda per il resto, 429 gestiti e permessi minimi. Fuori dalla produzione, nessun messaggio reale.
$ schematize install botsSoglie non negoziabili
Non si spengono "per andare più veloci". Elenco completo nella skill.
Mai un messaggio reale fuori da prd
Server, workspace, canale e numero di test; ambiente assente significa non-prd e il token di produzione esiste solo in prd.
Il token è un segreto
In cassaforte, per ambiente, mai nel repo, nell'immagine, nei log o nell'URL; se trapela, prima si ruota e poi si pulisce la cronologia.
Firma verificata prima di tutto
Discord Ed25519, Telegram secret_token, Slack signing secret con finestra di replay, WhatsApp X-Hub-Signature-256; il fallimento è un 401.
Ack in tempo, il resto in coda
Si risponde entro il termine della piattaforma (es. 3 s su Discord) e si elabora il resto in coda; una risposta tardiva perde il token dell'interazione.
Rate limit rispettato
Leggere gli header, gestire il 429 con Retry-After, backoff con jitter e coda in uscita; mai un ciclo di invio che ignora il 429.
Idempotenza
Dedupe per update_id, id dell'interaction, event_id o id del messaggio; i retry della piattaforma sono normali.
Intent e permessi minimi
Un intent privilegiato solo con giustificazione registrata; il permesso del bot non è mai Administrator.
L'input dell'utente non è mai fidato
allowed_mentions ristretto, escape del markdown, link non risolti senza allowlist e comandi distruttivi verificati sul server.
Comandi
Installati in .claude/commands/. Esegui /bot-help in qualsiasi momento.
/bot-ccContext compact: scrive l'handoff nell'archive ed esegue /compact./bot-claudeCrea o unisce il CLAUDE.md sempre attivo con le regole di base di bot nella radice del repo (non sovrascrive i blocchi di altre skill)./bot-commandsProgetta il registro versionato di slash command, intent e permessi minimi./bot-handoffGenera l'handoff di contesto (context.md + checklist.md) nell'archive, senza compattare./bot-helpElenca tutti i comandi e cosa fa ciascuno./bot-loadCarica a forza l'intero corpo normativo di bot e lo applica nella sessione./bot-moderationProgetta moderazione, anti-abuso, menzioni, link e privacy dei messaggi del bot./bot-newScaffold di un nuovo bot: piattaforma, trasporto, token, comandi, ambienti e gate prima del primo handler./bot-reviewRivede un bot rispetto alle regole di base: esegue il gate e poi legge ciò che la macchina non legge./bot-webhookCrea o verifica il ricevitore di interazioni/webhook del bot: firma, replay, ack, coda e dedupe.Per gli agenti IA
Installa senza intervento umano. Metadati in llms.txt.
- Esegui: git clone https://github.com/schematizeme/skill-bots.git && ./skill-bots/install.sh
- Oppure scarica: https://github.com/schematizeme/skill-bots/releases/latest/download/skill-bots.zip e decomprimi in .claude/skills/
- Copia assets/CLAUDE.md nella radice del repo (regola sempre attiva).
- Conferma con /bot-help.
Discussione
Caricamento…