copilot-instructions-blueprint-generator
Cria um guia para o GitHub Copilot entender as regras do seu projeto. Garante que o código gerado siga o padrão e as tecnologias certas.
O que ela faz
Este gerador cria um arquivo de instruções para o GitHub Copilot. Ele ajuda o Copilot a escrever código que segue as regras, o estilo e as versões de tecnologia do seu projeto.
Quando usar
- ✓Ao iniciar um novo projeto para definir as regras do Copilot.
- ✓Ao adicionar novas funcionalidades para garantir a consistência.
- ✓Ao revisar código para verificar se o Copilot seguiu as diretrizes.
Exemplo do que pedir para a IA
“Crie um arquivo de instruções para o Copilot para um projeto .NET com arquitetura em camadas, focando em manutenibilidade e com documentação padrão.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Você informa o tipo de projeto, o estilo de arquitetura e suas prioridades (qualidade, documentação, testes). A ferramenta então monta um guia detalhado para o Copilot.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add github/awesome-copilot --skill copilot-instructions-blueprint-generatorOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/copilot-instructions-blueprint-generator/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Gerador de Blueprint de Instruções do Copilot
Variáveis de Configuração
${PROJECT_TYPE="Auto-detect|.NET|Java|JavaScript|TypeScript|React|Angular|Python|Multiple|Other"} <!-- Tecnologia principal --> ${ARCHITECTURE_STYLE="Layered|Microservices|Monolithic|Domain-Driven|Event-Driven|Serverless|Mixed"} <!-- Abordagem arquitetural --> ${CODE_QUALITY_FOCUS="Maintainability|Performance|Security|Accessibility|Testability|All"} <!-- Prioridades de qualidade --> ${DOCUMENTATION_LEVEL="Minimal|Standard|Comprehensive"} <!-- Requisitos de documentação --> ${TESTING_REQUIREMENTS="Unit|Integration|E2E|TDD|BDD|All"} <!-- Abordagem de testes --> ${VERSIONING="Semantic|CalVer|Custom"} <!-- Abordagem de versionamento -->
Prompt Gerado
"Gere um arquivo copilot-instructions.md abrangente que guiará o GitHub Copilot a produzir código consistente com os padrões, arquitetura e versões de tecnologia do nosso projeto. As instruções devem ser estritamente baseadas em padrões de código reais em nossa base de código e evitar fazer quaisquer suposições. Siga esta abordagem:
1. Estrutura Principal da Instrução
# Instruções do GitHub Copilot
## Diretrizes de Prioridade
Ao gerar código para este repositório:
1. **Compatibilidade de Versão**: Sempre detecte e respeite as versões exatas de linguagens, frameworks e bibliotecas usadas neste projeto
2. **Arquivos de Contexto**: Priorize padrões e diretrizes definidos no diretório .github/copilot
3. **Padrões da Base de Código**: Quando os arquivos de contexto não fornecerem orientação específica, escaneie a base de código em busca de padrões estabelecidos
4. **Consistência Arquitetural**: Mantenha nosso estilo arquitetural ${ARCHITECTURE_STYLE} e os limites estabelecidos
5. **Qualidade do Código**: Priorize ${CODE_QUALITY_FOCUS == "All" ? "manutenibilidade, desempenho, segurança, acessibilidade e testabilidade" : CODE_QUALITY_FOCUS} em todo o código gerado
## Detecção de Versão de Tecnologia
Antes de gerar código, escaneie a base de código para identificar:
1. **Versões de Linguagem**: Detecte as versões exatas das linguagens de programação em uso
- Examine arquivos de projeto, arquivos de configuração e gerenciadores de pacotes
- Procure por indicadores de versão específicos da linguagem (por exemplo, <LangVersion> em projetos .NET)
- Nunca use recursos de linguagem além da versão detectada
2. **Versões de Framework**: Identifique as versões exatas de todos os frameworks
- Verifique package.json, .csproj, pom.xml, requirements.txt, etc.
- Respeite as restrições de versão ao gerar código
- Nunca sugira recursos que não estejam disponíveis nas versões de framework detectadas
3. **Versões de Biblioteca**: Anote as versões exatas das bibliotecas e dependências principais
- Gere código compatível com essas versões específicas
- Nunca use APIs ou recursos que não estejam disponíveis nas versões detectadas
## Arquivos de Contexto
Priorize os seguintes arquivos no diretório .github/copilot (se existirem):
- **architecture.md**: Diretrizes de arquitetura do sistema
- **tech-stack.md**: Versões de tecnologia e detalhes de framework
- **coding-standards.md**: Padrões de estilo e formatação de código
- **folder-structure.md**: Diretrizes de organização do projeto
- **exemplars.md**: Padrões de código exemplares a serem seguidos
## Instruções de Escaneamento da Base de Código
Quando os arquivos de contexto não fornecerem orientação específica:
1. Identifique arquivos semelhantes ao que está sendo modificado ou criado
2. Analise os padrões para:
- Convenções de nomenclatura
- Organização do código
- Tratamento de erros
- Abordagens de logging
- Estilo de documentação
- Padrões de teste
3. Siga os padrões mais consistentes encontrados na base de código
4. Quando existirem padrões conflitantes, priorize os padrões em arquivos mais recentes ou arquivos com maior cobertura de testes
5. Nunca introduza padrões não encontrados na base de código existente
## Padrões de Qualidade de Código
${CODE_QUALITY_FOCUS.includes("Maintainability") || CODE_QUALITY_FOCUS == "All" ? `### Manutenibilidade
- Escreva código autoexplicativo com nomenclatura clara
- Siga as convenções de nomenclatura e organização evidentes na base de código
- Siga os padrões estabelecidos para consistência
- Mantenha funções focadas em responsabilidades únicas
- Limite a complexidade e o comprimento das funções para corresponder aos padrões existentes` : ""}
${CODE_QUALITY_FOCUS.includes("Performance") || CODE_QUALITY_FOCUS == "All" ? `### Desempenho
- Siga os padrões existentes para gerenciamento de memória e recursos
- Corresponda aos padrões existentes para lidar com operações computacionalmente intensivas
- Siga os padrões estabelecidos para operações assíncronas
- Aplique caching de forma consistente com os padrões existentes
- Otimize de acordo com os padrões evidentes na base de código` : ""}
…
Perguntas frequentes
O que é um arquivo 'copilot-instructions.md'?
É um arquivo que contém instruções específicas para o GitHub Copilot, dizendo como ele deve escrever o código para o seu projeto.
Por que usar este gerador?
Para garantir que o código escrito pelo Copilot seja consistente com o restante do seu projeto, economizando tempo e evitando erros.
Preciso saber programar para usar isso?
Não, o gerador é feito para ser simples. Você só precisa escolher as opções que descrevem seu projeto.
Detalhes
Descrição original do autor
Technology-agnostic blueprint generator for creating comprehensive copilot-instructions.md files that guide GitHub Copilot to produce code consistent with project standards, architecture patterns, and exact technology versions by analyzing existing codebase patterns and avoiding assumptions.
repo: github/awesome-copilot
Popularidade
- Estrelas no GitHub
- 40 mil
- Posição no ranking
- #5070
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
acquire-codebase-knowledge
Ajuda seu agente a entender e documentar um projeto de código existente. É útil para novas pessoas entrarem no projeto ou para ter uma visão geral da arquitetura.
github/awesome-copilot
acreadiness-assess
Faz seu agente avaliar a prontidão de um projeto para IA e gerar um relatório. É útil para entender o quão bem um projeto está preparado para usar ferramentas de IA.
github/awesome-copilot
acreadiness-generate-instructions
Ajuda seu agente a criar instruções para ferramentas de IA baseadas em uma avaliação. É útil para melhorar a forma como a IA interage com o código e fecha lacunas identificadas.
github/awesome-copilot
acreadiness-policy
Faz seu agente ajudar a definir ou aplicar políticas para avaliação de projetos de IA. É útil para padronizar a forma como os projetos são avaliados e garantir conformidade.
github/awesome-copilot
Skills parecidas
benchmark-optimization-loop
Faz seu agente melhorar a velocidade de algo de forma medida. Ele testa várias versões e escolhe a mais rápida que ainda funciona corretamente.
affaan-m/ECC
change-impact
Ajuda seu agente a analisar o impacto de mudanças no código antes de fazê-las. Ele compara o planejado com o real depois, cobrindo caminhos, dados, testes e documentação. É útil para mudanças arriscadas ou que afetam várias partes do sistema.
affaan-m/ECC
click-path-audit
Faz seu agente rastrear todos os botões e interações do usuário para achar bugs. Ele encontra problemas onde funções parecem funcionar sozinhas, mas falham juntas. Útil quando bugs persistem mesmo após depuração.
affaan-m/ECC