Nika Skill

Use Nika como um worker de fluxo de trabalho determinístico orquestrado pela ferramenta Hermes terminal. Nika é um motor Rust open-source (AGPL) que captura uma tarefa de IA repetível como um arquivo de texto puro *.nika.yaml, o audita antes que um único token seja gasto (plano, limite de custo, fluxos secretos, tipos), o executa contra provedores locais ou na nuvem (Ollama/llama.cpp/vLLM incluídos) e registra um rastro à prova de adulteração.

Divisão de trabalho: Hermes orquestra · Nika captura trabalho repetível como um arquivo verificável e o executa com recibos. Nika NÃO é outro agente de codificação — para codificação autônoma, use a habilidade opencode. Delegue para Nika quando o trabalho deve ser repetível, orçado e auditável.

Quando Usar

• O usuário pede para executar, verificar ou criar um fluxo de trabalho *.nika.yaml
• Uma tarefa será repetida (resumo diário, triagem, ETL, relatório, pipeline LLM de várias etapas) — capture-a como um fluxo de trabalho em vez de reenviar o prompt
• O usuário deseja um limite de custo rígido, uma estimativa de custo antes de executar ou recibos/auditoria do que foi executado
• Um pipeline mistura modelos/provedores (local + nuvem) ou mistura etapas LLM com etapas de shell/HTTP/arquivo
• O usuário deseja uma execução que possa reproduzir, verificar ou repetir mais tarde

Quando NÃO Usar

• Perguntas pontuais ou chamadas de ferramenta únicas — apenas responda ou use uma ferramenta
• Implementação/refatoração de código autônomo/revisão de PR — use a habilidade opencode
• Tarefas interativas de ida e volta — fluxos de trabalho são projetados para serem não interativos

Pré-requisitos

• Nika instalado: brew install supernovae-st/tap/nika — outros caminhos de instalação (script, download manual) são documentados em https://nika.sh: a instalação é um passo humano, não algo que esta habilidade executa
• Verificar: terminal(command="nika --version")
• Zero chaves necessárias para trabalho local/offline: --model mock/echo (offline) e --model ollama/... (local) executam sem nenhuma chave de API
• Provedores de nuvem leem variáveis de ambiente padrão do shell; terminal(command="nika doctor") diagnostica e imprime comandos de correção exatos

Como Executar

Prove a cadeia de ferramentas offline primeiro (sem chave, sem rede):

terminal(command="nika examples run 01-hello --model mock/echo")

Execute um fluxo de trabalho real — modelo local primeiro:

terminal(command="nika run flow.nika.yaml --model ollama/qwen3.5:4b", workdir="~/project")

Modelo na nuvem com um orçamento rígido (sempre defina um para modelos pagos):

terminal(command="nika run flow.nika.yaml --model mistral/mistral-small-latest --max-cost-usd 0.25", workdir="~/project")

Passe variáveis do fluxo de trabalho:

terminal(command="nika run report.nika.yaml --var city=Paris --var days=7 --max-cost-usd 0.50", workdir="~/project")

Execuções longas: inicie em segundo plano e consulte — não bloqueie o turno:

terminal(command="nika run long.nika.yaml --max-cost-usd 1.00", workdir="~/project", background=true)
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")

A lei de verificar antes de executar

Nunca execute um fluxo de trabalho que você não verificou. nika check é um pré-voo estático (sem tokens gastos, sem rede): forma do plano, limite de custo, análise de fluxo secreto, verificações de tipo, argumentos de ferramenta.

terminal(command="nika check flow.nika.yaml --json", workdir="~/project")

As descobertas carregam códigos NIKA-XXXX que se explicam via nika explain NIKA-XXXX. Saída 0 = verde, seguro para executar. Corrija as descobertas antes de executar — nunca as suprima.

Criação de um fluxo de trabalho

Transforme uma tarefa repetida em um arquivo. Liste modelos, depois instancie:

terminal(command="nika new --from '?'")
terminal(command="nika new flow.nika.yaml --from chain", workdir="~/project")

--from também aceita intenção em palavras simples. Edite o esqueleto (vars:, tasks:, outputs:), então verifique-o. nika explain flow.nika.yaml narra o que fará, as ondas, o limite de custo e o que toca — antes que qualquer coisa seja executada.

O artefato que você está produzindo se parece com isto (verificações limpas em 0.98):

nika: v1
workflow: daily-brief
model: ollama/qwen3.5:4b
tasks:
  - id: fetch
    invoke:
      tool: "nika:fetch"
      args: { url: "https://hn.algolia.com/api/v1/search?tags=front_page" }
  - id: brief
    depends_on: [fetch]
    infer:
      max_tokens: 300
      prompt: |
        Five bullet points, most signal first: ${{ tasks.fetch.output }}
outputs:
  brief: ${{ tasks.brief.output }}

Um arquivo, YAML simples: tarefas, uma dependência explícita, uma etapa de modelo limitada, uma saída declarada. Esse arquivo é o que é verificado, executado, comparado e reutilizado.

Honestidade de custo

…