mattpocock/diagnose

Loop disciplinado de diagnóstico para bugs difíceis e regressões de desempenho. Reproduzir → minimizar → hipotetizar → instrumentar → corrigir → testar regressão. Use quando o usuário disser "diagnostique isto" / "depure isto", relatar um bug, disser que algo está quebrado/lançando erros/falhando, ou descrever uma regressão de desempenho.

O que é diagnose?

O skill 'mattpocock/diagnose' fornece um loop de diagnóstico estruturado para agentes de IA (como Claude Code, Cursor, Codex) lidarem com bugs difíceis e regressões de desempenho de forma disciplinada. Ele orienta o agente através de seis etapas: Reproduzir, Minimizar, Hipotetizar, Instrumentar, Corrigir e Testar Regressão. Este skill é particularmente útil quando o usuário diz "diagnostique isso" / "depure isso", relata um bug, indica que algo está quebrado, lançando erros ou falhando, ou descreve uma regressão de desempenho. Ao seguir este loop metódico, o agente pode abordar problemas complexos de forma sistemática, garantindo que a causa raiz seja identificada e corrigida sem introduzir novas regressões. O skill suporta plataformas como Claude Code, Cursor e Codex, e funciona com qualquer ambiente de desenvolvimento que aceite instruções de agente baseadas em markdown.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/diagnose

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que diagnose faz?

Loop disciplinado de diagnóstico para bugs difíceis e regressões de desempenho. Reproduzir → minimizar → hipotetizar → instrumentar → corrigir → testar regressão. Use quando o usuário disser "diagnostique isto" / "depure isto", relatar um bug, disser que algo está quebrado/lançando erros/falhando, ou descrever uma regressão de desempenho.

Como usar

Este skill é ativado automaticamente quando palavras-chave como "diagnose", "debug", "bug", "broken", "throwing", "failing" ou "performance regression" são detectadas.

Etapas do loop

  1. Reproduzir: Execute o cenário de bug ou regressão de desempenho.
  2. Minimizar: Reduza o caso de teste ao mínimo necessário.
  3. Hipotetizar: Crie uma ou mais hipóteses sobre a causa raiz.
  4. Instrumentar: Adicione registros, métricas ou ferramentas de depuração.
  5. Corrigir: Aplique a correção com base na hipótese confirmada.
  6. Testar Regressão: Execute testes automatizados para garantir que nada foi quebrado.

Exemplo de prompt

O usuário diz: "Diagnostique por que o método createUser está lançando um erro 500."

O agente então iniciará o loop de diagnóstico.

$ Reproduzir: execute a requisição POST /api/users com payload { name: "João" }
$ Minimizar: verifique se o erro ocorre com o campo 'name' sozinho
$ Hipotetizar: o middleware de validação pode estar com erro de tipo
$ Instrumentar: adicione console.log no validador
$ Corrigir: ajuste a validação para aceitar strings
$ Testar Regressão: execute npm test

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/domain-modeling

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/implement-spec

Implement a specification in code.

mattpocock/improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock/loop-me

Grill me about specs for the workflows I want to build, within this workspace.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

Habilidades Relacionadas