O que bc-image-roaster faz?
Leia RULES.md, depois a referência da etapa em que você está. Edições leves e rápidas sobre uma imagem existente; o núcleo é o prompt, pois o usuário escreve um inglês aproximado (não é sua primeira língua). Sem composição ou máscara: a deriva é combatida com redação, verificação e novas tentativas.
Pré-requisitos
- Rook conectado (
rhino_pingretorna pong);rhino_render_viewacessível. - Python 3.11 com Pillow (não precisa de numpy) para os scripts.
- A imagem de entrada em disco; qualquer imagem de referência (um objeto a ser inserido) também em disco.
Fluxo de trabalho
- Leia a imagem. Intenção: um inventário da cena com alvos, similares e itens em risco (RULES EDT_01) → image-reading.md.
- Especificação da edição. Intenção: o que muda, o que permanece, âncoras para tamanho e posição; pergunte de volta apenas quando necessário (EDT_02).
- Prompt. Intenção: a especificação no modelo de prompt, mostrada ao usuário antes de executar (EDT_03) → prompting.md, edit-types.md.
- Executar. Intenção: uma chamada via Rook na entrada preparada (MOD_01) → models.md.
- Verificar. Intenção: mudança feita, nada mais mudou; tentar novamente com um prompt corrigido (CHK_01, CHK_02) → check.md.
- Entregar. Intenção: imagem final, folha de comparação, uma linha por tentativa falha (CHK_03).
Um prompt fornecido pelo usuário: aperte-o nas etapas 1–3, mostre-o, depois execute-o (etapas 4–6) a menos que o usuário tenha dito para não fazer. Uma edição de acompanhamento: EDT_04.
Parâmetros
| Parâmetro | Padrão | Onde |
|---|---|---|
| model | fal-ai/nano-banana-2 | models.md |
| resolution | 2K | models.md |
| aspect_ratio | a proporção da entrada, ou auto | models.md |
| limite de tentativas | 3 tentativas | RULES CHK_02 |
| limite de revisão de deriva | 3 % por região | check.md |
Roteador de tarefas
- Leitura de imagem: o inventário da cena
- Criação de prompt: modelo, regras, falha → correção de prompt
- Tipos de edição: modelos e vocabulário por tipo de edição
- Modelos: escolha do modelo, chamada Rook, limites, preços
- Verificação: julgamento de uma tentativa, novas tentativas, entrega
- Manutenção: alterações no skill, Git, sincronização
Mapa do repositório
| Tópico | Referência | Código |
|---|---|---|
| Preparação da entrada, chamada Rook | references/models.md | scripts/prep_input.py |
| Deriva por região | references/check.md | scripts/compare.py |
| Folha de comparação | references/check.md | scripts/sheet.py |
Execute um script com python -I <skill>/scripts/<name>.py --help para seus argumentos.
Exemplo de saída
Uma pasta de trabalho no projeto atual, image-roaster/<yymmdd>-<short-name>/, contendo try-01.png
… (a última é o resultado), sheet.jpg (entrada e cada tentativa lado a lado, cada uma rotulada com
modelo e veredito) e log.md (solicitação, inventário, cada prompt, cada verificação).