Synthèse automatique
Guide la création d’une nouvelle page de modèle de cas d’usage pour le référentiel Adobe Experience Platform Blueprint, de la collecte des informations à la génération du Markdown et à la mise à jour des pages de renvoi TOC.md et overview.md.
Points forts
- Définit un flux de travail clair en quatre phases, de la collecte des informations à la validation finale.
- Impose une structure de modèle complète avec frontmatter YAML, sections de contenu et liens vers les objectifs métier.
- Met à jour les références croisées dans TOC.md et overview.md en respectant les catégories et formats existants.
- Prévoit des contrôles de validation sur les liens, le nommage des fichiers, l’emplacement dans le sommaire et la complétude du frontmatter.
Limites
- Très spécifique au référentiel Adobe Experience Platform Blueprint et à ses catégories prédéfinies.
- Nécessite que l’utilisateur fournisse de nombreuses informations détaillées avant la génération.
- L’exl-id est généré comme espace réservé et certaines vérifications de liens Experience League restent manuelles.
À utiliser lorsqu’il faut ajouter une nouvelle page de modèle de cas d’usage au référentiel Adobe Experience Platform Blueprint et mettre à jour ses pages de navigation.
À ne pas utiliser pour rédiger de la documentation générale ou pour un référentiel qui n’est pas Adobe Experience Platform Blueprint.
Analyse de sécurité
SûrThe skill is a content generation guide for creating Markdown documentation in a repository. It does not instruct execution of shell commands, network requests, data exfiltration, destructive actions, or obfuscated code. It only collects information from the user and writes/edits local Markdown files using standard file operations.
Aucun point d'attention détecté
Comment cette analyse est faiteExemples
Create a new Adobe Experience Platform Blueprint use case pattern for 'event-triggered messaging' in the personalization category. Ask me for the required details first, then generate the Markdown file and update TOC.md and overview.md.Add a use case pattern page for 'real-time profile activation' under audience-building-activation. Use the pattern template, create the file in the correct folder, update the cross-references, and validate the business objective links.I need to add a new campaign management and orchestration use case pattern to the Adobe Experience Platform Blueprint site. Collect the required information, generate the pattern page, and update the TOC and overview tables.name: use-case-pattern-page-builder description: 为Adobe Experience Platform Blueprint存储库创建新的用例模式内容指南。 在添加新用例模式、创建实施指导内容或用户提及向Blueprint站点添加模式时,请使用此技能。 处理完整的工作流程:收集模式信息,生成具有正确模板结构的Markdown文件,并更新所有交叉引用页面(TOC.md、overview.md)。 source-git-commit: 349d26f612d4002d1de3d27c7f893bd63ac467a3 workflow-type: tm+mt source-wordcount: '923' ht-degree: 94%
用例模式页面生成器
此技能可指导Adobe Experience Platform Blueprint存储库创建新的用例模式。 它处理整个工作流:从用户那里收集模式信息,生成具有正确模板结构的Markdown内容文件,并更新所有交叉引用页面,以便发现新模式。
开始之前,请阅读以下参考文件,以了解完整的模板结构和要更新的页面核对清单:
references/pattern-template.md— 带占位符值的完整Markdown模板references/pages-to-update.md— 添加模式时必须更新的页面清单
第1阶段:信息收集
在生成任何文件之前询问用户以收集所有必需的信息。 询问以下问题,并且在提供每个项目或明确延迟提供每个项目之前,不要继续生成内容。
所需信息
-
模式名称 — 易于用户识别的标题(例如,“事件触发的消息传递”)。
-
类别 — 刚好是以下之一:
audience-building-activationpersonalizationcampaign-management-orchestrationanalysisconversational-experience
-
主要功能描述 — 描述此模式的用途的单个句子(用于概述表和frontmatter描述)。
-
核心Adobe解决方案 — Adobe产品是此模式的中心。 根据需要从Journey Optimizer、Real-Time Customer Data Platform、Experience Platform、Customer Journey Analytics、Brand Concierge、Journey Optimizer B2B edition、Real-Time CDP B2B edition或其他中进行选择。
-
支持的业务目标 — 来自
/help/blueprints/business-objectives/下的现有集的一个或多个业务目标。 每个名称都应包括目标名称、类别子文件夹和文件名。 在生成内容之前,请验证引用的文件是否存在。 -
战术用例示例 — 6-10个项目符号场景,描述如何在不同业务环境中应用此模式。 每个模板都应该有一个粗体方案名称,后跟一个说明。
-
KPI — 包含三列的表:KPI(名称)、描述(度量值)、度量(公式或方法)。
-
引用链接 — 引用指向主要Experience League文档的链接,这些文档涵盖了用例模式的应用程序和功能。
可选,但推荐
- 用例概述段落(3-5段;如果未提供,则从其他信息中草稿)
- 应用程序列表,其中包含每个Adobe应用程序的角色描述
如果用户不提供可选物料,则根据模式类别、解决方案和执行计划生成合理的默认值。
阶段2:内容生成
在以下路径生成模式Markdown文件:
/help/blueprints/use-case-patterns/{category}/{kebab-case-pattern-name}.md
文件名必须使用从模式名称派生的kebab大小写。 例如,“事件触发的消息传递”变为event-triggered-messaging.md。
使用references/pattern-template.md中的模板并使用收集的信息填写所有占位符值。 生成的文件必须包含模板中的每个部分:
-
YAML frontmatter — title、description、solution(逗号分隔)、exl-id(生成类似
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx的UUID占位符 — 发布团队将分配实际占位符)。 -
打开部分 —
# {Pattern name}标题,后面是介绍性段落和“使用本指南了解……” 句子。 -
用例模式 — 描述段落和执行计划。
-
用例概述 — 3-5个段落,描述模式范围、适用时间、操作和不操作以及典型利益相关者是谁。
-
关键业务目标 — 每个目标都作为链接标题,带有简要说明和KPI摘要行。
-
战术用例示例 — 6-10个方案的项目符号列表。
-
关键绩效指标 — 包含KPI、说明和度量列的表。
-
应用程序 — 具有
[!DNL ...]格式和描述的Adobe应用程序列表。
阶段3:交叉引用更新
生成图案文件后,更新以下文件。 请阅读references/pages-to-update.md以了解详细核对清单。
TOC.md
文件: /help/blueprints/TOC.md
在正确的类别部分下添加新条目。 类别映射到以下目录部分:
| 类别概要 | 目录章节标题 |
| --- | --- |
| 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} |
条目格式为:
+ [{{Pattern Title}}](/help/blueprints/use-case-patterns/{{category}}/{{filename}}.md)
在匹配部分的最后一个现有条目之后添加新条目。 保留确切的缩进(+前有四个空格)。
“概述”页面
文件: /help/blueprints/use-case-patterns/overview.md
向正确的类别表添加新行。 格式为:
| [{{Pattern Title}}]({{category}}/{{filename}}.md) | {{Primary capability description}} | [!DNL {{Solution1}}], [!DNL {{Solution2}}] |
在匹配类别表中最后一个现有行之后添加新行。
第4阶段:验证
创建并更新所有文件后,请验证以下各项:
-
业务目标链接 — 模式文件中的每个业务目标链接指向
/help/blueprints/business-objectives/下的现有文件。 使用glob或read确认每个目标文件都存在。 -
目录条目位置 — 新的目录条目位于正确的类别部分中,并使用正确的缩进和路径格式。
-
概述表行 — 新的概述行位于正确的类别表中,并且遵循与现有行相同的列格式。
-
文件命名 — 模式文件名使用kebab大小写,并与TOC.md和overview.md中引用的路径匹配。
-
Frontmatter完整性 — 模式文件在其YAML frontmatter中包含标题、描述、解决方案和exl-id。
-
Experience League链接 — 抽查所有Experience League URL是否合理(以
https://experienceleague.adobe.com/zh-hans开头)。
向用户报告任何验证失败,并在考虑任务完成之前修复它们。
注释
- 在表和正文文本中,始终使用用于Adobe产品名称的
[!DNL ...]语法,遵循现有模式文件的约定。 - frontmatter中的
exl-id应为占位符UUID。 发布管道分配实际值。 - 如果用户希望一次创建多个模式,请对每个模式重复第2-4阶段,但在第1阶段中收集所有信息。
- 如果需要上述列表中不存在的新类别,请警告用户TOC.md和overview.md需要创建新分区,并作为单独的步骤进行处理。
Du fichier au premier essai
Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.
Consulter la source et ses fichiers annexesCe téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.
1. Télécharger le fichier
Télécharger SKILL.mdDepuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.
Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.
mkdir -p '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/use-case-pattern-page-builder-mrx3xzwu/download' --output '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md.part' && mv '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md.part' '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md'2. Vérifier les prérequis
Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.
Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.
Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.
3. Charger la skill
Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.
Claude Code
test -f '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md' && test -s '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/use-case-pattern-page-builder' && cp -R '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu' '.claude/skills/use-case-pattern-page-builder'OpenSkills
OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.
Installation officielle d’OpenSkillsopenskills install './.skill-downloads/use-case-pattern-page-builder-mrx3xzwu'openskills read 'use-case-pattern-page-builder-mrx3xzwu'La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.
Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.
openskills syncMode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.
4. Faire un premier essai
Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :
Lis .skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.
Rédaction de docs Supabase
Documentation
Rédigez, éditez et révisez le contenu de la documentation Supabase : guides, tutoriels, références et partiels. Suivez les guides de style et les règles de validation MDX/TOML.
Créer un enregistrement de décision d'architecture
Documentation
Créer un nouveau ADR avec numérotation séquentielle, l'enregistrer dans le graphe AgentDB et le lier aux ADR associés.
Mise à jour de plan avec recherche approfondie
Documentation
Met à jour un document de plan en lançant des sous-agents en parallèle pour analyser un sujet sur tous les passes du compilateur, puis consolide les résultats.