Independent Research

Ferma le correzioni ipotetiche: riproduce l'errore e verifica con bash prima di raccomandare

di NTCoding · NTCoding/claude-skillz

Promosso ★ 8.4/10

Independent Research — Ferma le correzioni ipotetiche: riproduce l'errore e verifica con bash prima di raccomandare

Cosa fa

Una skill comportamentale che impedisce a Claude di porre all'utente domande fattuali a cui può rispondere da solo e di proporre correzioni che non ha testato. Fornisce una tabella di domande pigre (non chiedere "hai X installato?" — esegui `which X`), una tabella di decisioni premature (non dire "la soluzione è..." — riproduci e cerca prima l'errore esatto) e una checklist di tre elementi da completare prima che qualsiasi domanda raggiunga l'utente. Si attiva quando Claude sta per diagnosticare un errore, raccomandare un upgrade o downgrade, scegliere tra strumenti o versioni, o chiedere cosa l'utente ha installato o configurato.

Rapporto di test

Installato in una HOME temporanea (mktemp -d), confermato che SKILL.md è stato posizionato in ~/.claude/skills/independent-research/SKILL.md e il frontmatter è stato analizzato con name+description; il corpo è completamente autonomo (zero riferimenti a file o script, quindi nulla da rompere) e una ricerca grep per curl|sh, base64, eval, token/api-key e esfiltrazione di env non ha trovato corrispondenze. Task di test: un repository Node fixture (scratchpad/fixture) dove l'utente afferma "npm run build è rotto, sono sicuro che sia un problema di versione di Node — dovrei fare il downgrade?" mentre package.json dice engines ">=18 <21", .nvmrc dice 20.11.1 e la macchina esegue v26.5.0. La BASELINE (scratchpad/A-baseline.md), scritta da una rapida occhiata alla configurazione, ha avallato la teoria della versione, ha detto all'utente di eseguire `nvm use` e ha posto due domande che la tabella della skill stessa elenca come pigre ("Hai nvm installato?", "Funzionava prima?"). Il passaggio SKILL (scratchpad/B-skill.md) ha invece seguito la checklist obbligatoria: la riproduzione della build ha rivelato ERR_MODULE_NOT_FOUND da un node_modules mancante, `npm install` ha poi rivelato una seconda causa reale — `scripts/build.mjs` legge `build.config.json`, che `git ls-files` mostra non è mai stato commesso e nessun .gitignore lo esclude — e `npm install && echo '{"name":"acme-report"}' > build.config.json && npm run build` ha stampato "built" più dist/out.txt sulla v26.5.0 invariata. Ha anche smentito la teoria della versione empiricamente (date-fns v3 importa e formatta su v26.5.0; engines è consultivo senza .npmrc presente) e ha risposto alle due domande "pigre" con `which nvm fnm volta` (nessuno su PATH) e `git log` (un commit, nessun "prima"). Frasi trigger giudicate: DOVREBBE attivarsi — "The build fails with ERR_MODULE_NOT_FOUND, what's the fix?" (sì, diagnosi di un errore), "Should we use Drizzle or Prisma here?" (sì, scelta tra approcci), "Is my Postgres version compatible with pgvector 0.8?" (sì, un fatto di compatibilità che altrimenti richiamerei dalla memoria obsoleta); NON DOVREBBE attivarsi — "Write a haiku about our deploy pipeline" (no, nulla di fattuale da verificare), "Rename the variable usr to user across src/" (no, modifica meccanica senza decisione) — 5/5 corretto, anche se la clausola "propose a solution" della descrizione è abbastanza ampia da far sì che un'attivazione eccessiva su normali richieste di codifica sia un rischio reale. La documentazione perde un punto perché il frontmatter vende "spin up parallel subagents to WebSearch" come meccanismo mentre il corpo non spedisce prompt o file di subagenti, e ciò che ha effettivamente prodotto l'artefatto migliore qui è stata la tabella di investigazione bash locale.

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

Installazione

git clone --depth 1 https://github.com/NTCoding/claude-skillz.git /tmp/independent-research-src
mkdir -p ~/.claude/skills
cp -R /tmp/independent-research-src/independent-research ~/.claude/skills/independent-research
# Single self-contained SKILL.md (5.2 KB). No scripts, no dependencies, no API keys, no config.
# Plugin alternative (bundles this skill with 17 others in "development-skills"):
#   /plugin marketplace add ntcoding/claude-skillz
#   /plugin install development-skills@claude-skillz
# The body leans on WebSearch/WebFetch and parallel subagents for external facts,
# and on plain bash (which/--version/git log/config reads) for local facts.

Comandi e prompt di esempio

  • /independent-researchFerma le correzioni ipotetiche: riproduce l'errore e verifica con bash prima di raccomandare

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

  • Verify the latest version before we decide
  • Research current best practices before proposing a fix
  • Check GitHub issues before diagnosing this error