@softdesignbrasil/ai-tools

Instala as Softdesign AI skills no seu projeto para uso com o GitHub Copilot Chat no VS Code.

Pré-requisitos

• Node.js >= 16.7
• git instalado e acessível no PATH
• Acesso de leitura ao repositório ai-tools no Azure DevOps da Softdesign

Uso

Na raiz do projeto onde deseja instalar as skills:

npx @softdesignbrasil/ai-tools

O instalador copia as skills para .github/skills/ e os prompts para .github/prompts/ do projeto atual. Execute o mesmo comando a qualquer momento para atualizar as skills.

Opções

--target <dir>   Diretório do projeto alvo (padrão: diretório atual)
--token <PAT>    Personal Access Token do Azure DevOps
--dry-run        Lista os arquivos que seriam instalados, sem copiar
--help           Exibe a ajuda

Autenticação

O instalador tenta autenticar na seguinte ordem:

1. Flag --token <PAT>
2. Variável de ambiente AI_TOOLS_TOKEN
3. Credenciais git já configuradas na máquina (Git Credential Manager, etc.)
4. Prompt interativo — o instalador solicita um PAT no terminal

Para gerar um PAT: Azure DevOps → User Settings → Personal Access Tokens Permissão necessária: Code (Read)

Uso em CI

AI_TOOLS_TOKEN=$PAT npx @softdesignbrasil/ai-tools --target $PROJECT_DIR

O que é instalado

.github/
  skills/          ← skills próprias + third-party skills (audit, security, types, etc.)
  prompts/         ← prompts reutilizáveis

As third-party skills são ferramentas curadas de terceiros. Elas são instaladas no mesmo destino (.github/skills/) e funcionam como qualquer outra skill, mas não seguem os padrões de contribuição deste repositório e não devem ser modificadas.

Após a instalação, reabra o VS Code para as skills ficarem disponíveis no Copilot Chat.

Comandos disponíveis

# Listar tudo
npx @softdesignbrasil/ai-tools list

# Listar por categoria
npx @softdesignbrasil/ai-tools list skills
npx @softdesignbrasil/ai-tools list prompts

# Instalar tudo (skills + third-party skills + prompts)
npx @softdesignbrasil/ai-tools install

# Instalar por categoria
npx @softdesignbrasil/ai-tools install skill
npx @softdesignbrasil/ai-tools install prompt

# Instalar item específico (busca em skills próprias e third-party)
npx @softdesignbrasil/ai-tools install skill backend-security-issues-report
npx @softdesignbrasil/ai-tools install skill domain-analysis
npx @softdesignbrasil/ai-tools install prompt security-audit