QualidadeDeCodigo

Loop de qualidade de código para qualquer repositório, visto por duas lentes — uma lente de ferramentas (linters, verificadores de tipo, segurança, scanners de código morto e duplicação; corrige por prioridade P0 segurança → P1 correção → P2 manutenibilidade) e uma lente de princípios (SOLID + Clean Code smells; um princípio de cada vez, propor → confirmar → aplicar atrás de testes de caracterização). Um manifesto de ferramentas locais gratuitas, uma varredura, um loop de correção, um Relatório de Melhoria de Qualidade obrigatório.

O que é QualidadeDeCodigo?

CodeQuality é uma skill de IA especializada em loops de melhoria de qualidade de código, projetada para ser usada em qualquer repositório. Ela opera através de duas lentes complementares: a **lente de ferramentas**, que corrige automaticamente problemas identificados por scanners como linters, verificadores de tipo e ferramentas de segurança, seguindo uma ordem de prioridade P0 (segurança) → P1 (correção) → P2 (manutenibilidade); e a **lente de princípios**, que aplica princípios SOLID e Clean Code de forma iterativa, um de cada vez, sempre propondo a mudança antes de aplicá-la e criando testes de caracterização para código não testado. A skill mantém um manifesto centralizado de ferramentas em `Tools/tools.tsv`, que é lido tanto pelo script de instalação (`install-quality-tools.sh`) quanto pelo de varredura (`run-quality-baseline.sh`). Todos os artefatos de saída (relatórios, logs de sessão, inventário de smells) são armazenados em `reports/codequality/`. A skill é especialmente útil para desenvolvedores que precisam reduzir dívida técnica, aplicar princípios SOLID, analisar segurança ou preparar um sprint de remediação. Ela suporta JavaScript, Python e YAML, e integra-se perfeitamente com sistemas de fluxo de trabalho como IssueFlow, onde o workflow de Remediação chama esta skill para escopo e execução de correções.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/juanmherrerav/agent-workday-skills/tree/main/skills/CodeQuality

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

Personalização

Preferências pessoais opcionais: ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/CodeQuality/PREFERENCES.md.

Se esse arquivo existir, leia e aplique; caso contrário, prossiga com as configurações padrão da skill. Apenas preferências pessoais: qualquer fato sobre um repositório ou produto pertence ao repositório (seu .claude/workflow-profile.sh ou configurações de ferramentas), nunca aqui.

O que QualidadeDeCodigo faz?

Um loop, duas lentes. O loop é sempre detectar → escolher um item → corrigir com testes → verificar → repetir. A lente de ferramentas corrige o que os scanners sinalizam, em ordem de prioridade, com os testes existentes como proteção. A lente de princípios corrige o que torna o código difícil de mudar (classes god, duplicação, núcleos não testáveis), um princípio SOLID / Clean Code de cada vez, e nunca aplica uma mudança de design sem mostrá-la primeiro. Ambas as lentes leem o mesmo manifesto de ferramentas, escrevem no mesmo diretório de relatórios e terminam com o mesmo Relatório de Melhoria de Qualidade.

Duas lentes

Lente de ferramentasLente de princípios
Direcionadorsaída do scanner (summary.md)smells de design mapeados para Principles.md (smell-inventory.md, roadmap.md)
Unidade de trabalhoum achado: uma regra em um arquivo:linhaum princípio em um hotspot delimitado: uma Extração, uma divisão de classe, uma inversão de dependência
OrdemP0 segurança → P1 correção → P2 manutenibilidadeescada de alavancagem (abaixo), ajustada por repositório
Autonomiacorrige, depois mostra o diffpropor → confirmar → aplicar; nada é editado antes da aprovação
Rede de segurançatestes existentes permanecem verdestestes de caracterização escritos primeiro quando o alvo não é testado
Métricamenos achados, nova execução da ferramenta limpa% de duplicação, complexidade ciclomática, tamanho de função, fan-in/out, "agora testável unitariamente"
Escolha quandodívida de lint/tipo/segurança, CI vermelho, "faça os scanners felizes"código que resiste a mudanças; o nível estrutural de um sprint de remediação

O loop

VARRER → SELECIONAR → REDE DE SEGURANÇA → [PROPOR → CONFIRMAR] → CORRIGIR → VERIFICAR → RELATAR → REPETIR
                               └─ obrigatório no modo princípio, ignorado no modo ferramenta ─┘

Roteamento de workflow

GatilhoWorkflowProduz
"instalar ferramentas de qualidade", "configurar qualidade de código"Workflows/Install.mdferramentas do manifesto instaladas e verificadas
"varrer", "baseline", "analisar qualidade de código", "relatório de smells", "o que devemos corrigir primeiro", "roadmap de refatoração"Workflows/Scan.mdsummary.md (A), smell-inventory.md (B), roadmap.md (C)
"melhorar qualidade de código", "corrigir lint", "loop de qualidade", "corrigir [achado]"Workflows/Loop.md no modo ferramentacorreções, session-log.md, relatório
"refatorar", "aplicar SOLID", "limpar isso", "iniciar o loop"Workflows/Loop.md no modo princípiocorreções, session-log.md, relatório
"limpar este repositório" sem qualificadorVarredura A + B + C, depois Loop no modo princípiotudo acima
"sprint de remediação", "ciclo de remediação"IssueFlow Remediação é dono do branch, PR e merge; Varredura escopa o ciclo, Loop executaum PR por ciclo

O Loop escolhe seu modo por conta própria quando nenhum é fornecido: ferramenta quando não existe roadmap.md para o repositório, princípio quando existe. O usuário pode forçar qualquer um.

O manifesto

Tools/tools.tsv é a única lista de ferramentas nesta skill. Separado por tabulações, uma linha por ferramenta e idioma: linguagem categoria prioridade instalação execução notas, com linguagem em js | python | yaml, categoria em lint | format | types | security | deadcode | duplication | complexity | deps | coverage, prioridade em P0 | P1 | P2. Ambos os scripts leem; os workflows nunca listam ferramentas inline. Para adicionar ou remover uma ferramenta, edite uma linha.

ScriptLê do manifestoFaz
Tools/install-quality-tools.sh [--dry-run] [lingua ...]células instalação das linguagens escolhidasdetecta linguagens (package.json → js; pyproject.toml, requirements.txt ou *.py → python; *.yaml/*.yml → yaml); instala ferramentas js como devDependencies com o gerenciador de pacotes do repositório (lockfile → npm/pnpm/bun), ferramentas python e yaml com uv pip install ou pip; prefixos npm:/pip: substituem o canal, - não instala nada
Tools/run-quality-baseline.sh [--dry-run] [lingua ...]células execuçãoexecuta cada ferramenta em reports/codequality/<YYYY-MM-DD>-<HHMMSS>/, substituindo $OUT (diretório do relatório), $SRC (QUALITY_SRC_DIRS, padrão src se existir senão .), $PM e $NPX; uma ferramenta que não está instalada é MISSING, uma que trava é FAILED, nenhuma para a execução; escreve summary.md com status por ferramenta, contagens de problemas analisados e totais P0/P1/P2; imprime o caminho do relatório

Linhas cujo execução é - (ferramentas de cobertura) são instaladas mas não executadas pela baseline: a cobertura é medida no Loop, escopo do alvo. Toda ferramenta é gratuita e executa localmente; npm audit, pip-audit e checkov alcançam a rede apenas para seus bancos de vulnerabilidades.

Escada de alavancagem (ordem padrão da lente de princípios)

  1. Nomes — código que você não consegue ler, você não consegue alterar com segurança. Barato, desbloqueia tudo.
  2. DRY / duplicação — remove a maior quantidade de código com o menor risco; expõe abstrações ocultas.
  3. Funções pequenas — Método Longo → Extrair; um nível de abstração por função.
  4. SRP — dividir classes e módulos que mudam por mais de um motivo.
  5. OCP / DIP — inverter dependências, adicionar costuras; alto impacto, maior risco, rede de segurança primeiro.
  6. ISP / LSP — interfaces gordas e substituibilidade quebrada; precisam das costuras do passo 5.

A parte C da Varredura ajusta esta ordem ao inventário real (alavancagem = impacto ÷ risco; veja Principles.md Parte 3).

Inegociáveis

  • Um item por iteração. Um achado, ou um princípio em um alvo delimitado. Diffs pequenos e revisáveis.
  • Preservação de comportamento. Estrutura muda, comportamento não. Se o comportamento precisar mudar, pare e sinalize: isso é uma funcionalidade, não uma correção.
  • Verde para verde. Testes passam antes e depois. Vermelho após uma mudança significa reverter, nunca corrigir adiante.
  • Testes de caracterização primeiro quando as linhas a serem tocadas não são testadas. Sem rede, sem refatoração.
  • Propor antes de aplicar qualquer movimento de design (modo princípio). Modo ferramenta pode corrigir diretamente, depois mostra o diff.
  • P0 → P1 → P2 para achados de ferramentas, entre linguagens, nunca por linguagem.
  • Nunca enfraquecer um teste ou uma regra de lint para ficar verde. Testes obsoletos mudam para o novo comportamento correto; regras são satisfeitas no código.
  • Escoteiro, delimitado. Deixe arquivos tocados mais limpos, mas não expanda o escopo além do item atual.
  • Evidência, não opinião. Nomeie a regra ou princípio, e uma métrica onde existir.

Artefatos de saída

Todos em reports/codequality/ (ignorados pelo git):

ArquivoEscrito por
<YYYY-MM-DD>-<HHMMSS>/summary.md + saída bruta da ferramentarun-quality-baseline.sh (Varredura A)
<YYYY-MM-DD>/smell-inventory.mdVarredura B
<YYYY-MM-DD>/roadmap.mdVarredura C
<YYYY-MM-DD>/session-log.mdLoop, uma entrada por iteração
<YYYY-MM-DD>/quality-report.mdLoop, ao final da sessão (abaixo)

Relatório de Melhoria de Qualidade (obrigatório)

Toda sessão do Loop termina com este relatório, em qualquer modo. Ele é a entrega junto com a mudança de código e o corpo do PR ou comentário do tracker quando o trabalho é enviado pelo IssueFlow.

SeçãoConteúdo
Tabela resumolinhas adicionadas / removidas / líquido; problemas antes → depois por prioridade; hotspots de código morto removidos; testes antes → depois (contagem, todos verdes)
Código removidoarquivo, o quê, linhas, risco
Código adicionado ou modificadoarquivo, o quê, linhas, propósito
Bugs corrigidosseveridade, descrição, causa raiz (apenas se algum surgir)
Delta de complexidadecomplexidade ciclomática máxima e média antes → depois, com uma barra ASCII por hotspot
Adiadositens vistos mas fora de escopo, e por quê

Individual skills in this repo

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

BattlePlan

Daily execution plan from a task tracker (local CSV, Excel workbook, or Google Sheet). Groups open tasks by context and sub-context, estimates time, finds parallel threads, and writes ready-to-paste starting prompts per thread. Starts from yesterday instead of from zero — recaps the previous day's agent sessions and git commits, pre-fills the audit, and offers resume commands. Includes an end-of-day handoff (--close), an unattended morning draft (--draft), and task management (add, done, cancel, restore, sweep, batch import). USE WHEN plan my day, daily plan, battle plan, what should I work on, close the day, end of day handoff, morning draft, task overview, standup prep, prioritize tasks, add a task, mark task done, set up battleplan, configure task tracker.

MeetingAnalysis

Turn meetings into structured summaries and tracked action items. Transcribes recordings locally (faster-whisper on CUDA, Apple Silicon or CPU), imports Google Meet / Gemini notes through connectors, or takes pasted notetaker transcripts; writes a summary with decisions and an action table; pushes only your own items to the BattlePlan tracker. Includes an unattended inbox ingest (drop a recording, get a summary) and a hard rule that recordings never land in a git repo. USE WHEN analyze meeting, meeting summary, transcribe meeting, transcribe recording, summarize this call, what happened in the meeting, import meeting notes, Gemini notes, Google Meet notes, import meetings to tracker, auto ingest meetings, meeting inbox, process recordings folder, set up meeting analysis.

Habilidades Relacionadas