O que 100x-search-query faz?
一言定位
Insira um cartão de produto/persona e gere 15 frases de busca em inglês para cada uma das plataformas Pinterest, TikTok e Reddit, com o objetivo de encontrar referências visuais, imagens de inspiração e conteúdos comparáveis. Pertence à camada L2 de geração criativa do ecossistema 100x, correspondendo à etapa de "palavras-chave de busca".
Quando acionar
O usuário diz:
- "Me ajude a encontrar imagens de referência" / "Encontre imagens de inspiração" / "Onde encontro referências visuais?" / "Me dê palavras-chave de busca"
- "what should I search on Pinterest" / "find reference images"
- "need TikTok/Reddit search terms for this product"
- Ou fornece diretamente um cartão de produto / cartão de persona, solicitando um conjunto de termos de busca
Entrada
Entrada mínima (categoria A, obrigatória): category (categoria, texto livre, por exemplo "suplementos", "casa", "beleza e cuidados pessoais"; consultar futuras taxonomies/, é proibido usar qualquer dicionário de categorias específico de cliente). product_name não é uma entrada obrigatória do usuário – quando não houver um nome de marca/produto específico, usar "[âncora de categoria] <category>" como placeholder e continuar (o schema.json exige que o product_name na saída seja uma string não vazia – isso é "obrigatório no contrato de saída", não "obrigatório na entrada do usuário"; são coisas diferentes). Ver detalhes no Phase 1, categoria A do workflow.md.
Complementos opcionais (categoria B – se ausentes, ocorre degradação em três níveis, veja workflow.md Phase 1): core_benefit, target_audience, brand_tone, topic_angle (um entre default, aesthetic, pain-driven, sales-push).
Saídas opcionais de skills anteriores (categoria C – se ausentes, ignoradas silenciosamente, sem bloqueio e sem exigir que o usuário execute outro skill antes): cartão de persona, resultados de insight, resultados de viralidade. Se fornecidos, devem realmente influenciar a geração – na fase 2C, pelo menos 6 queries devem refletir o público/identidade específicos da persona; não basta receber o cartão e gerar a mesma saída de antes. Ver detalhes no Phase 1, passo 4 / Phase 2, parágrafo correspondente do workflow.md.
Saída
Estrutura conforme schema.json: queries.pinterest/tiktok/reddit com 15 entradas cada, no formato {q, intent_cn, stage}, e meta.based_on_5a declarando a cobertura 5A desta execução. Quando houver entrada de categoria C (persona/insight), meta.persona_informed deve ser true e meta.persona_descriptor_terms deve listar os termos específicos de público/identidade extraídos do cartão – caso contrário, a saída não é considerada conforme (axioma 5); quando não houver entrada de categoria C, ambos os campos podem ser omitidos. Opcionalmente, renderizar 3 tabelas Markdown (uma por plataforma, colunas: # / query / search_intent_cn / 5a_stage).
Restrições centrais (5 axiomas, detalhes em axioms.md)
- Exatamente 15 queries por plataforma, todas em ASCII inglês; faltar 1 ou misturar chinês = inválido.
- Diferenciação obrigatória por plataforma: Pinterest = vocabulário estético / TikTok = hashtags + gírias / Reddit = perguntas com dor; misturar estilos = inválido.
- Geração baseada na estratificação de intenção 5A;
meta.based_on_5aé obrigatório e não vazio; as 45 queries devem cobrir ≥3 estágios. - Cada query deve vir acompanhada de uma anotação de intenção de busca em chinês com ≤20 caracteres, no formato "rótulo de categoria fechada + explicação em chinês puro" (limitação conhecida: esta é uma validação de formato, que impede "cópia literal da tradução em inglês", mas não impede casos mais sutis como colocar um rótulo aparentemente válido em torno de uma tradução palavra por palavra – por exemplo, prefixar uma tradução literal com "questionamento:" pode passar – essa é uma lacuna semântica conhecida, não uma "garantia de zero tradução literal", veja axioma 4 TODO em
axioms.md). - Se houver entrada de persona/insight, ela deve realmente se refletir na saída: quando
persona_informed=true, pelo menos 6 das 45 queries devem conter termos dopersona_descriptor_termsque descrevem o público/identidade específico; caso contrário, a saída é inválida (limitação conhecida: a verificação por lista de termos não impede que o sistema escolha termos excessivamente amplos para cumprir a cota, apenas garante que não seja "nenhum uso", veja axioma 5 emaxioms.md).
Limite (sem exceções): Independentemente do idioma de origem do texto do produto (suporta entradas em inglês, espanhol e outros idiomas), as queries de saída são sempre em inglês – isso é uma consequência direta do axioma 1, não uma restrição adicional. Não existe a opção de versão não inglesa: as frases de saída são estritamente validadas pelo schema JSON quanto a caracteres ASCII, não há ramificação para saída em outro idioma.
Fluxo de três fases
Detalhes em workflow.md: Fase 1 (recepção + validação das categorias A/B/C) → Fase 2 (distribuição 5A → criação de buckets por plataforma → autoverificação item a item → autoverificação em lote) → Fase 3 (retrabalho acionado pelo usuário: L1 para um item, L2 para um bucket, L3 para todos; não há L4 – o axioma 1 não abre exceção para saída em outro idioma, conforme "Limites" acima).
Garantia de chamada independente
Se a categoria A estiver ausente (ou seja, category ausente – product_name não é considerado falha de categoria A quando o nome da marca não está disponível, ver seção "Entrada" acima) → resposta fixa de recusa pedindo esclarecimento; não adivinha, não inventa. Nunca exige que o usuário "primeiro execute outro skill". Categoria B ausente: degradação em três níveis (completo → pergunta extra → inferência inline com aviso em meta.warnings). Categoria C ausente: ignorada silenciosamente.
Palavras proibidas
Deixe eu / espero que / talvez / provavelmente / possivelmente / quem sabe / vamos; tom de atendente de IA (as an AI / I'd be happy to / feel free to); palavras estéticas ineficazes como attractive/beautiful/stunning/serene/pristine/elegant/cinematic/professional/studio/flawless; não inventar subreddits (este skill, por padrão, não adiciona prefixo r/xxx, veja axioms.md TODO); não inventar efeitos, certificações ou depoimentos de usuários.
Detecção de sinais de categorias sensíveis (barreira de política de conteúdo – limitação conhecida, não é axioma)
Este skill verifica os campos category/product_name e todas as q/intent_cn geradas. Se simultaneamente detectar um "sinal de categoria sensível" (por exemplo, termos relacionados a saúde íntima/cuidados privados e seus sinônimos/expressões eufemísticas) E um "sinal de alegação de autoridade" (por exemplo, termos fictícios como aprovação da FDA, médico ou especialista, e seus sinônimos), não rejeitará a geração, mas adicionará um aviso fixo obrigatório em meta.warnings. Os critérios de detecção estão no workflow.md, Phase 1, passo 6; o dicionário de sinais está em scripts/validate.js.
Limitação conhecida (declarada de forma transparente, não como "já resolvida"): Trata-se de uma verificação baseada em lista fixa de palavras-chave, não em semântica, e naturalmente tem dois limites: ① A lista cobre apenas sinônimos/expressões eufemísticas comuns – qualquer termo novo ou paráfrase que não esteja na lista ainda pode escapar; ② A verificação só enxerga os campos presentes no JSON de saída final (category/product_name/todas as q/todas as intent_cn), não o texto completo da entrada original que a Fase 1 pôde ler e que não se infiltrou nesses campos. Nota de design: O escopo de verificação para ambos os sinais é unificado como varredura de campos de texto completos (category/product_name e os textos de query/intent_cn gerados), e a lista de palavras foi complementada com sinônimos comuns (isso apenas reduz a abertura, não fecha completamente). Não se pode afirmar que "expandir a lista resolve tudo" – se for necessária uma garantia mais forte, é preciso uma detecção em nível semântico, que é o mesmo tipo de problema do axioma 4 TODO ("trava de formato vs. trava semântica").
Roteamento (recomendação, não dependência forte)
- Se já tem produto mas faltam categoria/pontos de venda → skill de persona/perfil (se existir)
- Se quer transformar o material pesquisado em prompts de geração → skill de montagem de prompts (se existir)
- Se quer fazer viralização de mídia em vez de buscar referências → skill de viralização visual (se existir)
- Se quer voltar à entrada para novo encaminhamento → entrada geral do ecossistema 100x (se existir)
Acima são recomendações pós-geração, não dependências prévias; a ausência do skill correspondente não afeta o funcionamento independente deste skill.
Autoverificação de fábrica
Execute node scripts/validate.js --selftest para validar. Os axiomas 2 e 3 são regras de agregação entre entradas; o schema.json (vanilla JSON Schema) não consegue expressá-los; quem realmente executa o julgamento é o scripts/validate.js:
node scripts/validate.js <bundle.json> [bundle2.json ...] # valida saídas
node scripts/validate.js --selftest # executa testes de regressão embutidos
Fonte
A metodologia deste skill baseia-se no sistema de metodologia de busca por inspiração, adotando um design autocontido (inclui axioms.md, workflow.md, sources.md, schema.json e script de validação), sem dependência de caminhos privados externos e sem dados privados. A descrição da evolução item a item está em sources.md.