female-portrait-director: transforme prompts de retrato com IA em um Skill reutilizável

Você abre ChatGPT ou Claude pela enésima vez, cola um prompt longo em inglês para retrato, troca algumas palavras e gera de novo. Muda a cena e o estilo começa a misturar. Tenta controlar parâmetros sensíveis, como idade percebida ou nível de exposição, e o resultado se afasta do que você queria. Reescrever tudo do zero toda vez cansa rápido.

female-portrait-director concentra esse problema em um Skill reutilizável. Não é uma coleção de prompts, mas um sistema de geração estruturada de prompts e direção visual. Quatro apoios de engenharia transformam texto solto escrito à mão em um sistema carregável: bloqueio de parâmetros, roteamento sob demanda, expansão modular em estilo de direção, segurança e formato de saída. Entender essa arquitetura ajuda a usar melhor o projeto e a transformar seus próprios prompts repetidos em um Skill.

O que é o projeto: não uma coleção de prompts, mas um framework extensível

female-portrait-director é um sistema de geração estruturada de prompts e direção visual para imagens com IA, com escopo explicitamente limitado a retratos fotográficos de mulheres adultas. Em 2026-06, a versão do projeto é V1.4.1; o README do repositório continua sendo a fonte de referência.

Não é um monte de templates para copiar e colar. É um framework de Skill extensível. No contexto de Claude Code e Codex, um Skill é uma pasta que empacota instruções, recursos e scripts opcionais; SKILL.md descreve o que ele sabe fazer, para que o agente o carregue apenas quando necessário. Se o mecanismo ainda não é familiar, vale ler primeiro esta explicação da função Claude Skill.

O projeto inclui, na V1.4.1, 14 rotas de estilo: retrato natural cotidiano, moda urbana, xianxia histórico, modelo de e-commerce, estilo hong-konguês, estilo francês, novo estilo chinês, esporte, viagem, retoque de estúdio, silhueta oriental mais curvilínea e variações históricas frias ou luminosas. Cada rota é um arquivo de definição de estilo carregado sob demanda. Cada solicitação escolhe uma única rota, evitando que regras de estilos diferentes entrem juntas no contexto.

Os quatro pilares de engenharia em resumo

female-portrait-director transforma prompts de retrato em um sistema reutilizável por meio de quatro decisões:

1. Bloqueio de parâmetros: os campos que o usuário preenche explicitamente não são reescritos, fundidos ou omitidos; o sistema só completa o que falta
2. Roteamento sob demanda: cada chamada carrega um único arquivo de estilo, reduzindo regras irrelevantes no contexto
3. Expansão modular em estilo de direção: o prompt completo segue uma estrutura de cinco partes, de pessoa e atmosfera a pose, roupa, cena, câmera, luz e filtro
4. Segurança e formato de saída: o Skill é limitado a mulheres adultas, bloqueia menores, nudez explícita e cenários não consensuais, e entrega blocos fáceis de copiar

Esses pontos não são isolados. O bloqueio de parâmetros mantém seu controle, o roteamento evita mistura de estilos, a expansão em estilo de direção torna a saída completa e utilizável, enquanto os limites de segurança reduzem riscos de conformidade. As próximas seções abrem cada parte.

Bloqueio de parâmetros: a direção que você dá não é reescrita em silêncio

Bloqueio de parâmetros parece rígido, mas a lógica é simples: se você preenche um campo explicitamente, o sistema não o substitui, não o funde e não o omite.

Muita gente escreve prompts de retrato começando por estilo, roupa e atmosfera, por exemplo “moda urbana, terno preto, presença profissional”. O resultado volta como “rua urbana, roupa casual, clima relaxado”. O estilo geral pode estar perto, mas os detalhes mudaram. O problema é que um prompt livre não tem um mecanismo real de bloqueio; o agente ou o modelo podem completar usando as próprias preferências e cobrir o que você escreveu.

female-portrait-director define 22 campos de parâmetro, incluindo estilo fotográfico, cena, roupa, paleta, atmosfera, idade percebida, traços faciais, corpo, câmera, luz e filtro. Quando você preenche um campo, esse valor fica bloqueado na saída. O sistema só completa campos ausentes com valores razoáveis. Ele não troca a direção que você deu.

🔥 Não perca meses em produtos sem demanda! Valide as propostas do seu SaaS com a Adsterra e pouco orçamento →

Testar agora →Anúncio

O FAQ oficial resume o limite assim: bloqueia-se a direção, não cada detalhe da imagem. Se você escreve “xianxia histórico, roupa branca, atmosfera fria”, essas três direções permanecem. Se a pessoa olha para trás perto de um bosque de bambu ou atravessa uma ponte de pedra com uma lanterna, isso pode ser completado pelo sistema. A direção grande fica travada; os detalhes pequenos continuam abertos.

Isso é diferente de escrever um único prompt longo. Em um bloco livre, “roupa branca” e “atmosfera fria” podem ficar enterrados no texto, e o agente pode interpretar mal a prioridade. Com um Skill, os parâmetros têm nome de campo, lógica de bloqueio e validação de saída. Se você já usa templates de prompt, esta biblioteca de templates de prompt explica o reúso por template; aqui o passo seguinte é um framework carregável e bloqueável.

Roteamento sob demanda: ler um só estilo por vez evita mistura

Por que carregar uma única rota de estilo por solicitação?

Se você coloca retrato natural, moda urbana e xianxia histórico em um único arquivo enorme, o agente precisa ler centenas de instruções potencialmente incompatíveis. O natural pede luz suave e maquiagem cotidiana, enquanto a moda urbana pode pedir retoque marcado e contraste forte. O resultado se contamina: você escolhe natural, mas a saída carrega maquiagem de moda urbana.

female-portrait-director usa style-registry como entrada única de roteamento. O registro lista 14 estilos implementados na V1.4.1, e cada item aponta para um arquivo route independente. Em cada solicitação, o agente lê primeiro style-registry, escolhe uma rota principal e depois carrega apenas esse arquivo route mais os módulos core necessários, como rosto, corpo ou iluminação.

A ordem de carregamento é:

1. Fluxo principal de SKILL.md
2. style-registry para escolher uma rota principal
3. Arquivo route selecionado
4. Módulos core carregados conforme necessário, como rosto, corpo e luz
5. Overlays opcionais compatíveis

Esse design retoma o princípio de “progressive disclosure” de Codex Skills: no início, o agente vê apenas name, description e caminho; depois lê o SKILL.md completo quando decide que o Skill é relevante. female-portrait-director adiciona mais um nível de roteamento dentro do próprio Skill, reduzindo uso de contexto e risco de saída com cara de template ou estilo misturado.

O número de rotas pode mudar com atualizações. Aqui são indicadas 14 rotas para V1.4.1; o README do repositório continua sendo a referência.

Expansão em estilo de direção em cinco partes: como o prompt é gerado

O bloqueio de parâmetros mantém a direção e o roteamento evita mistura, mas produzir um prompt completo e utilizável exige expansão modular.

Na saída detalhada padrão, female-portrait-director exige que o prompt final combinado tenha exatamente cinco partes:

1. Pessoa, idade, traços faciais, maquiagem e atmosfera: definição do sujeito, por exemplo “mulher de 25 anos, rosto redondo, maquiagem translúcida, atmosfera fria”
2. Recorte temporal, pequeno evento, pose, cadeia de ações e olhar: o que está acontecendo, por exemplo “manhã, em pé perto da janela, virando o corpo, olhando para fora”
3. Corpo, linhas, estrutura da roupa, cor, material, acessórios e nível visível de refinamento: detalhes estéticos, por exemplo “figura esguia, vestido longo de seda branca, joias prateadas minimalistas, elegância discreta”
4. Cena, detalhes do ambiente, profundidade, câmera, composição e profundidade de campo: espaço e lente, por exemplo “luz matinal interna, cortina translúcida, plano médio, composição na altura dos olhos”
5. Direção da luz, iluminação, realces e sombras, filtro, cor e textura: atmosfera visual, por exemplo “contraluz lateral suave, sombras delicadas, filtro de baixo contraste, paleta fria”

Essas cinco partes não são para copiar palavra por palavra. Elas são o esqueleto da expansão em estilo de direção. Você fornece alguns campos-chave, como estilo, roupa e atmosfera; o sistema completa pose, cadeia de ações, detalhes de cena e direção da luz com base na rota escolhida.

O FAQ oficial esclarece que os exemplos não devem ser copiados diretamente. Eles mostram o nível de completude, não um template fixo. Isso importa porque a próxima imagem terá outra cena, outra roupa e outra atmosfera. Copiar um prompt pronto se adapta pior do que usar essa estrutura e deixar o sistema expandir conforme seus parâmetros e a rota escolhida.

Se você leu este guia de templates de prompt para Stable Diffusion, ali o foco é escrever prompts à mão. Aqui a lógica é empacotar técnicas parecidas em uma estrutura de Skill executável.

KiloClaw - OpenClaw gerenciado para empresas: orquestração de agentes IA e roteamento inteligente

Começar →Anúncio

Formato de saída em quatro seções: blocos que dá para copiar

O formato de saída é a última barreira de engenharia. A saída detalhada padrão de female-portrait-director tem quatro seções fixas:

1. Parâmetros bloqueados: lista cada campo explícito e indica o que foi bloqueado e o que o sistema completou com valores padrão
2. Análise modular: explica as decisões da expansão em cinco partes, por exemplo por que determinada pose ou luz foi escolhida
3. Prompt final: envolvido em um bloco Markdown com rótulo text, pronto para copiar em uma plataforma de geração de imagens
4. Restrições negativas: também em um bloco text, com o que não deve aparecer, como traços de menor, exposição explícita ou expressões não consensuais

Por que não devolver só o prompt final?

Porque não basta. Os parâmetros bloqueados mostram quais direções foram preservadas, a análise modular ajuda você a decidir se deve ajustar a entrada, e as restrições negativas reduzem resultados inseguros ou indesejados. Separar as quatro seções evita o problema típico de prompts escritos à mão: um parágrafo longo em que não fica claro o que realmente importa.

O bloco usa o rótulo text em vez de plaintext porque algumas plataformas de imagem são sensíveis ao formato, e text costuma ser mais compatível. Você pode copiar o conteúdo para Midjourney, Stable Diffusion, DALL-E ou outros recursos sem limpar manualmente.

Limites de segurança: mulheres adultas, sem menores, nudez explícita ou não consentimento

Limites de segurança não são decoração. Eles são a condição para o projeto ser utilizável.

female-portrait-director é explicitamente limitado a retratos de mulheres adultas. Ele bloqueia traços que pareçam de menores, nudez explícita, expressões não consensuais e falsificação enganosa de identidade. A preservação de identidade a partir de imagens de referência se limita a imagens próprias ou retratos autorizados de adultos.

Essas regras estão no README e em SKILL.md. Não são sugestões opcionais. Quando você chama o Skill, o sistema verifica se os parâmetros ficam dentro dos limites. Se um campo implica “menor” ou uma direção insegura semelhante, a saída é recusada ou corrigida.

Por que desenhar assim? Na geração de retratos, o risco de conformidade pesa mais do que um problema de qualidade. Gerar menores, poses não consensuais ou imagens de falsa identidade pode violar regras de muitas plataformas e leis locais. Um Skill coloca o limite na lógica do sistema, em vez de depender da memória do usuário.

Use com cuidado: respeite as regras da plataforma e a lei aplicável. Esse Skill só ajuda a gerar prompts de retrato com mais eficiência dentro de um perímetro permitido. Ele não serve para contornar limites legais ou de plataforma.

Instalação e chamada: começar em três passos

O comando de instalação pode mudar com novas versões. As informações abaixo valem para 2026-06; confira o README antes de usar.

Passos básicos:

1. Execute o comando de instalação no terminal. O exemplo do README é npx skills@latest add liyue-aigc/female-portrait-director -g -a codex -y, mas o formato pode mudar em versões futuras, então confirme primeiro no repositório.
2. Depois da instalação, o Skill aparece na lista de skills do Codex. Você pode usar $skills para ver os itens instalados.
3. Para chamá-lo, escreva $female-portrait-director com seus parâmetros, como estilo, cena, roupa e atmosfera.

Se você costuma usar Claude Code em vez de Codex, lembre que o README distribui o projeto como Codex Skill e que SKILL.md segue o padrão geral de agent skill. Ele pode ser reutilizável em agentes compatíveis com esse padrão, mas a adaptação concreta deve ser verificada nas instruções do repositório. Não vale afirmar suporte oficial a Claude Code se o projeto não declara isso.

A instalação em si é simples. O ponto importante é confirmar que seu agente suporta carregamento de Skills e que o comando corresponde à versão atual.

Alibaba Cloud - Escolha dos desenvolvedores, 15% de desconto exclusivo em Lighthouse

Ganhar 15% off →Anúncio

Criar seu próprio Skill: uma migração em cinco passos

Depois de ver o design de female-portrait-director, a pergunta natural é: posso usar o mesmo padrão para transformar meus prompts repetidos em um Skill?

Sim. O processo central tem cinco passos:

1. Extraia as partes reutilizáveis: procure os campos estáveis nos prompts que você escreve à mão. Em retratos, tipo de estilo, roupa, atmosfera e direção da luz podem se repetir; pose exata e detalhes da cena mudam. Os campos estáveis viram reutilizáveis, e os detalhes variáveis ficam para o sistema completar.

2. Crie SKILL.md: é o arquivo de entrada do Skill. Ele deve incluir name e description para dizer ao agente o que faz e quando usar. A description é fundamental para o disparo. “Gerar prompts do tipo X” funciona melhor do que uma frase vaga como “ajudar a criar”.

3. Defina o schema de parâmetros: use um schema ou estrutura semelhante para descrever os campos reutilizáveis. Cada parâmetro deve ter explicação, valor padrão e limites, como faixa etária ou restrições de conformidade. female-portrait-director usa 22 campos, mas você pode começar com 5 a 10 parâmetros principais.

4. Implemente roteamento sob demanda: se você tem vários estilos ou tipos de cena, não coloque todas as regras em um único arquivo. Use um registro para encaminhar as solicitações e carregar apenas a rota correspondente. Assim você reduz mistura de estilo e carga de contexto.

5. Teste e itere: execute vários conjuntos de parâmetros e revise a saída. Os parâmetros bloqueados permanecem? Os detalhes completados são razoáveis? O formato de saída é diretamente utilizável? Depois ajuste campos do schema, conteúdo das rotas e lógica de preenchimento.

Esses cinco passos não precisam ficar perfeitos na primeira tentativa. O próprio female-portrait-director passou por divisões e reestruturações, da V1.2 à V1.4.1, antes de estabilizar núcleo leve, roteamento sob demanda, expansão em estilo de direção e bibliotecas de preenchimento visual.

Se quiser ver outro exemplo de ferramentas criativas baseadas em Skill, este caso guizang-social-card-skill transforma posts visuais de Xiaohongshu e capas do WeChat em um workflow. A ideia é parecida: converter trabalho criativo repetitivo em um sistema estruturado e carregável.

Recursos relacionados e próximos passos

Se quiser se aprofundar:

• Explicação da função Claude Skill: base para entender como Skills funcionam
• Biblioteca de templates de prompt: do reúso por template ao framework de Skill
• Guia de templates de prompt para Stable Diffusion: comparação entre prompts de imagem escritos à mão e prompts baseados em Skill
• guizang-social-card-skill: outro caso de Skill aplicado a um workflow criativo
• Repositório de female-portrait-director: https://github.com/liyue-aigc/female-portrait-director

Nota sobre fatos variáveis

Em 2026-06, a versão do projeto é V1.4.1, o número de rotas é 14 e o comando de instalação deve ser verificado no README do repositório. Esses valores podem mudar; confirme as informações no repositório antes de usar.

Conclusão

female-portrait-director transforma prompts de retrato com IA em um sistema reutilizável por meio de quatro pilares de engenharia: o bloqueio de parâmetros preserva a direção que você deu, o roteamento sob demanda evita mistura de estilos, a expansão em estilo de direção em cinco partes produz um prompt completo e utilizável, e os limites de segurança reduzem riscos de conformidade.

Depois de estudar esse caso, você pode transformar seus próprios prompts repetidos em um Skill: extraia campos estáveis, crie SKILL.md, defina um schema de parâmetros, implemente roteamento sob demanda, teste e itere. Não precisa ficar perfeito no primeiro dia. female-portrait-director também evoluiu da V1.2 à V1.4.1 antes de estabilizar a estrutura.

Se você já transformou prompts em Skills ou encontrou problemas práticos, compartilhe nos comentários.