Suporte upstream empacotado

Arquivos de suporte estão incluídos em caminhos relativos à skill. Veja UPSTREAM-NOTICE.md para suas fontes fixadas, licenças, hashes e alterações de importação.

Oh My Pi Delegate

Quando Usar

• Você quer delegar uma tarefa de codificação limitada a um omp implementador separado (Oh My Pi) e depois revisar seu diff pessoalmente.
• O usuário pediu explicitamente a delegação para este implementador.

Você é o orquestrador. Delegue uma tarefa de codificação limitada a um implementador separado - Oh My Pi (omp) - depois revise o que ele produziu e integre você mesmo. Você escreve o briefing e é responsável pelo julgamento; o implementador faz as alterações em sua própria sessão; você verifica e confirma.

O loop precisa apenas de um comando de shell e acesso a arquivos, então qualquer orquestrador comparável pode controlá-lo.

O binário é omp, não pi

Oh My Pi é um fork do Pi. Esta skill controla omp (@oh-my-pi/pi-coding-agent). O CLI original do Pi é um binário diferente (pi) com uma skill diferente (pi-delegate). Se omp estiver faltando, mas pi estiver instalado, você tem o Pi, não o Oh My Pi.

Quando NÃO Usar

• A tarefa é pequena o suficiente para ser feita inline; o overhead de delegação não vale a pena.
• O CLI omp não está instalado ou autenticado.
• O usuário pediu o CLI original do Pi (pi) — use pi-delegate.
• Você precisa de um implementador em sandbox. Oh My Pi não tem sandbox. --read-only restringe a superfície de ferramentas; uma execução com capacidade de escrita executa sem prompts (--yolo).

Pré-requisitos (verificar uma vez)

1. Instale o omp com bun install -g @oh-my-pi/pi-coding-agent (ou o caminho de instalação de https://omp.sh).
2. Autentique: /login dentro do omp para um provedor de assinatura, ou uma variável de ambiente API-key para um provedor de API-key. As credenciais ficam em ~/.omp/.
3. Confirme que omp --version é bem-sucedido.
4. Trabalhe em, ou aponte --cd para, o repositório git alvo.

Escolha o modelo (opcional)

Omita --model (e --provider) para usar o padrão configurado do omp para este projeto / perfil. O catálogo é dos provedores autenticados desta instalação — não uma lista fixa nesta skill.

Para escolher outro modelo:

1. Liste o que esta instalação pode realmente executar. Não passe omp --list-models — essa flag foi removida e o omp a trata como uma flag desconhecida (saída 2). Use o subcomando models:
   • omp models — todos os modelos disponíveis, agrupados por provedor
   • omp models --json — o mesmo catálogo, legível por máquina
   • omp models find <substring> — filtre por provedor, id ou nome (exemplo: omp models find sonnet)
   • omp models <provider> — modelos de um provedor
2. Passe esse id para o relay. --model <pattern> é o próprio --model do omp: uma correspondência aproximada contra o catálogo (provedor/id, um id nu, ou uma substring única). --provider <name> fixa o provedor quando o padrão é ambíguo.
3. O relay encaminha apenas letras, dígitos e . _ : / -. Padrões glob com * são rejeitados.

--thinking <level> é um dial de raciocínio separado, não um id de modelo. Valores permitidos: off, auto, minimal, low, medium, high, xhigh, max. O relay rejeita qualquer outra coisa (incluindo inherit) antes do despacho — o omp, de outra forma, avisaria e ignoraria um valor incorreto.

Uma linha de frota (--lane) pode definir provider, model e effort. A linha effort se torna --thinking; uma flag explícita --thinking / --model / --provider tem precedência sobre a linha.

O relay não encaminha --api-key, --smol, --slow ou --plan. Estes permanecem como CLI do próprio omp.

O loop

Execute estas cinco etapas por tarefa. As etapas 1, 4 e 5 exigem julgamento; 2 e 3 são mecânicas.

1. Escreva o briefing

Oh My Pi vê apenas o texto que você envia mais o que ele pode inspecionar no espaço de trabalho - sem histórico de chat ou contexto compartilhado. Inclua o objetivo, estado atual, o que mudar, o que não tocar, os portões reais do projeto e um contrato de relatório. Diga ao omp para não commitar. Mantenha uma tarefa por briefing. O omp carrega automaticamente arquivos de contexto AGENTS.md/CLAUDE.md do espaço de trabalho e seus pais, então as instruções do repositório chegam a ele sem serem inline. Veja references/writing-the-brief.md.

2. Despacho

Use o relay empacotado. Ele envia o briefing para omp --mode json via stdin, captura o fluxo de eventos JSON e escreve result.json. (<skill-dir> é a pasta instalada contendo esta SKILL.md.)

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
# liste modelos primeiro:                       omp models   (ou: omp models --json)

…