Skip to content
Back to skills

Refactor Cycles

ASecurity

Encuentra los ciclos de imports entre los módulos de un árbol Python resolviendo imports absolutos y relativos, y devuelve cada componente fuertemente conexa con sus ficheros.

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

Security analysis

A100/100

Scanned November 18, 2026

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

Installs into .claude/skills of the current project.

Are you the author of Refactor Cycles?

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

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

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-cycles
description: Encuentra los ciclos de imports entre los módulos de un árbol Python resolviendo imports absolutos y relativos, y devuelve cada componente fuertemente conexa con sus ficheros.
license: MIT
metadata:
  package: refactor-surgeon
  version: "1.4.0"
---

# Refactor Cycles

## Objetivo

Saber qué módulos no se pueden separar todavía: mientras dos ficheros se importen en círculo, mover uno rompe el otro, y el corte que propone `refactor-slice` no se puede aplicar de golpe.

## Instrucciones de ejecución

1. Detecta los ciclos del paquete completo, no del fichero que se va a cortar:

```bash
py refactor-surgeon/scripts/import_cycles.py --path src/ --json
```

2. Rompe primero el ciclo más pequeño: extraer el tipo o la constante compartida a un tercer módulo suele bastar.
3. Vuelve a medir después de cada corte; un ciclo puede esconder dos.

## Cómo resuelve los imports

| Forma | Se resuelve contra |
|---|---|
| `import paquete.modulo` | El prefijo más largo que exista como módulo del árbol |
| `from paquete import submodulo` | El submódulo si existe; si no, el módulo base |
| `from . import hermano` | La carpeta del fichero, subiendo `level - 1` niveles |
| `from ..padre import x` | La carpeta del padre, con la misma subida |

Solo cuentan los imports internos al árbol; lo que apunta a la biblioteca estándar o a terceros se ignora. Un módulo que se importa a sí mismo no es un ciclo.

## Límites

- Grafo estático: no ve imports dentro de funciones con `importlib`, ni dependencias que solo existen en tiempo de ejecución.
- Compara nombres de módulo: un paquete instalado con el mismo nombre que una carpeta local puede dar una arista falsa.
- Un ciclo no es un error de comportamiento: es un corte pendiente; el veredicto lo da `refactor-verify` después del cambio.

## Gate de salida

- Cada ciclo listado con sus módulos y sus ficheros, y el árbol analizado declarado.
- Los ciclos se rompen con un corte por vez, con métricas de antes y después.
- Lo que queda en ciclo a propósito se justifica por escrito.

## Handoff

Entrega a `refactor-slice` el orden de corte (primero los grupos fuera de ciclo) y a `refactor-verify` cada ciclo roto, para comprobar que los casos dorados siguen igual.

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.