cygnusfear/file-name-wizard

O que file-name-wizard faz?

Audita todas as convenções de nomenclatura de arquivos no código-fonte de acordo com os padrões do AGENTS.md e padrões comuns. Use quando o usuário pedir para verificar convenções de nomenclatura, auditar nomes de arquivos, encontrar inconsistências de nomenclatura ou validar padrões de nomes de arquivos.

Visão Geral

Esta skill fornece uma auditoria completa das convenções de nomenclatura de arquivos em seu projeto. Ela verifica se todos os nomes de arquivos seguem os padrões definidos no arquivo AGENTS.md e também aplica padrões comuns amplamente reconhecidos.

Como Usar

1. Certifique-se de que o arquivo AGENTS.md existe no diretório raiz do seu projeto com as regras de nomenclatura desejadas.
2. Execute o comando de auditoria.
3. Revise o relatório gerado para identificar inconsistências.

Exemplo de Uso

# Comando para executar a auditoria de nomes de arquivos
npx file-name-wizard audit

Regras Suportadas

• kebab-case: Nomes de arquivos com hífens (ex: meu-arquivo.js).
• snake_case: Nomes de arquivos com underscores (ex: meu_arquivo.js).
• camelCase: Nomes de arquivos em camelCase (ex: meuArquivo.js).
• PascalCase: Nomes de arquivos em PascalCase (ex: MeuArquivo.js).
• Ponto separado: Nomes de arquivos com pontos (ex: meu.arquivo.js).

Personalização

Você pode definir regras personalizadas no AGENTS.md. Por exemplo:

---
file-naming-conventions:
  - pattern: "^[a-z]+(-[a-z]+)*\\.(ts|js|tsx)$"
    description: "Componentes React em kebab-case"
  - pattern: "^[A-Z][a-zA-Z]*\\.tsx$"
    description: "Componentes de página em PascalCase"

Saída

A auditoria gera um relatório no seguinte formato:

Resumo da Auditoria de Nomes de Arquivos
=========================================
Total de arquivos verificados: 150
Arquivos em conformidade: 145
Arquivos com inconsistências: 5

Inconsistências:
- src/components/meuComponente.tsx (esperado: kebab-case, encontrado: camelCase)
- src/pages/HomePage/page.tsx (esperado: PascalCase, encontrado: camelCase)
...

Integração

Esta skill funciona com:

• Claude Code
• Cursor
• Codex
• Outros agentes de IA compatíveis com a estrutura de skills

Licença

MIT