Especialista em Descoberta de Padrões de Código e Geração de Arquivos SKILL

--- name: skill-master description: Descubra padrões de código e gere automaticamente arquivos SKILL para .claude/skills/. Use ao analisar um projeto em busca de skills ausentes, criar novas skills a partir de padrões do código ou sincronizar skills com a estrutura do projeto. version: 1.0.0 --- # Skill Master ## Visão Geral Analise o código para descobrir padrões e gerar/atualizar arquivos SKILL em `.claude/skills/`. Suporta projetos multiplataforma com detecção de padrões específicos de stack. **Capacidades:** - Escaneie o código em busca de padrões arquiteturais (ViewModel, Repository, Room, etc.) - Compare padrões detectados com skills existentes - Gere automaticamente arquivos SKILL com exemplos de código reais - Controle de versão e atualizações inteligentes ## Como a IA descobre e usa esta skill Esta skill é acionada quando o usuário: - Pede para analisar o projeto em busca de skills ausentes - Solicita geração de skills a partir de padrões do código - Deseja sincronizar ou atualizar skills existentes - Menciona "skill discovery", "generate skills" ou "skill-sync" **Sinais de detecção:** - Presença do diretório `.claude/skills/` - Estrutura do projeto correspondendo a padrões conhecidos - Arquivos de build/config indicando plataforma (veja referências) ## Modos ### Modo Discover Analise o código e relate skills ausentes. **Passos:** 1. Detecte a plataforma via arquivos de build/config (veja referências) 2. Escaneie raízes de código fonte em busca de indicadores de padrão 3. Compare padrões detectados com `.claude/skills/` existente 4. Gere relatório de análise de lacunas **Formato de saída:** ``` Padrões Detectados: {contagem} | Padrão | Arquivos Encontrados | Localização do Exemplo | |---------|----------------------|------------------------| | {nome} | {contagem} | {caminho} | Skills Existentes: {contagem} Skills Ausentes: {contagem} - {nome-da-skill}: {padrão}, {contagem-de-arquivos} arquivos encontrados ``` ### Modo Generate Crie arquivos SKILL a partir de padrões detectados. **Passos:** 1. Execute a descoberta para identificar skills ausentes 2. Para cada skill ausente: - Encontre 2-3 arquivos fonte representativos - Extraia: imports, anotações, estrutura de classe, convenções - Extraia regras de `.ruler/*.md` se presente 3. Gere SKILL.md usando a estrutura do template 4. Adicione versão e marcador de fonte **Estrutura SKILL gerada:** ```yaml --- name: {nome-do-padrão} description: {Descrição gerada com palavras-chave de gatilho} version: 1.0.0 --- # {Título} ## Visão Geral {Breve descrição da análise do padrão} ## Estrutura de Arquivos {Extraída do código} ## Padrão de Implementação {Exemplos de código reais - anonimizados} ## Regras ### Faça {De .ruler/*.md + convenções do código} ### Não Faça {Anti-padrões encontrados} ## Localização dos Arquivos {Caminhos reais do código} ``` ## Estratégia de Criação Quando o arquivo SKILL de destino não existe: 1. Gere novo arquivo usando o template 2. Defina `version: 1.0.0` no frontmatter 3. Inclua todas as seções obrigatórias 4. Adicione marcador de fonte no final (veja Formato do Marcador) ## Estratégia de Atualização **Verificação de marcador:** Procure por `<!-- Generated by skill-master command` no final do arquivo. **Se marcador presente (execução subsequente):** - Mesclagem inteligente: preserve conteúdo personalizado, adicione seções ausentes - Incremente a versão: major (quebra) / minor (funcionalidade) / patch (correção) - Atualize a lista de fontes no marcador **Se marcador ausente (primeira execução em arquivo existente):** - Backup: `SKILL.md` → `SKILL.md.bak` - Use o backup como fonte, extraia conteúdo relevante - Gere novo arquivo com marcador - Defina `version: 1.0.0` ## Formato do Marcador Coloque no FINAL do SKILL.md gerado: ```html <!-- Generated by skill-master command Version: {versão} Sources: - caminho/para/fonte1.kt - caminho/para/fonte2.md - .ruler/arquivo-de-regra.md Last updated: {AAAA-MM-DD} --> ``` ## Referências de Plataforma Leia a referência relevante quando a plataforma for detectada: | Plataforma | Arquivos de Detecção | Referência | |------------|----------------------|------------| | Android/Gradle | `build.gradle`, `settings.gradle` | `references/android.md` | | iOS/Xcode | `*.xcodeproj`, `Package.swift` | `references/ios.md` | | React (web) | `package.json` + react | `references/react-web.md` | | React Native | `package.json` + react-native | `references/react-native.md` | | Flutter/Dart | `pubspec.yaml` | `references/flutter.md` | | Node.js | `package.json` | `references/node.md` | | Python | `pyproject.toml`, `requirements.txt` | `references/python.md` | | Java/JVM | `pom.xml`, `build.gradle` | `references/java.md` | | .NET/C# | `*.csproj`, `*.sln` | `references/dotnet.md` | | Go | `go.mod` | `references/go.md` | | Rust | `Cargo.toml` | `references/rust.md` | | PHP | `composer.json` | `references/php.md` | | Ruby | `Gemfile` | `references/ruby.md` | | Elixir | `mix.exs` | `references/elixir.md` | | C/C++ | `CMakeLists.txt`, `Makefile` | `references/cpp.md` | | Desconhecida | - | `references/generic.md` | Se múltiplas plataformas forem detectadas, leia múltiplas referências. ## Regras ### Faça - Extraia apenas padrões verificados no código - Use exemplos de código reais (anonimize a lógica de negócio) - Inclua palavras-chave de gatilho na descrição - Mantenha SKILL.md abaixo de 500 linhas - Referencie arquivos externos para conteúdo detalhado - Preserve seções personalizadas durante atualizações - Sempre faça backup antes da primeira modificação ### Não Faça - Inclua segredos, tokens ou credenciais - Inclua detalhes de lógica específica de negócio - Gere placeholders sem conteúdo real - Sobrescreva personalizações do usuário sem backup - Crie cadeias de referência profundas (máximo 1 nível) - Escreva fora de `.claude/skills/` ## Regras de Extração de Conteúdo **Do código:** - Extraia: estruturas de classe, anotações, padrões de import, localizações de arquivos, convenções de nomenclatura - Nunca: valores codificados, segredos, chaves de API, PII **De .ruler/*.md (se presente):** - Extraia: regras de Faça/Não Faça, restrições arquiteturais, regras de dependência ## Relatório de Saída Após a geração, imprima: ``` RELATÓRIO DE GERAÇÃO SKILL Skills Geradas: {contagem} {nome-da-skill} [CRIADA | ATUALIZADA | BACKUP+CRIADA] ├── Analisados: {contagem-de-arquivos} arquivos fonte ├── Fontes: {lista de arquivos fonte} ├── Regras de: {arquivos .ruler se houver} └── Saída: .claude/skills/{nome-da-skill}/SKILL.md ({contagem-de-linhas} linhas) Validação: ✓ Frontmatter YAML válido ✓ Descrição inclui palavras-chave de gatilho ✓ Conteúdo abaixo de 500 linhas ✓ Possui seções obrigatórias ``` ## Restrições de Segurança - Nunca escreva fora de `.claude/skills/` - Nunca exclua conteúdo sem backup - Sempre faça backup antes da primeira modificação - Preserve personalizações do usuário - Determinístico: mesma entrada → mesma saída