Disponibilidade de material de suporte

Este texto do catálogo contém as orientações inline abaixo, mas não inclui os seguintes caminhos de suporte. Eles são pré-requisitos externos, não arquivos empacotados:

Solicite o material de suporte original ou uma instalação existente antes de usar uma etapa que dependa desses caminhos; este catálogo não identifica uma fonte de download verificada para eles. Resolva cada caminho em relação a essa instalação, inspecione seu conteúdo e verifique quaisquer licenças aplicáveis e pré-requisitos de execução. Não execute um comando nem afirme que um procedimento referenciado foi seguido até que seu arquivo necessário exista. Não fabrique os scripts ausentes nem trate um arquivo não relacionado com o mesmo nome como equivalente. Etapas independentes totalmente documentadas aqui podem prosseguir dentro do escopo autorizado do usuário; relate qualquer etapa dependente como indisponível.

Atualização Segura do SpecKit

Esta skill fornece recursos de atualização segura para instalações do SpecKit do GitHub, preservando personalizações enquanto aplica atualizações de template.

Instalação: Antes de adicionar qualquer marketplace ou clone manual, inspecione a revisão exata do plugin e todos os arquivos empacotados, relate scripts e comportamento de rede ou sistema de arquivos, e solicite aprovação explícita do usuário. Não instale um branch em movimento diretamente em um diretório de agente ativo.

Quando Usar

• Você precisa atualizar ou instalar templates do SpecKit preservando personalizações de projeto.
• Você deseja um fluxo de aprovação seguro em torno de operações de atualização, rollback ou específicas de versão do SpecKit.
• A tarefa é operar o atualizador do SpecKit de forma conversacional em vez de executar comandos brutos cegamente.

O que fazer quando esta skill é invocada

Quando o usuário invoca /speckit-updater, você deve:

1. Executar o script orquestrador de atualização sem nenhuma flag (modo conversacional):

   pwsh -NoProfile -File "<skill_path>/scripts/update-wrapper.ps1"
   

2. Analisar a saída em busca de marcadores:

   • [PROMPT_FOR_APPROVAL] - Cenário de atualização (instalação existente do SpecKit)
   • [PROMPT_FOR_INSTALL] - Cenário de instalação nova (sem diretório .specify/)

3. Para Atualizações (marcador [PROMPT_FOR_APPROVAL] encontrado):

   • Apresentar o resumo em Markdown mostrando:
     • Versão atual vs. versão disponível
     • Arquivos para atualizar/adicionar/remover
     • Conflitos detectados (se houver)
     • Arquivos preservados (personalizados)
     • Local de backup
     • Comandos personalizados
   • Solicitar aprovação do usuário para prosseguir com a atualização
   • Se aprovado, reexecutar com a flag -Proceed
   • Se recusado, informar ao usuário que a atualização foi cancelada

4. Para Instalações Novas (marcador [PROMPT_FOR_INSTALL] encontrado):

   • Apresentar uma oferta de instalação natural ao usuário, como:
     • "O SpecKit não está instalado neste projeto no momento. Gostaria que eu o instalasse?"
     • "Posso instalar os templates mais recentes do SpecKit para você. Isso criará a estrutura de diretórios .specify/ e baixará os templates do GitHub."
   • NÃO mencionar a flag -Proceed ao usuário (este é um detalhe de implementação)
   • Se o usuário aprovar (disser "sim", "prosseguir", "instalar", etc.), reexecutar com a flag -Proceed
   • Se o usuário recusar, informar que a instalação foi cancelada

5. Executar a ação aprovada reexecutando com a flag -Proceed:

   pwsh -NoProfile -File "<skill_path>/scripts/update-wrapper.ps1" -Proceed
   

Casos especiais:

• Se o usuário solicitar -CheckOnly: executar com essa flag e mostrar o relatório
• Se o usuário solicitar -Rollback: executar com essa flag e confirmar a restauração
• Se o usuário solicitar -Version específico: incluir esse parâmetro

Comandos

/speckit-updater

Atualiza templates, comandos e scripts do SpecKit, preservando personalizações.

Uso:

• /speckit-updater - Atualização/instalação interativa com fluxo de aprovação conversacional (recomendado para Claude Code)
• /speckit-updater -Proceed - Prosseguir com a atualização/instalação após aprovação (usado pelo Claude após confirmação do usuário)
• /speckit-updater -CheckOnly - Verificar atualizações sem aplicar
• /speckit-updater -Version v0.0.72 - Atualizar para versão específica
• /speckit-updater -Force - Forçar sobrescrita de arquivos do SpecKit (preserva comandos personalizados)
• /speckit-updater -Rollback - Restaurar de backup anterior
• /speckit-updater -Auto - DESCONTINUADO: Use o fluxo conversacional em vez disso (mostra aviso, mapeia para -Proceed)

Instalação Nova (Sem diretório .specify/):

• A primeira invocação mostra a oferta de instalação com o marcador [PROMPT_FOR_INSTALL]

…