Prepare o ambiente do GitHub Spec Kit

O nome do arquivo é mantido para preservar os links de entrada. O produto é GitHub Spec Kit, não “GitHub Dev Kit”. C# Dev Kit é uma extensão separada do VS Code.

Resumo do laboratório

[!NOTE] Um CLI instalado não é evidência de que o host selecionado descobriu suas skills.

Conceitos · Primeira tarefa · Lista de evidências · Redefinir

Objetivos de aprendizagem

• Fixe e verifique a versão da Specify CLI e sua integração.
• Diferencie o modo de skills do layout opcional de comandos.
• Evite sobrescrever a personalização de um projeto existente.

Antes de começar

Leia ambiente e limites de recursos e a referência do Spec Kit com tag de versão. Escolha uma stack de aplicação. SQL Server LocalDB não é um requisito: a trilha local usa contratos em Node/TypeScript e o suporte a SQLite incluído no Python.

Conceitos e casos de uso

O Specify instala a estrutura inicial de fluxo de trabalho. Um agente de programação com IA consome essa estrutura. A aplicação é executada no runtime escolhido no plano. Instalar uma CLI em Python não exige que sua aplicação seja escrita em Python.

Cenário do exercício

Você preparará um projeto para um exercício de projeto novo, projeto existente ou modernização. O objetivo é a descoberta e um diff seguro de inicialização, não a implementação.

Tarefa 1 - Verifique as ferramentas antes de instalar

1. Inspecione Git, o runtime da aplicação selecionado, Python e uv.
2. Configure caches/caminhos de ferramentas na sua unidade de trabalho usando a configuração compartilhada.
3. Verifique se já existe uma instalação do Specify. Instale a v1.0.4 somente quando necessário, usando uma das formas documentadas na referência.
4. Registre specify version, a fonte de instalação e specify init --help.
5. Não cole uma transcrição de versão de exemplo como se tivesse vindo da sua máquina.

Tarefa 2 - Selecione a integração

1. Escolha o layout padrão de skills do Copilot para esta trilha.
2. Inspecione os arquivos .github/skills/speckit-*/SKILL.md gerados após a inicialização.
3. Verifique se o host selecionado descobre /speckit-constitution e /speckit-specify. Skills são capacidades relevantes, não novos papéis obrigatórios de agente.
4. Se você escolher intencionalmente --integration-options="--commands", use Local para os arquivos de prompt e os comandos com ponto gerados. Registre essa escolha.

Tarefa 3 - Inicialize sem sobrescrever

1. Prepare a fixture do laboratório 13, 14 ou 17 em um diretório não utilizado.

2. Abra somente essa cópia e registre um commit Git de linha de base.

3. Inspecione a configuração existente de .github, .specify e do editor.

4. Execute:

   specify init --here --integration copilot --script sh
   

5. Revise a confirmação de diretório não vazio e o diff resultante. Se a inicialização propuser substituir um arquivo necessário, pare e concilie as alterações deliberadamente.

6. No Windows, escolha --script ps; não execute um instalador remoto com desvio de política nem desative a validação de certificados para contornar controles organizacionais.

Verifique seu trabalho

• A versão de lançamento e a fonte de instalação estão registradas.
• A integração é realmente descoberta no workspace/host escolhido.
• Os arquivos gerados correspondem ao layout de skills ou comandos selecionado.
• A aplicação original e os testes de linha de base permanecem inalterados.
• Nenhum banco de dados, assinatura, identidade global ou repositório público foi necessário.

Solução de problemas

Prática independente

Compare os arquivos gerados pelos modos de skills e comandos em dois projetos experimentais separados. Explique quais arquivos são portáveis e quais são específicos do host.

Restauração

Feche o workspace experimental. Preserve o diff de inicialização e remova somente essa cópia experimental quando não for mais necessária. Não desinstale ferramentas compartilhadas usadas por outros laboratórios.

Referências oficiais

• Instalação do Spec Kit v1.0.4
• Integração com o Copilot
• Arquivos de prompt no VS Code
• Agent Skills