CommunityProgramación y desarrollogithub.com

CodeQuality

Bucle de calidad de código para cualquier repositorio, visto a través de dos lentes: una lente de herramientas (linters, verificadores de tipos, seguridad, escáneres de código muerto y duplicación; corre por prioridad P0 seguridad → P1 corrección → P2 mantenibilidad) y una lente de principios (olores SOLID + Clean Code; un principio a la vez, proponer → confirmar → aplicar detrás de pruebas de caracterización). Un único manifiesto de herramientas locales gratuitas, un análisis, un bucle de corrección, un informe obligatorio de mejora de calidad. ÚSALO para mejorar calidad de código, analizar código, corregir linting, reducir duplicación, añadir tipos, escanear seguridad, cobertura de pruebas, refactorizar, mejorar diseño de código, aplicar SOLID, refactorizar Clean Code, reducir complejidad, eliminar code smells, hacer código mantenible, refactorizar código legacy, responsabilidad única, inversión de dependencias, sprint de remediación, instalar herramientas de calidad, línea base de calidad, informe de olores, hoja de ruta de refactorización, qué deberíamos arreglar primero. NO PARA el ciclo de issues, ramas, PRs o merges (usa IssueFlow; su flujo de Remediation invoca esta skill para seleccionar y definir el alcance del trabajo).

¿Qué es CodeQuality?

CodeQuality es una habilidad experta para agentes de IA (como Claude Code, Cursor o Codex) que proporciona un bucle completo de mejora de calidad de código para cualquier repositorio. Funciona con dos lentes complementarias: la lente de herramientas, que escanea y corrige problemas detectados por linters, verificadores de tipos, escáneres de seguridad, código muerto y duplicación en orden de prioridad (P0 seguridad, P1 corrección, P2 mantenibilidad); y la lente de principios, que aplica principios SOLID y Clean Code para eliminar code smells estructurales (como clases dios, duplicación y núcleos no testeables) de forma segura, siempre proponiendo cambios antes de aplicarlos. El skill instala y ejecuta herramientas gratuitas locales desde un único manifiesto, genera informes de línea base, y produce un Informe de Mejora de Calidad obligatorio al final de cada sesión. Está diseñado para usarse de forma independiente o en conjunto con el flujo de Remediation de la skill IssueFlow para ciclos de remediación completos con ramas y PRs.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Personalización

Preferencias personales opcionales: ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/CodeQuality/PREFERENCES.md.

Si ese archivo existe, léelo y aplícalo; de lo contrario, continúa con los valores predeterminados de la skill. Solo preferencias personales: cualquier cosa que sea un hecho sobre un repositorio o producto pertenece a ese repositorio (su .claude/workflow-profile.sh o configuraciones de herramientas), nunca aquí.

¿Qué hace CodeQuality?

Un bucle, dos lentes. El bucle siempre es detectar → elegir un elemento → corregir detrás de pruebas → verificar → repetir. La lente de herramientas corrige lo que los escáneres señalan, en orden de prioridad, con las pruebas existentes como salvaguarda. La lente de principios corrige lo que hace que el código sea difícil de cambiar (clases dios, duplicación, núcleos no testeables), un principio SOLID / Clean Code a la vez, y nunca aplica un movimiento de diseño sin mostrarlo primero. Ambas lentes leen el mismo manifiesto de herramientas, escriben en el mismo directorio de informes y terminan con el mismo Informe de Mejora de Calidad.

Dos lentes

Lente de herramientasLente de principios
Controladorsalida del escáner (summary.md)olores de diseño mapeados a Principles.md (smell-inventory.md, roadmap.md)
Unidad de trabajoun hallazgo: una regla en un archivo:líneaun principio en un punto crítico acotado: una Extracción, una división de clase, una inversión de dependencia
OrdenP0 seguridad → P1 corrección → P2 mantenibilidadescalera de apalancamiento (abajo), ajustada por repositorio
Autonomíacorregir, luego mostrar el diffproponer → confirmar → aplicar; nada se edita antes de la aprobación
Red de seguridadlas pruebas existentes siguen en verdelas pruebas de caracterización se escriben primero cuando el objetivo no está probado
Métricamenos hallazgos, herramienta reejecutada limpia% de duplicación, complejidad ciclomática, longitud de funciones, fan-in/out, "ahora testeable unitariamente"
Cuándo elegirladeuda de lint/tipos/seguridad, CI en rojo, "haz felices a los escáneres"código que resiste el cambio; nivel estructural de un sprint de remediación

El bucle

ANALIZAR → SELECCIONAR → RED DE SEGURIDAD → [PROPONER → CONFIRMAR] → CORREGIR → VERIFICAR → INFORMAR → REPETIR
                                             └─ obligatorio en modo principio, se omite en modo herramienta ─┘

Enrutamiento de flujos de trabajo

DisparadorFlujo de trabajoProduce
"instalar herramientas de calidad", "configurar calidad de código"Workflows/Install.mdherramientas del manifiesto instaladas y verificadas
"analizar", "línea base", "analizar calidad de código", "informe de olores", "qué deberíamos arreglar primero", "hoja de ruta de refactorización"Workflows/Scan.mdsummary.md (A), smell-inventory.md (B), roadmap.md (C)
"mejorar calidad de código", "corregir lint", "bucle de calidad", "corregir [hallazgo]"Workflows/Loop.md en modo herramientacorrecciones, session-log.md, informe
"refactorizar", "aplicar SOLID", "limpiar esto", "iniciar el bucle"Workflows/Loop.md en modo principiocorrecciones, session-log.md, informe
"limpiar este repositorio" sin calificadorAnalizar A + B + C, luego Bucle en modo principiotodo lo anterior
"sprint de remediación", "ciclo de remediación"IssueFlow Remediation posee la rama, PR y merge; Analizar define el alcance del ciclo, Bucle lo ejecutaun PR por ciclo

El Bucle elige su modo por sí mismo cuando no se da ninguno: herramienta cuando no existe roadmap.md para el repositorio, principio cuando existe. El usuario puede forzar cualquiera de los dos.

El manifiesto

Tools/tools.tsv es la única lista de herramientas en esta skill. Separado por tabulaciones, una fila por herramienta y lenguaje: lenguaje categoría prioridad herramienta instalar ejecutar notas, con lenguaje en js | python | yaml, categoría en lint | format | types | security | deadcode | duplication | complexity | deps | coverage, prioridad en P0 | P1 | P2. Ambos scripts lo leen; los flujos de trabajo nunca enumeran herramientas en línea. Para añadir o eliminar una herramienta, edita una fila.

ScriptLee del manifiestoHace
Tools/install-quality-tools.sh [--dry-run] [lang ...]celdas instalar de los lenguajes elegidosdetecta lenguajes (package.json → js; pyproject.toml, requirements.txt o *.py → python; *.yaml/*.yml → yaml); instala herramientas js como devDependencies con el gestor de paquetes del repositorio (lockfile → npm/pnpm/bun), herramientas python y yaml con uv pip install o pip; los prefijos npm:/pip: anulan el canal, - no instala nada
Tools/run-quality-baseline.sh [--dry-run] [lang ...]celdas ejecutarejecuta cada herramienta en reports/codequality/<YYYY-MM-DD>-<HHMMSS>/, sustituyendo $OUT (directorio de informes), $SRC (QUALITY_SRC_DIRS, por defecto src si existe, si no .), $PM y $NPX; una herramienta que no está instalada es MISSING, una que falla es FAILED, ninguna detiene la ejecución; escribe summary.md con el estado por herramienta, recuentos de incidencias analizadas y totales P0/P1/P2; imprime la ruta del informe

Las filas cuyo ejecutar es - (herramientas de cobertura) se instalan pero no se ejecutan en la línea base: la cobertura se mide en el Bucle, limitada al objetivo. Cada herramienta es gratuita y se ejecuta localmente; npm audit, pip-audit y checkov acceden a la red solo para sus bases de datos de vulnerabilidades.

Escalera de apalancamiento (orden por defecto de la lente de principios)

  1. Nombres — código que no puedes leer, no puedes cambiar de forma segura. Barato, desbloquea todo.
  2. DRY / duplicación — elimina la mayor cantidad de código con el menor riesgo; expone abstracciones ocultas.
  3. Funciones pequeñas — Método Largo → Extraer; un nivel de abstracción por función.
  4. SRP — dividir clases y módulos que cambian por más de una razón.
  5. OCP / DIP — invertir dependencias, añadir puntos de inflexión; alto impacto, mayor riesgo, red de seguridad primero.
  6. ISP / LSP — interfaces grasas y sustituibilidad rota; necesitan los puntos de inflexión del paso 5.

El análisis parte C ajusta este orden al inventario real (apalancamiento = impacto ÷ riesgo; ver Principles.md Parte 3).

No negociables

  • Un elemento por iteración. Un hallazgo, o un principio en un objetivo acotado. Diffs pequeños y revisables.
  • Preservación del comportamiento. La estructura cambia, el comportamiento no. Si el comportamiento debe cambiar, detente y márcalo: eso es una característica, no una corrección.
  • De verde a verde. Las pruebas pasan antes y después. Rojo después de un cambio significa revertir, nunca corregir hacia adelante.
  • Pruebas de caracterización primero cuando las líneas a tocar no están probadas. Sin red, no refactorices.
  • Proponer antes de aplicar cualquier movimiento de diseño (modo principio). El modo herramienta puede corregir directamente, luego muestra el diff.
  • P0 → P1 → P2 para hallazgos de herramientas, entre lenguajes, nunca por lenguaje.
  • Nunca debilitar una prueba o una regla de lint para obtener verde. Las pruebas obsoletas se mueven al nuevo comportamiento correcto; las reglas se satisfacen en el código.
  • Boy Scout, acotado. Deja los archivos tocados más limpios, pero no amplíes el alcance más allá del elemento actual.
  • Evidencia, no opinión. Nombra la regla o el principio, y una métrica si existe.

Artefactos de salida

Todos bajo reports/codequality/ (ignorado por git):

ArchivoEscrito por
<YYYY-MM-DD>-<HHMMSS>/summary.md + salida bruta de herramientasrun-quality-baseline.sh (Análisis A)
<YYYY-MM-DD>/smell-inventory.mdAnálisis B
<YYYY-MM-DD>/roadmap.mdAnálisis C
<YYYY-MM-DD>/session-log.mdBucle, una entrada por iteración
<YYYY-MM-DD>/quality-report.mdBucle, al final de la sesión (abajo)

Informe de Mejora de Calidad (obligatorio)

Toda sesión del Bucle termina con este informe, en cualquier modo. Es el entregable junto con el cambio de código, y el cuerpo del PR o comentario del rastreador cuando el trabajo se envía a través de IssueFlow.

SecciónContenido
Tabla resumenlíneas añadidas / eliminadas / netas; incidencias antes → después por prioridad; puntos críticos de código muerto eliminados; pruebas antes → después (recuento, todas en verde)
Código eliminadoarchivo, qué, líneas, riesgo
Código añadido o modificadoarchivo, qué, líneas, propósito
Errores corregidosgravedad, descripción, causa raíz (solo si alguno surgió)
Delta de complejidadcomplejidad ciclomática máxima y media antes → después, con una barra ASCII por punto crítico
Diferidoelementos vistos pero fuera de alcance, y 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.

Skills relacionados