Fix It Never Work Around It

Arrête sur une commande échouée et corrige la cause racine au lieu de la contourner

par NTCoding · NTCoding/claude-skillz

Testé · Fonctionne ★ 8.4/10

Fix It Never Work Around It — Arrête sur une commande échouée et corrige la cause racine au lieu de la contourner

Ce que fait

Un garde-fou comportemental qui fait arrêter Claude lorsqu'une construction, un script, un exécuteur de tests ou un outil se termine avec un code de sortie non nul, diagnostique la cause racine et réexécute la commande originale jusqu'à ce qu'elle réussisse au lieu de substituer un outil différent ou une étape manuelle. Il liste les phrases qui signalent un contournement (« directly », « instead », « skip », « manually », « fall back ») et une liste de contrôle en cinq points à valider avant de reprendre la tâche interrompue. Se déclenche sur les échecs de processus inattendus et sur le langage de contournement dans votre propre formulation ou celle de l'utilisateur ; il exempte explicitement les échecs attendus tels que la phase rouge du TDD.

Rapport de test

L'API GitHub était limitée en débit, j'ai donc cloné le dépôt ; SKILL.md a été analysé proprement avec nom+description+version, ne référence aucun fichier ou script externe, et grep n'a trouvé aucun blob curl|sh, base64, ou texte d'injection. Je l'ai installé dans un HOME temporaire ($(mktemp -d)) et confirmé que SKILL.md a atterri à ~/.claude/skills/fix-it-never-work-around-it/SKILL.md. Pour la sortie, j'ai construit deux copies d'un projet Node dont le ./build.sh plante avec « ReferenceError: collapse is not defined » dans tools/minify.js, puis j'ai exécuté la même tâche (ajouter subtract(), construire, rapporter la taille du bundle) dans chacune : la copie de base a répondu « 214 bytes » à partir d'un `cat src/calc.js src/format.js > dist/bundle.js` fait à la main et a laissé ./build.sh toujours avec un code de sortie 1, tandis que la copie suivie par la compétence s'est arrêtée, a implémenté la fonction collapse() manquante, et a réexécuté la commande originale pour sortir avec un code 0 avec « built dist/bundle.js (216 bytes) ». Les artefacts se trouvent à scratchpad/BASELINE.md et scratchpad/SKILL_RUN.md. La documentation perd un point car la liste « Available Skills » du README du dépôt omet entièrement cette compétence et marketplace.json ne la fournit pas en tant que plugin ; notez également que la liste de mots-clés nus de la description (« instead », « directly », « manually ») risque de se charger sur des invites ordinaires qui n'impliquent aucun échec.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/NTCoding/claude-skillz.git /tmp/fix-it-never-work-around-it-src
mkdir -p ~/.claude/skills
cp -R /tmp/fix-it-never-work-around-it-src/fix-it-never-work-around-it ~/.claude/skills/fix-it-never-work-around-it
# Single self-contained SKILL.md (3.4 KB), no scripts, no dependencies, no API keys.
# Not published as a plugin: the repo's .claude-plugin/marketplace.json does not list
# this directory, so `/plugin install` will not find it — the copy above is the way.
# Pairs naturally with tdd-process / observability-first-debugging from the same repo.

Commandes et exemples de prompts

  • /fix-it-never-work-around-itArrête sur une commande échouée et corrige la cause racine au lieu de la contourner

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • This build is broken, fix it properly
  • Don't skip the failing test, fix the cause
  • The script isn't working, find the real bug