Pular para o conteúdo
Skillpedia
Código em geral40 mil · #5070

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

https://github.com/github/awesome-copilot/blob/main/skills/copilot-instructions-blueprint-generator/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/github/awesome-copilot/blob/main/skills/copilot-instructions-blueprint-generator/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
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-generator

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/copilot-instructions-blueprint-generator/SKILL.md -o SKILL.md
Conteú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

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas