Eficiência do GitHub Codespaces

Use esta habilidade como um ponto de entrada enxuto para o trabalho de eficiência do GitHub Codespaces. Inspecione o repositório, identifique desperdícios e carregue apenas as referências necessárias.

Se ainda não existir nenhum .devcontainer/, carregue references/codespaces.md e defina uma linha de base antes de prosseguir com as etapas abaixo.

Use Esta Habilidade Quando

• O usuário deseja inicialização mais rápida do Codespaces ou menor gasto com Codespaces.
• O repositório tem um .devcontainer/ ou perguntas explícitas de configuração do Codespaces.
• O usuário pergunta sobre otimização de devcontainer, dimensionamento de máquina, estratégia de pré-build ou orientação sobre tempo limite de inatividade.
• O usuário está configurando o Codespaces pela primeira vez ou precisa de ajuda para criar um novo .devcontainer/ do zero.

Carregue Apenas o Que Você Precisa

• references/codespaces.md — orientações sobre devcontainer, dimensionamento de máquina, pré-build, tempo limite de inatividade e relatórios.
• references/review-rubric.md — carregue apenas para revisões.

Fluxo de Trabalho Principal

1. Meça primeiro

find .devcontainer -maxdepth 2 -type f
gh codespace list
repo=$(gh repo view --json nameWithOwner --jq .nameWithOwner)
gh api "/repos/$repo/codespaces/machines"

Se a autenticação gh falhar ou o usuário não tiver escopo de administrador do repositório, prossiga com a análise estática dos arquivos .devcontainer/; marque as recomendações de tipo de máquina e pré-build como não verificadas.

Procure por: imagem do devcontainer > 2 GB ou mais de 10 recursos, tipo de máquina maior do que os dados de uso suportam, devcontainer-lock.json ausente (recomenda-se adicionar — muitos repositórios são anteriores ao suporte a arquivos de bloqueio), pré-builds com escopo muito amplo e tempo limite de inatividade incompatível com os padrões de uso.

2. Aplique barreiras de proteção

Verifique cada correção proposta contra estas regras antes de recomendá-la:

1. Não remove ferramentas que a equipe usa todos os dias — descarte qualquer correção que remova ferramentas de desenvolvimento ou extensões necessárias.
2. Não assume que menor é sempre melhor — equilibre o custo da máquina com a experiência do desenvolvedor e a produtividade.
3. Não transforma o devcontainer em uma imagem de produção — descarte qualquer correção que adicione dependências apenas de produção, a menos que a equipe a exija explicitamente.
4. Mudanças incrementais são preferíveis — uma linha de base do zero é apropriada apenas quando não existe nenhum .devcontainer/; sinalize (não descarte) mudanças que reestruturem uma configuração existente.
5. Mudanças no repositório permanecem separadas das configurações da organização — divida qualquer correção que misture arquivos editáveis no repositório com configurações de Codespaces em nível de organização ou de usuário em duas recomendações distintas.

3. Selecione as 3 principais correções

Das seis candidatas abaixo, mantenha apenas aquelas suportadas por evidências de auditoria da etapa 1 e que passem por todas as barreiras de proteção da etapa 2. Classifique as sobreviventes pela economia estimada de custo mensal (USD). Selecione todos os candidatos que atendam a ambos os critérios, até um máximo de 3.

1. Otimizar devcontainer — remova recursos, pacotes ou extensões não necessários para o trabalho de desenvolvimento diário; alvo de imagem < 2 GB e menos de 10 recursos.
2. Dimensionar corretamente o tipo de máquina — alinhe com os padrões de uso observados; se os dados não estiverem disponíveis, declare as suposições explicitamente.
3. Escopo de pré-builds — habilite para o branch padrão, branches release/* ativos nos últimos 14 dias e branches com mais de 5 Codespaces por semana; desabilite para todos os outros.
4. Ajustar tempo limite de inatividade — 30 min padrão; 15 min se a maioria das sessões terminar antes de 30 min; 60 min se a maioria das sessões durar mais.
5. Remover extensões não utilizadas ou regras de encaminhamento de porta.
6. Reduzir o tamanho da imagem do devcontainer e melhorar o cache de camadas.

4. Verifique

• Inicie um Codespace de teste para confirmar que as alterações do devcontainer são compiladas e iniciadas conforme o esperado.
• Valide o dimensionamento da máquina em relação ao uso observado quando a telemetria estiver disponível; caso contrário, marque como não verificado.
• Trate falhas inesperadas de compilação ou inicialização como bugs reais, mesmo quando a configuração parecer correta.

Saída Necessária

Fontes de desperdício: [principais impulsionadores de custo ou tempo de inicialização]

Correções propostas: [3 principais mudanças suportadas por evidências de auditoria e que passaram pelas barreiras de proteção]

Validação: [comprovado ao vivo / apenas estático / risco restante]

Impacto:

• Tempo de inicialização: [esperado] / [medido se disponível]
• Gasto mensal: [esperado] / [medido se disponível]
• Utilização de recursos: [esperado] / [medido se disponível]

Referências

• references/codespaces.md
• references/review-rubric.md — carregue ao revisar o trabalho de eficiência concluído.