jackwener/opencli-oneshot

O que opencli-oneshot faz?

Use quando for necessário gerar rapidamente um único comando OpenCLI a partir de uma URL específica e descrição de objetivo. Processo de 4 etapas — abrir página, capturar API, escrever adaptador TS, testar. Para exploração completa do site, use opencli-explorer em vez disso.

Visão Geral

O skill opencli-oneshot permite que agentes de IA criem comandos OpenCLI sob demanda para interagir com sites específicos. Ao contrário do opencli-explorer, que mapeia um site inteiro, o oneshot foca em uma única URL e objetivo, gerando apenas o necessário.

Pré-requisitos

• Acesso a um terminal com Node.js instalado
• Conhecimento básico de TypeScript
• Acesso ao OpenCLI (instalado globalmente ou via npx)

Como Usar

Siga as 4 etapas abaixo:

Etapa 1: Abrir a Página

Abra a URL alvo e analise o conteúdo da página, identificando elementos relevantes para o objetivo.

# Exemplo: usar uma ferramenta como curl ou puppeteer para obter o HTML
curl "https://exemplo.com/alvo"

Etapa 2: Capturar a API

Inspecione as requisições de rede da página (via DevTools ou ferramentas de captura) e identifique os endpoints da API que são chamados.

// Exemplo de captura de requisição
fetch("https://api.exemplo.com/v1/items", {
  headers: { "Authorization": "Bearer token-aqui" }
})

Etapa 3: Escrever o Adaptador TS

Crie um arquivo TypeScript que defina o comando OpenCLI. O adaptador deve:

• Usar opencli build ou as funções do OpenCLI SDK
• Definir argumentos e opções para o comando
• Chamar a API capturada e processar a resposta

// Exemplo de adaptador
import { Command } from "opencli";

export default new Command("buscar-itens")
  .description("Busca itens da API")
  .option("--query <query>", "Termo de busca")
  .action(async (options) => {
    const response = await fetch("https://api.exemplo.com/v1/items?q=" + options.query);
    const data = await response.json();
    console.log(data);
  });

Etapa 4: Testar

Teste o comando gerado localmente para garantir que funciona conforme esperado.

# Exemplo de teste
npx opencli executar buscar-itens --query "exemplo"

Diferença para opencli-explorer

Característica	opencli-oneshot	opencli-explorer
Escopo	Uma URL específica	Site completo
Velocidade	Rápido, focado	Mais lento, abrangente
Uso típico	Tarefas pontuais	Exploração geral

Solução de Problemas

• Comando não encontrado: Certifique-se de que o OpenCLI está instalado.
• Erro de API: Verifique se a URL e os headers estão corretos.
• Problemas de permissão: Execute com sudo ou ajuste as permissões do diretório.

Referências

• Documentação OpenCLI
• TypeScript Handbook

---

Skill mantido por jackwener. Para sugestões ou relatórios de bugs, abra uma issue no repositório.