chen-985211/circular-dependency-skill

O que circular-dependency-skill faz?

Encontre dependências circulares com evidências, não com grep. Uma skill para Codex e analisador sem dependências para Python e JS/TS.

Como usar

1. Execute o comando codex circular-dependency no diretório raiz do seu projeto.
2. A skill analisará automaticamente os arquivos Python (.py) e JavaScript/TypeScript (.js, .ts, .jsx, .tsx).
3. Ela exibirá uma lista de dependências circulares encontradas, com o caminho completo do ciclo.

Funcionalidades

• Sem dependências externas: Funciona apenas com a análise estática do código fonte.
• Suporte a Python e JS/TS: Detecta ciclos em import, from ... import ..., require() e import ... from ....
• Evidências detalhadas: Para cada ciclo, a skill mostra a sequência de módulos envolvidos.
• Integração com Codex: Pode ser usada diretamente no terminal com o comando codex.

Exemplo de saída

Dependência circular encontrada:
  src/utils/helpers.ts -> src/core/parser.ts -> src/utils/helpers.ts

Módulos envolvidos:
1. src/utils/helpers.ts
   - Importa: src/core/parser.ts
2. src/core/parser.ts
   - Importa: src/utils/helpers.ts

Limitações

• A análise é baseada em padrões de importação estáticos; imports dinâmicos ou indiretos podem não ser detectados.
• Projetos muito grandes podem ter desempenho reduzido.

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests no repositório original.