Skip to content
Back to skills

Refactor Hotspots

ASecurity

Ordena los ficheros por churn de git log desde una fecha obligatoria multiplicado por su complejidad, y declara «no medido» sin fecha, sin repositorio o en un clon shallow.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentspythongobashvuegit

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add alberto2005-coder/skills-ia --skill refactor-hotspots --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Refactor Hotspots?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Refactor Hotspots
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/alberto2005-coder-refactor-hotspots/badge)](https://www.skillsdirectory.com/skills/alberto2005-coder-refactor-hotspots)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: refactor-hotspots
description: Ordena los ficheros por churn de git log desde una fecha obligatoria multiplicado por su complejidad, y declara «no medido» sin fecha, sin repositorio o en un clon shallow.
license: MIT
metadata:
  package: refactor-surgeon
  version: "1.4.0"
---

# Refactor Hotspots

## Objetivo

Decidir por dónde empezar con evidencia, no con la impresión de que un módulo «está fatal»: el fichero que más cambia y más complejo es el que más devuelve por hora de refactor.

## Instrucciones de ejecución

1. Mide con una fecha explícita y completa:

```bash
py refactor-surgeon/scripts/hotspots.py --path . --since 2026-01-01T00:00:00 --top 10 --json
```

2. Empieza por el primero que además tenga casos dorados posibles (`refactor-harness`).
3. Repite la medición después del corte con el mismo `--since`: el churn ya no es comparable si cambia la ventana.

## Cómo se calcula

| Pieza | Fuente |
|---|---|
| Churn | Líneas añadidas + borradas por fichero en `git log --numstat` desde `--since` |
| Complejidad | Suma de `V(G)` de las funciones del fichero; los que no son Python cuentan 1 |
| Score | Churn × complejidad, ordenado de mayor a menor |

Cada fila del informe lleva ruta, churn, complejidad y score, para poder discutir el número y no la intuición. Los ficheros que ya no existen se cuentan aparte (`skipped`) y no entran en el ranking: recomendar refactorizar un fichero borrado no sirve de nada.

## No medido

| Situación | Resultado |
|---|---|
| Falta `--since` | `measured: false`, salida 2 |
| La ruta no es un repositorio git | `measured: false`, salida 2 |
| Clon shallow (historia truncada) | `measured: false`, salida 2 |
| `--since` con solo fecha | Se normaliza a `AAAA-MM-DDT00:00:00` antes de llamar a git |

La degradación es explícita a propósito: un churn calculado sobre historia truncada parece un dato y no lo es.

## Límites

- Es el único script del paquete que lee historia: el resultado depende del repositorio y de la ventana elegida, no solo del código.
- Solo ve ficheros rastreados por git; el código generado o ignorado por `.gitignore` queda fuera.
- El score pondera igual una línea añadida que una borrada y no mide riesgo de cambio: ordena, no decide.

## Gate de salida

- Ventana (`--since`), commits leídos y ficheros ordenados por escrito.
- Si no se pudo medir, el motivo escrito y el análisis continúa con `refactor-metrics`.
- El fichero elegido tiene su grupo de casos dorados antes de tocarlo.

## Handoff

Entrega a `refactor-harness` el fichero prioritario para congelar su conducta y a `refactor-slice` su grafo de llamadas, ya con el orden de ataque decidido.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.