NasonZ/riff

O que riff faz?

Claude Code × OpenAI Codex, como colegas. Uma skill para colaboração entre modelos (delegar / consultar / mesa-redonda) com contrato de rastreamento e conjunto de avaliação.

Visão Geral

A NasonZ/riff permite que desenvolvedores orquestrem colaborações entre múltiplos modelos de IA, como Claude Code e OpenAI Codex, tratando-os como colegas pares. Ela facilita interações estruturadas através de três modos principais:

• Delegar: Um modelo atribui uma subtarefa a outro modelo, com contexto e expectativas claras.
• Consultar: Um modelo pede conselhos ou opinião a outro modelo sobre uma parte específica do trabalho.
• Mesa-redonda: Múltiplos modelos discutem um problema ou design, contribuindo com suas perspectivas.

Contrato de Rastreamento

Todas as interações entre modelos são registradas em um contrato de rastreamento que inclui:

• Quem iniciou a interação (origem)
• Para quem foi direcionada (destino)
• O modo de interação (delegar, consultar, mesa-redonda)
• O conteúdo da mensagem
• O resultado ou decisão final

Isso garante que cada contribuição seja auditável e que o fluxo de trabalho permaneça transparente, mesmo quando múltiplos modelos estão envolvidos.

Conjunto de Avaliação

A skill inclui um conjunto de avaliação que permite testar a eficácia da colaboração entre modelos. Os testes verificam se:

• As delegações são compreendidas corretamente
• As consultas geram respostas úteis
• As mesas-redondas levam a decisões coerentes

Uso com MCP

A NasonZ/riff é projetada para funcionar com ferramentas que suportam o Model Context Protocol (MCP), como Claude Code. Para usar a skill, configure seu cliente MCP com os recursos apropriados.

Exemplo de Configuração

{
  "mcpServers": {
    "riff": {
      "command": "npx",
      "args": ["-y", "@nasonz/riff"],
      "env": {
        "ANTHROPIC_API_KEY": "<sua-chave-api>",
        "OPENAI_API_KEY": "<sua-chave-api>"
      }
    }
  }
}

Comandos

• /riff delegate <modelo> <tarefa> - Delega uma tarefa a outro modelo
• /riff consult <modelo> <pergunta> - Consulta outro modelo
• /riff roundtable <modelos> <tópico> - Inicia uma mesa-redonda entre modelos
• /riff trace - Exibe o histórico de rastreamento atual
• /riff eval - Executa o conjunto de avaliação

Variáveis de Ambiente

• ANTHROPIC_API_KEY - Chave da API Anthropic para Claude
• OPENAI_API_KEY - Chave da API OpenAI para Codex
• RIFF_TRACE_FILE - (Opcional) Caminho para o arquivo de rastreamento

Licença

MIT