Speq Audit

Audit di integrità in sola lettura per librerie di specifiche speq con correzioni controllate

di marconae · marconae/speq-skill

Richiede configurazione ★ 8.0/10

Speq Audit — Audit di integrità in sola lettura per librerie di specifiche speq con correzioni controllate

Cosa fa

Verifica l'integrità di un progetto speq attraverso 12 controlli in sola lettura: struttura della libreria di specifiche, validazione feature/decision-log/plan, sincronizzazione mission-to-spec, piani non registrati e igiene gitignore, quindi offre di correggere ogni problema uno alla volta. Si attiva quando si chiede di controllare, verificare l'integrità, diagnosticare, fare lint o sanity-check delle specifiche o del repo, o dopo aver clonato o ereditato un progetto speq.

Rapporto di test

Eseguiti i controlli in sola lettura dal vivo contro il repo della skill stessa e ha rilevato problemi reali: cli/plan-validate contiene 15 scenari (oltre la soglia di 10) e il dominio cli contiene 12 feature (oltre 8), insieme a un gitignore pulito e uno stato git pulito. È un orchestratore genuinamente in sola lettura con ogni rimedio controllato da un esplicito Sì. Attrito: quattro dei suoi dodici controlli chiamano la CLI Rust speq (feature/decision-log/plan validate) più un sub-agente mission-sync, nessuno dei quali funziona autonomamente senza compilare il binario e installare le skill complementari speq-cli e speq-writing-guardrails. La checklist basata su soglie numeriche ha superato una revisione ad-hoc, ma un terzo dei controlli era incommensurabile da solo.

Testato il: 2026-07-24 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/marconae/speq-skill
mkdir -p ~/.claude/skills
cd speq-skill && cp -r .claude/skills/speq-audit ~/.claude/skills/speq-audit

Comandi e prompt di esempio

  • /speq-auditAudit di integrità in sola lettura per librerie di specifiche speq con correzioni controllate

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Audit the health of our speq spec library and report issues
  • Doctor-check this repo's specs after I just cloned it
  • Lint the feature and decision logs for sync issues