use-case-pattern-builder
GitHub用于为 Adobe Experience Platform 蓝图仓库创建新的用例模式指南。涵盖信息收集、生成标准 Markdown 文件及更新交叉引用页面（如 TOC）的完整工作流。
Trigger Scenarios
Install
npx skills add NeverSight/learn-skills.dev --skill use-case-pattern-builder -g -y
SKILL.md
Frontmatter
{
"name": "use-case-pattern-builder",
"ht-degree": "0%",
"description": "Criação de guia de novo conteúdo padrão de caso de uso para o repositório de blueprints do Adobe Experience Platform. Use essa habilidade ao adicionar um novo padrão de caso de uso, criar conteúdo de orientação de implementação ou quando o usuário mencionar adicionar padrões ao site de blueprints. Lida com o fluxo de trabalho completo: coleta de informações de padrão, geração do arquivo do Markdown com a estrutura de modelo correta e atualização de todas as páginas de referência cruzada (TOC.md, overview.md).",
"workflow-type": "tm+mt",
"source-wordcount": "1096",
"source-git-commit": "ed8928687806b619e95d8d320478d27c13722a80"
}
Construtor de padrões de caso de uso
Essa habilidade orienta a criação de um novo padrão de caso de uso para o repositório de blueprints da Adobe Experience Platform. Ele lida com o fluxo de trabalho completo: coleta de informações de padrão do usuário, geração do arquivo de conteúdo do Markdown com a estrutura de modelo correta e atualização de todas as páginas de referência cruzada para que o novo padrão seja detectável.
Antes de iniciar, leia os seguintes arquivos de referência para a estrutura completa do modelo e a lista de verificação de páginas a serem atualizadas:
references/pattern-template.md— o modelo de marcação completa com valores de espaço reservadoreferences/pages-to-update.md— a lista de verificação de páginas que devem ser atualizadas ao adicionar um padrão
Fase 1: Coleta de informações
Entrevistar o usuário para coletar todas as informações necessárias antes de gerar quaisquer arquivos. Solicite o seguinte e não prossiga para a geração de conteúdo até que cada item seja fornecido ou explicitamente adiado.
Informações necessárias
-
Nome do padrão — O título legível (por exemplo, "Mensagens Acionadas por Eventos").
-
Categoria — Exatamente um dos seguintes:
audience-building-activationpersonalizationcampaign-management-orchestrationanalysisconversational-experience
-
Descrição de recurso principal — Uma frase única que descreve o que este padrão faz (usado na tabela de visão geral e na descrição do frontmatter).
-
Soluções Adobe principais — Os produtos Adobe são fundamentais para esse padrão. Escolha entre: Journey Optimizer, Real-Time Customer Data Platform, Experience Platform, Customer Journey Analytics, Brand Concierge, Journey Optimizer B2B edition, Real-Time CDP B2B edition ou outros, conforme apropriado.
-
Etapas da cadeia de funções — 3-6 fases sequenciais que descrevem o fluxo de execução do padrão, separadas por
>. Exemplo: "Assimilação de evento > Entrada de Jornada > Avaliação de condição > Entrega de mensagem > Relatórios". -
Objetivos de negócios com suporte — Um ou mais objetivos de negócios do conjunto existente em
/help/blueprints/business-objectives/. Cada deve incluir o nome do objetivo, a subpasta de categoria e o nome do arquivo. Verifique se os arquivos referenciados existem antes de gerar o conteúdo. -
Exemplo de casos de uso tático — 6 a 10 cenários com marcadores que descrevem como esse padrão pode ser aplicado em diferentes contextos comerciais. Cada deve ter um nome de cenário em negrito seguido por uma descrição.
-
KPIs — Uma tabela com três colunas: KPI (nome), Descrição (o que ele mede), Medida (fórmula ou abordagem).
-
Opções de implementação — 2-4 opções de implementação. Para cada opção, colete:
- Nome da opção
- Recomendado para (quando usar esta opção)
- Como funciona (2-4 parágrafos)
- Considerações principais (lista com marcadores)
- Vantagens (lista com marcadores)
- Limitações (lista com marcadores)
- Links do Experience League (URLs da documentação relevante)
Opcional, mas recomendado
- Parágrafos de visão geral do caso de uso (3-5 parágrafos; se não forem fornecidos, faça um rascunho deles das outras informações)
- Lista de aplicativos com descrições da função de cada aplicativo Adobe
- Tabela de funções básicas (função, status, o que deve estar em vigor, referência do Experience League)
- Tabela de funções de suporte (Função, Status, Por que é importante, Referência do Experience League)
- Tabelas de funções de aplicativos (uma por aplicativo, com Função, Fase de implementação, Descrição)
- Lista de verificação de pré-requisitos
Se o usuário não fornecer os itens opcionais, gere padrões razoáveis com base na categoria do padrão, nas soluções e na cadeia de funções.
Fase 2: geração de conteúdo
Gere o arquivo de marcação padrão no seguinte caminho:
/help/blueprints/use-case-patterns/{category}/{kebab-case-pattern-name}.md
O nome do arquivo deve usar letras maiúsculas e minúsculas derivadas do nome do padrão. Por exemplo, "Mensagens acionadas por evento" torna-se event-triggered-messaging.md.
Use o modelo de references/pattern-template.md e preencha todos os valores de espaço reservado com as informações coletadas. O arquivo gerado deve incluir cada seção no modelo:
-
Interface do YAML — título, descrição, solução (separada por vírgulas), exl-id (gerar um espaço reservado de UUID como
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx— a equipe de publicação atribuirá o real). -
Seção de abertura — cabeçalho
# {Pattern name}seguido de um parágrafo de introdução e a mensagem "Use este guia para entender..." sentença. -
Visão geral do caso de uso — 3 a 5 parágrafos que descrevem o escopo do padrão, quando ele se aplica, o que ele faz ou não faz e quem são os participantes típicos.
-
Principais objetivos de negócios — cada objetivo como um cabeçalho vinculado com uma breve descrição e uma linha de resumo de KPIs.
-
Exemplo de casos de uso tático — Lista com marcadores de 6 a 10 cenários.
-
Indicadores-chave de desempenho — Tabela com KPI, Descrição, Colunas de medição.
-
Padrão de caso de uso — Parágrafo de descrição e a cadeia de funções.
-
Aplicativos — Lista de aplicativos do Adobe com formatação e descrições
[!DNL ...]. -
Funções de base — Tabela com colunas: função de base, status, o que deve estar em vigor, referência do Experience League. Valores de status: Obrigatório, Presumido no Local, Não Aplicável.
-
Funções de suporte — Tabela com colunas: função de suporte, status, por que é importante, referência do Experience League. Valores de status: recomendado, incluído, não aplicável.
-
Funções do aplicativo — Uma tabela por aplicativo com colunas: Função, Fase de Implementação, Descrição.
-
Pré-requisitos — Lista de verificação usando a sintaxe
- [ ]. -
Opções de implementação — 2 a 4 opções detalhadas, cada uma com Best for, How it works, Key considered, Advantages, Limitations e links do Experience League.
-
Comparação de opções — Tabela de comparação de resumo no final.
Fase 3: Atualizações de referência cruzada
Após gerar o arquivo de padrão, atualize os arquivos a seguir. Leia references/pages-to-update.md para obter a lista de verificação detalhada.
TOC.md
Arquivo: /help/blueprints/TOC.md
Adicione uma nova entrada na seção de categoria correta. As categorias são mapeadas para estas seções de índice:
| Lesma da categoria | Cabeçalho da seção do índice |
|---|---|
audience-building-activation |
+ Audience Building & Activation{#audience-building-activation} |
personalization |
+ Personalization{#personalization-patterns} |
campaign-management-orchestration |
+ Campaign Management & Orchestration{#campaign-orchestration-patterns} |
analysis |
+ Analysis{#analysis-patterns} |
conversational-experience |
+ Conversational Experience{#conversational-experience-patterns} |
O formato da entrada é:
+ [{{Pattern Title}}](/help/blueprints/use-case-patterns/{{category}}/{{filename}}.md)
Adicione a nova entrada após a última entrada existente na seção correspondente. Preservar o recuo exato (quatro espaços antes de +).
Página de visão geral
Arquivo: /help/blueprints/use-case-patterns/overview.md
Adicione uma nova linha à tabela de categorias correta. O formato é:
| [{{Pattern Title}}]({{category}}/{{filename}}.md) | {{Primary capability description}} | [!DNL {{Solution1}}], [!DNL {{Solution2}}] |
Adicionar a nova linha após a última linha existente na tabela de categorias correspondente.
Fase 4: validação
Depois que todos os arquivos forem criados e atualizados, verifique o seguinte:
-
Links de objetivo comercial — Cada link de objetivo comercial no arquivo padrão aponta para um arquivo existente em
/help/blueprints/business-objectives/. Use glob ou read para confirmar se cada arquivo de destino existe. -
Posicionamento da entrada do sumário — A nova entrada do sumário está dentro da seção de categoria correta e usa o formato de recuo e caminho corretos.
-
Linha de tabela de visão geral — A nova linha de visão geral está na tabela de categoria correta e segue o mesmo formato de coluna das linhas existentes.
-
Nomeação do arquivo — O nome de arquivo padrão usa kebab-case e corresponde ao caminho referenciado em TOC.md e overview.md.
-
Integridade do Frontmatter — O arquivo padrão inclui título, descrição, solução e exl-id no frontmatter do YAML.
-
Links do Experience League — Verifique se todas as URLs do Experience League são plausíveis (comece com
https://experienceleague.adobe.com/pt-br).
Relate quaisquer falhas de validação ao usuário e corrija-as antes de considerar a tarefa como concluída.
Notas
- Sempre use a sintaxe
[!DNL ...]para nomes de produtos Adobe em tabelas e corpo de texto, seguindo a convenção de arquivos de padrão existentes. - O
exl-idno front-matter deve ser um UUID de espaço reservado. O pipeline de publicação atribui o valor real. - Se o usuário quiser criar vários padrões de uma só vez, repita as Fases 2 a 4 para cada padrão, mas colete todas as informações na Fase 1.
- Se for necessária uma nova categoria que não exista na lista acima, avise o usuário de que o TOC.md e o overview.md precisarão da criação de novas seções e lidarão com isso como uma etapa separada.
Version History
- e0220ca Current 2026-07-05 23:26
