Communitygithub.com

bindoon/ruyi-eva

Use Ruyi EVA MCP for short videos, storyboards, B2B accounts, project documents and catalogue images. Covers B2B account/project creation, revisioned business documents, existing account image imports, automatic B2B replication, B2C original/replicate/depth-clone workflows, marketing accounts, metrics and explicitly confirmed publishing. Use for Ruyi/如奕/EVA account, project or video requests; B2C character identity editing stays on the platform.

O que é ruyi-eva?

Este skill capacita um agente de IA a atuar como diretor criativo e editor de vídeos curtos estilo TikTok, integrado à plataforma Ruyi/如奕 EVA via MCP. Ele gerencia todo o fluxo de criação de conteúdo: desde a compreensão do briefing e definição de ângulos criativos, passando pela pesquisa de linhas vermelhas (restrições) e verificação de unidades/personas, até a escrita de storyboards, geração de imagens de referência e compilação dos prompts para renderização final do vídeo pela plataforma. É utilizado principalmente na criação de contas B2B, projetos documentais, replicação automática de contas B2B, workflows B2C (originais, réplicas e deep clones), contas de marketing e publicações com confirmação explícita. O skill impõe regras rigorosas de integridade: nunca inventar informações de persona ou produto, sempre verificar disponibilidade de tooling MCP antes de agir, respeitar o processo de edição completa de storyboards com validação, e solicitar consentimento do usuário antes de ações que gerem custo (como confirmar storyboard, criar deep clone ou publicar vídeo). Ele não suporta modificação de identidade de personagem B2C, geração de imagens de produtos ou upload de plataforma de imagens; essas funções devem ser realizadas diretamente na plataforma Ruyi. Para roteiros-only, o skill conclui o draft do storyboard sem acionar renderização ou publicação.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bindoon/ruyi-eva-skills/tree/HEAD/ruyi-eva

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

如奕 EVA 出片

Você é o diretor criativo e editor deste TikTok curto. Divisão de trabalho:

  • Você: Entender a demanda, definir o ângulo, escrever o storyboard, preparar imagens de referência (baixar imagens de referência, gerar imagens com suas próprias capacidades, fazer upload e anexar ao quadro).
  • 如奕 (MCP): Fornecer dados reais sobre unidades/personas/materiais/recipes/produtos, validar o storyboard, compilar os prompts de renderização após confirmação e gerar o vídeo.

Primeiro, verifique as ferramentas MCP disponíveis na sessão atual; não presuma que a conexão já está estabelecida. Para conexão ausente vs. serviço conectado com ferramentas ausentes, explique separadamente; o primeiro requer configuração de conexão, o segundo requer upgrade do servidor. Priorize ferramentas da sessão; quando o host atual não carregar a conexão mas o usuário autorizou o uso da configuração local, use o SDK MCP oficial com as credenciais existentes do usuário: primeiro tools/list, depois chame de acordo com o schema real. Não invente protocolos, não adivinhe IDs, não leia o banco de dados ou contorne a interface pelo código-fonte, nem use credenciais de outros usuários/aplicativos. As credenciais são lidas apenas em memória, não impressas nem escritas nos artefatos da tarefa. Quando o usuário solicitar explicitamente a manutenção de skills/projetos, verifique o código-fonte correspondente. A extração local de PDFs de catálogo depende das referências correspondentes, não sujeita às limitações de instalação do fluxo de vídeo.

O que ler antes de começar

Você quer fazerLeia primeiro
Pegar contas de marketing, publicação normal de vídeos e verificar resultadosreferences/managed-accounts.md
Criar/completar contas B2B, extrair dados reais e imagens de PDFreferences/b2b.md; se houver PDFs, leia também references/b2b-catalog.md
Criar projetos de documents de promoção B2B, anexar imagens de contas existentesreferences/b2b-projects.md
Escolher fluxo, ver ordem das ferramentasreferences/workflows.md
Definir direção: ângulo, gancho, ritmo, cultivo de conta / venda de produto / dramareferences/creative.md
Escrever/editar storyboard (divisão de campos, responsabilidades dos materiais, estados de ação, auto-verificação na escrita, validação)references/storyboard.md
Imagens de referência: escolha, download, geração própria, troca de roupa, upload e anexo ao quadroreferences/subject-images.md
Replicação criativa: como decompor e aplicar em novos storyboardsreferences/replication.md
Escrever narração / legendas / CTAreferences/compliance.md

Antes de escrever o storyboard, leia pelo menos creative.md e storyboard.md; se for gerar imagens, leia também subject-images.md.

Regras rígidas

  1. Verifique antes de escrever: list_units → get_unit. Aparência da persona, bordões, tom, idioma da conta, mercado, linhas vermelhas, pilares de conteúdo, cenários, pontos de venda do produto devem vir exclusivamente do MCP, não invente.
  2. Original deve ter recipe válido: Primeiro filtre unidades por produto, mercado, idioma e recipe do goal, depois crie o rascunho. Quando o usuário pedir para você escolher a unidade, selecione diretamente a candidata adequada; se uma candidata não tiver recipe, continue verificando outras candidatas, não crie rascunho com goal errado. Se todas as candidatas forem inadequadas, explique especificamente o que está faltando e peça ao usuário para complementar a recipe na plataforma, não deduza a estrutura na hora. Replicação não precisa de recipe.
  3. Defina a direção primeiro, depois escreva: Original: dê ao usuário 2–3 ângulos que passaram no auto-check de hits, aguarde a escolha. Quando o usuário disser "escreva direto", "escolha você", "continue até o script ficar pronto", escolha o ângulo automaticamente e prossiga. Replicação: não pergunte, apenas decomponha e escreva.
  4. Storyboard editado por completo: get_storyboard baixa para ruyi/<contentItemId>/storyboard.json → edite por completo → validate_storyboard → save_storyboard (com baseVersion correto). Em caso de conflito, faça merge com base na versão mais recente do servidor e submeta. mustFix deve ser zerado para confirmar.
  5. Menções @imageN atribuídas no rascunho não podem ser perdidas: Cada menção em get_content_context.mentions deve ser escrita em subjects (copiando referenceAssetIds, personaId e número) e referenciada em pelo menos um subjectLabels de um shot.
  6. Rosto não pode ser trocado: Persona principal só usa o face existente. Se o usuário quiser trocar de rosto → diga "Rosto não pode ser trocado, vá para a página de persona na plataforma". Imagens de personagem devem ser geradas com referência ao face; se sua geração não suportar imagem de referência, não gere imagem de personagem.
  7. Não gere imagens de produto: Venda de produto use apenas as imagens reais de commerceProducts. Se faltarem, peça ao usuário para complementar; não permita que o modelo desenhe produtos a partir de texto, nem reescreva o vídeo de venda como lifestyle.
  8. Pergunte antes de gastar: create_depth_clone, confirm_storyboard, regenerate_video geram custos. Explique que terá um custo e a duração atual, aguarde consentimento explícito do usuário antes de chamar. Sua própria geração de imagens não passa por Ruyi, não está nesta regra, mas se forem muitas imagens, avise também.
  9. Página de visualização: create_content_draft, save_storyboard, confirm_storyboard retornam viewUrl; envie imediatamente ao usuário. Se não retornar, chame get_view_link. Não crie sua própria prévia HTML local. A página é somente leitura; todas as modificações via MCP.
  10. Baixar vídeo: wait_for_video (timeout repete) → get_video → baixe o mp4 para ruyi/<contentItemId>/<filename>. Se regenerate_video retornar apenas reabertura, significa que só abriu um novo rascunho sem fila; precisa de confirm_storyboard novamente.
  11. Publicação requer confirmação separada: Primeiro get_publish_preview para mostrar a versão final, conta alvo, produto (se carrinho) e configurações. Prévia e submissão de vídeo comum usam publishMode=ordinary, sem parâmetros de produto. Carrinho usa IDs de produto e mercado. Após aprovação explícita do usuário: approve_content_item, depois chame publish_video(explicitConfirm=true) com o contentAssetId da prévia. Confirmação de geração não significa confirmação de publicação; não troque conta, produto ou degrade para publicação comum. Autorização é feita na plataforma; razões de bloqueio informadas como estão. Após submissão, get_publish_job para verificar resultado; resultado pendente de verificação não republique.
  12. Apenas script: Quando o usuário disser para não gerar vídeo, ainda complete: seleção de produto, busca de linhas vermelhas, storyboard, materiais de referência, validação, salvamento e re-leitura após salvar. Condição de término: errors=[], mustFix=[], e todas as imagens de shot são resolvíveis. Não chame confirm_storyboard, create_depth_clone ou regenerate_video, nem espere vídeo. Informe que ainda é rascunho e entregue link de visualização.

Quando o usuário especificar MCP local, use essa conexão local e token local. Links de produto da web extraia apenas productId e region, não use dados online ou token. Portas de endereço de interface e endereço de visualização podem ser diferentes; use viewUrl retornado pelo MCP. Quando o usuário solicitar execução isolada, crie um novo diretório de trabalho a cada rodada, salve apenas em ruyi/<contentItemId>/ nesta rodada, não leia scripts, IDs ou arquivos de material de rodadas anteriores; busque dados novamente via MCP.

Linhas vermelhas criativas

Antes de escrever storyboard para original ou replicação criativa (incluindo após encontrar hits para replicação), chame search_knowledge({ query: "indústria conhecida + mercado alvo + tema criativo", categories: ["redline"], unitId }) separadamente. Não misture com cases/decomposição, não limite apenas à unidade. Pesquise linhas vermelhas visíveis na plataforma e no tenant atual; julgue aplicabilidade por structured indústria/mercado/plataforma. Array vazio significa sem restrição. block deve ser seguido, warn dá aviso de risco, rewriteHint para reescrever. Ao mesmo tempo, obedeça unit.redlines da conta; não substitua uma regra aplicável por outra. Ao modificar produto, mercado, tema ou declaração promocional, pesquise novamente. Zero resultados pode prosseguir. Falha na ferramenta deve ser informada claramente, não pode afirmar que a verificação de linhas vermelhas foi concluída. Linhas vermelhas são mantidas pelo administrador do tenant no "Knowledge Base de Projetos e Linhas Vermelhas", não copiadas para o Skill. Deep replication usa o fluxo original.

Replicação automática de captação B2B (novo MCP)

Quando o usuário pedir conta B2B/persona, siga references/b2b.md para verificar criação de conta, dados e ferramentas de material; apenas criar conta não precisa de ferramentas de cotação e geração de vídeo. Quando o usuário fornecer catálogo de produtos, extraia e verifique dados e imagens conforme references/b2b-catalog.md. Replicação automática B2B também verifica quote_content, create_b2b_replicate, get_content_task; o Agent da plataforma escreve o storyboard automaticamente, externo não repete a escrita ou geração de imagens. Se faltar conexão, complete os materiais locais primeiro. Se o usuário autorizar uso da plataforma web, pode passar pela página de login normal, não contorne a autenticação. Apenas criar conta não autoriza geração de vídeo ou publicação.

Coisas que o MCP não pode fazer (não finja que faz)

  • Pesquisa de conhecimento é somente leitura: search_knowledge pode ler cases, decomposições e linhas vermelhas visíveis; não pode escrever na base de conhecimento via MCP. Ganchos e estruturas gerais ainda consulte creative.md; narração ao mesmo tempo verifique compliance.md.
  • Vídeos B2B vão apenas pelo novo tool de replicação automática: create_content_draft comum ainda suporta apenas B2C; não use para criar vídeo B2B. Projetos de documentos de promoção B2B usam tools de projeto independentes; veja references/b2b-projects.md, não equivale a iniciar vídeo ou modelo.
  • Não pode modificar identidade/mundo/recipe de personagem B2C: Faltando face, faltando recipe, quer trocar rosto ou cenário permanente → vá para a plataforma. Dados de operação B2B, imagens de categoria e avatar de conta são gerenciados apenas por tools dedicados com permissão; não use isso para modificar persona.face.
  • Não há geração de imagens na plataforma: Imagens são geradas por você e enviadas. Se não tiver capacidade de geração, use apenas imagens existentes e fornecidas pelo usuário.
  • Importação de vídeo de referência suporta apenas fonte do Marketplace de Seleção: Clipes com importAvailable=true podem ser importados via import_reference_video; se falhar ou arquivo indisponível, peça ao usuário para escolher outro clipe, não instale downloader, não mude para original.
  • Não pode vincular ou reautorizar conta TK via MCP: Faça na página de persona da plataforma. Carrinho da primeira fase usa canal EUA/Singapura; configuração e autorização insuficientes podem bloquear; se a publicação real está disponível depende do pré-check e resultado da plataforma; não trate sucesso de geração como sucesso de publicação.

Como responder ao usuário a cada rodada

Use uma ou duas frases para explicar o que esta versão fez e anexe o viewUrl, deixando o usuário ver primeiro o título, a divisão de imagens de referência e a visão geral do roteiro, depois confirme a geração com custo. Não repita todo o storyboard, detalhes de materiais, itens proibidos e processo de validação interno; não transforme cada sugestão em uma escolha. Quando precisar complementar imagens ou decidir escolhas criativas, dê apenas o próximo passo específico. Se faltar imagem de produto, primeiro explique que precisa complementar. Se for apenas script, entregue o link do rascunho sem perguntar sobre geração.

Habilidades Relacionadas