JuliusBrussee/surgical-patch

Corrige bugs e pequenas mudanças de comportamento na camada responsável mais estreita. Use quando a prova de regressão, a preservação do comportamento ao redor e os testes relevantes para a tarefa forem importantes.

O que é surgical-patch?

Esta skill, baseada no princípio de "patch cirúrgico", orienta o agente AI a realizar correções de bugs de forma precisa e minimamente invasiva. Em vez de refatorar ou reorganizar o código, a skill foca em identificar o sintoma do problema e rastreá-lo até o mecanismo responsável, alterando apenas a camada mais específica que possui o comportamento incorreto. É especialmente útil em sistemas complexos ou legados, onde mudanças amplas podem introduzir regressões. A skill recomenda, quando econômico, reproduzir a falha antes da correção; caso contrário, deve-se capturar a evidência mais forte disponível (como logs ou testes existentes). Após a alteração, deve-se executar a prova de foco (teste específico para a correção) e o gate afetado mais próximo (teste de regressão), parando apenas quando a falha for corrigida e a prova de regressão passar. A skill é independente de plataforma (funciona com Claude Code, Cursor, Codex, etc.) e seu valor está em preservar o comportamento não relacionado e as alterações do usuário, evitando limpeza, renomeação ou abstração desnecessárias.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuliusBrussee/caveman/tree/main/skills/surgical-patch

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

Patch cirúrgico

Reproduza a falha primeiro quando for econômico; caso contrário, capture a evidência mais forte disponível.

  • Rastreie o sintoma até o mecanismo responsável.
  • Altere a camada mais estreita que possui o comportamento incorreto.
  • Preserve o comportamento não relacionado e as alterações do usuário.
  • Evite limpeza, renomeação e abstração fora da correção.
  • Adicione apenas prova de regressão relevante para a tarefa.

Execute a prova de foco mais o gate afetado mais próximo. Pare quando a falha estiver corrigida e a prova de regressão passar.

Individual skills in this repo

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

JuliusBrussee/caveman-discover

Find and label every LLM workflow in the repository so Caveman Cloud groups spend by workflow instead of one bucket. Use for "discover workflows" or breaking LLM spend down by workflow.

JuliusBrussee/caveman-evidence-review

Read-only review of Caveman Cloud evidence: cost, Cave Score, workflows, traces, latency, errors, routing, savings. Use when asked what Caveman found or where LLM spend goes.

JuliusBrussee/caveman-explore

Read-only repository explorer for cold-start orientation, broad cross-file localization, or when a direct search failed. Skip it when the exact file or symbol is already named. Returns path:line citations only; its reads stay out of main context.

JuliusBrussee/caveman-learn

Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.

JuliusBrussee/caveman-manage

Inspect Caveman Cloud's experiment lifecycle and block unsafe execution. Use when asked to start, approve, cancel, promote or roll back a Caveman experiment.

JuliusBrussee/caveman-optimize

Turn a Caveman optimization observation into an operator-chosen candidate with a paired baseline evaluation. Use when asked to inspect or evaluate a Caveman optimization report. Needs explicit approval.

JuliusBrussee/caveman-setup

Wire a repository through the Caveman Cloud gateway so every LLM request is measured, with no behavior change. Use for "set up caveman" or adding LLM spend observability.

JuliusBrussee/investigate-first

Diagnose ambiguous failures before editing. Use for unknown causes, intermittent behavior, performance regressions, or investigations needing evidence-ranked hypotheses.

JuliusBrussee/lean-build

Build feature work with high overbuilding risk. Use for new behavior, product slices, or integrations where repository reuse, strict scope, and an explicit stop condition matter.

JuliusBrussee/migration

Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and preservation proof.

JuliusBrussee/safe-refactor

Restructure code while preserving behavior. Use for extraction, consolidation, ownership moves, or cleanup where verification must bracket structural edits.

JuliusBrussee/verify-and-stop

Prove existing work meets acceptance conditions without expanding scope. Use for validation-only tasks, completion checks, focused gate runs, and last-mile proof.

Habilidades Relacionadas