Pular para o conteúdo principal

Persona de Usuário: O Desenvolvedor

Perfil: Programação, depuração, leitura de documentação, refatoração e revisão de código. Objetivo Principal: Reduzir a troca de contexto, eliminar código repetitivo (boilerplate) e acelerar a depuração.

Configuração Recomendada​

Provedores​

  • Principal: Claude Sonnet 4.6 é atualmente o topo de linha para tarefas de programação e raciocínio complexo, ou GPT-5.5 (requer Pro Plus ou superior) para o raciocínio mais pesado.
  • Local: Ollama (DeepSeek Coder / Qwen 3) para programação privada, offline ou para propriedade intelectual sensível.
  • Velocidade: GPT-5.4 Mini ou Gemini 3.5 Flash para verificações rápidas de sintaxe e transformações simples.

Esses são os modelos de ponta que o Rephlo oferece através da Dedicated API gerenciada; GPT-5.5 e Claude Opus 4.8 exigem Pro Plus ou superior. Com sua própria chave (BYOK) você pode usar qualquer modelo que a conta do seu provedor suporte.

Knowledge Spaces​

  • Space: Current Project (Inclua especificações de arquitetura, documentação de API, classes auxiliares principais).
  • Space: Library Docs (Inclua a documentação daquela biblioteca pouco conhecida que você está usando).
  • Space: Coding Standards (O guia de estilo, convenções de nomenclatura e padrões da sua equipe).

Comandos Essenciais​

  1. "Gen Docstring"

    • Prompt: "Gere comentários de documentação XML para este método. Inclua tags de parâmetro e retorno com descrições claras."
    • Uso: Selecione a assinatura de uma função.

  2. "Find Bug"

    • Prompt: "Analise este código em busca de possíveis erros em tempo de execução, exceções de referência nula, condições de corrida ou falhas lógicas. Explique cada problema encontrado."
    • Uso: Selecione um bloco de código suspeito.

  3. "Convert Language"

    • Prompt: "Reescreva este código Python em C#. Mantenha a funcionalidade equivalente e use padrões idiomáticos de C#."
    • Uso: Selecione um código para traduzir entre linguagens.

  4. "Explain Regex"

    • Prompt: "Explique passo a passo o que esta Expressão Regular faz. Detalhe cada componente e forneça exemplos de correspondências."
    • Uso: Selecione um padrão de regex complexo.

  5. "Refactor Clean"

    • Prompt: "Refatore este código para melhorar a legibilidade e a manutenibilidade. Aplique os princípios SOLID, extraia métodos quando apropriado e adicione comentários inline."
    • Uso: Selecione código legado ou métodos complexos.

  6. "Write Unit Test"

    • Prompt: "Gere testes unitários para este método. Inclua casos extremos, entradas nulas e condições de contorno. Use sintaxe xUnit/NUnit."
    • Uso: Selecione um método para testar.

Exemplo de Fluxo de Trabalho: Depuração​

  1. Capturar: Você encontra uma exceção. Tire uma captura de tela do stack trace.
  2. Analisar: Execute "Explain Error" na captura de tela usando o Visual Intelligence (o recurso de captura de tela e compreensão de imagem do Rephlo).
  3. Contexto: O Rephlo sugere que pode ser um objeto nulo na linha 42.
  4. Verificar: Você seleciona o bloco de código relevante e executa "Check Null Safety".
  5. Corrigir: O Rephlo fornece o trecho de código corrigido com verificações de nulo.

Exemplo de Fluxo de Trabalho: Preparação para Revisão de Código​

  1. Selecionar: Destaque as alterações de código que você está prestes a enviar.
  2. Revisar: Execute "Find Bug" para detectar problemas antes que seus colegas o façam.
  3. Documentar: Execute "Gen Docstring" em quaisquer métodos não documentados.
  4. Aprimorar: Execute "Refactor Clean" em seções complexas.
  5. Enviar: Crie seu PR com confiança.

Tipos de Arquivo de Código Suportados​

O Rephlo pode processar e entender os seguintes tipos de arquivo quando adicionados a Spaces:

CategoriaExtensões
C# / .NET.cs, .csproj, .sln, .xaml
JavaScript / TypeScript.js, .ts, .jsx, .tsx, .mjs
Python.py, .pyi, .pyw
Web.html, .css, .scss, .less
Dados / Configuração.json, .xml, .yaml, .yml, .toml
Documentação.md, .txt, .rst
Outras Linguagens.java, .go, .rs, .rb, .php, .swift

Observação: Arquivos binários, saídas compiladas e node_modules não são suportados. Mantenha o conteúdo do Space focado em arquivos-fonte.

Dicas para Desenvolvedores​

Mantenha o Conteúdo do Space Focado​

Resista à tentação de despejar todo o seu repositório em um Space. Em vez disso:

  • Inclua apenas registros de decisão de arquitetura (ADRs)
  • Adicione definições de interfaces principais e classes base
  • Envie a documentação de API das bibliotecas que você está integrando
  • Exclua dados de teste, artefatos de build e arquivos gerados

Um Space focado produz respostas mais relevantes e precisas.

Fique Atento aos Orçamentos de Tokens​

Bases de código grandes podem exceder os limites de tokens rapidamente. Estratégias:

  • Crie Spaces separados para diferentes módulos ou serviços
  • Use o Space mais relevante para cada tarefa, não um Space "pia de cozinha" (com tudo misturado)
  • Para arquivos muito grandes, selecione apenas as seções relevantes em vez do arquivo inteiro
  • Monitore o tamanho do Space no painel de gerenciamento de Spaces

Use Commands para Refatoração Repetitiva​

Se você se pega explicando a mesma transformação repetidamente:

  • Crie um Command dedicado com seus requisitos exatos
  • Inclua os padrões de codificação da sua equipe no prompt do Command
  • Economize tempo em tarefas repetitivas como docstrings, verificações de nulo, padrões de logging

Aproveite o Multi-Turn Chat para Depuração Iterativa​

Para sessões de depuração complexas em que você precisa explorar múltiplas hipóteses, use o Multi-Turn Chat em vez de Commands de execução única:

  • Compartilhe trechos de código e obtenha análises de acompanhamento
  • Faça perguntas de esclarecimento sobre as correções sugeridas
  • Itere sobre as soluções com o contexto preservado
  • Explore abordagens alternativas em um diálogo

Acesse o Chat pelo painel de navegação à esquerda.

Grupos de Comandos Sugeridos​

Organize seus Commands de desenvolvimento em grupos funcionais:

Nome do GrupoCommands
Code ReviewFind Bug, Check Null Safety, Security Audit
DocumentationGen Docstring, Explain Code, README Generator
RefactoringRefactor Clean, Extract Method, Rename Variables
TestingWrite Unit Test, Generate Mocks, Test Coverage
ConversionConvert Language, Modernize Syntax, Format Code

Crie Command Groups na seção Commands para manter seu conjunto de ferramentas organizado.

Padrões Comuns com os Quais o Rephlo Ajuda​

TarefaCommand a Usar
Compreensão de código legado"Explain Code" com o Space do projeto
Integração de API"Convert Language" + Space de Library Docs
Verificações pré-commit"Find Bug" nas alterações staged
Débito de documentação"Gen Docstring" em lote
Preparação para revisão de código"Refactor Clean" antes do PR

Próxima Persona: Para Criadores de Conteúdo ou volte para Para Estudantes.