Constructeur de compétences de marque
Cette compétence vous aide à construire et maintenir une bibliothèque de compétences de marque : un ensemble de petites compétences qui permettent à tout modèle de produire un travail conforme à la marque pour une entreprise. Elle porte l'architecture, les modèles, les scripts et les leçons d'une bibliothèque de production ; elle ne porte aucune marque propre. Chaque valeur de marque provient des sources de l'utilisateur.
Lisez references/architecture.md avant de commencer tout mode. Lisez les autres références lorsque l'étape ci-dessous les nomme.
Dossiers. Dans chaque commande, SKILL_DIR est le dossier contenant ce fichier et LIB est le dossier de bibliothèque choisi par l'utilisateur. Écrivez les deux en entier dans chaque commande ; ne les définissez pas comme variables d'environnement (sur certaines plateformes, une variable définie dans une commande est perdue dans la suivante).
Choisir le mode
| L'utilisateur veut | Mode |
|---|---|
| Des compétences de marque pour une marque qui n'en a pas encore | A. Nouvelle bibliothèque |
| Une compétence supplémentaire dans une bibliothèque existante | B. Ajouter une compétence |
| Une révision d'une compétence ou bibliothèque existante | C. Révision |
| Comprendre l'approche avant de construire | Expliquer à partir de references/architecture.md et s'arrêter |
Demandez quel mode seulement si la demande ne le précise pas.
A. Nouvelle bibliothèque
- Rassembler les sources. Demandez le guide de marque et tout ce qui régit la marque : les modèles de l'équipe design, un guide vocal, un document de messagerie, les règles de marque déposée, un guide de style, les fichiers logo, les polices et leurs licences, toute bibliothèque d'icônes ou de photos. Demandez qui possède la marque (les personnes qui ratifieront les décisions). Notez ce qui manque ; ne le comblez pas.
- Échafauder.
python3 SKILL_DIR/scripts/scaffold.py library LIB --brand "<Marque>" --era <ère>. L'ère est un court libellé pour cette version de la marque (par exemplemarque-2027). Placez les sources dansLIB/reference/. - Rédiger les fondations dans
LIB/shared-context/brand-foundations/context/à partir des sources, en suivantreferences/brand-foundations.md. Remplissez chaque TODO à partir d'une source ou enregistrez-le comme une lacune. Mesurez le contraste ; citez le libellé du guide lorsqu'il porte une règle ; donnez à chaque fichier sa provenance. Ajoutez les illustrations du logo souslogo/, etlogo-policy.md,imagery-policy.mdetchart-palette.jsonlorsque les sources les couvrent. - Réviser avec le propriétaire. Présentez les fondations sous forme d'un résumé court : le modèle de couleur, les rôles typographiques, les éléments de signature, la vérification de conformité, les lacunes, et chaque décision interne proposée avec une recommandation et sa raison. Attendez leurs décisions ; enregistrez chacune dans le tableau des décisions internes et le journal de développement.
- Construire la compétence vocale (mode B avec
--kind voice). Elle est petite et éprouve le chemin de l'instantané, du prévol et de l'empaquetage. - Construire la première compétence de format (mode B avec
--kind format), le format dont les gens ont le plus besoin. D'abord le plus petit chemin de bout en bout, puis des boucles pilotes. - Ajouter les formats un par un, en réglant d'abord les décisions internes de chaque format (
references/process.md, "Ordre de travail"). - Construire la compétence d'audit (mode B avec
--kind audit) une fois qu'il y a des spécifications de format à auditer.
B. Ajouter une compétence
- Nommez-la
<marque>-<format>(minuscules, traits d'union), ou<marque>-voice,<marque>-audit. Confirmez une compétence, un travail : si la demande chevauche une compétence existante, dites-le et recommandez d'étendre cette compétence plutôt. - Échafauder.
python3 SKILL_DIR/scripts/scaffold.py skill LIB <nom> --kind format|voice|audit --format "<PDF>". Cela écrit le modèle SKILL.md,agents/openai.yaml, le prévol, le test de plateforme, et la configuration de l'instantanéLIB/tools/snapshot/<nom>.json; pour une compétence de format aussiLIB/shared-context/<nom>/context/format-spec.mdetformat-map.json. - Régler les décisions internes du format avant d'écrire du code : pour chaque décision dans
structural-system.mddont la portée est "les autres décident lors de la construction", recommandez une réponse pour ce format, obtenez la décision du propriétaire, enregistrez-la. - Rédiger la spécification du format et la carte (mots avec les balises BOOK, RATIFIED et PROPOSED ; nombres avec les noms de rôles, jamais hexadécimaux).
- Rédiger les scripts de construction et d'assurance qualité en suivant
references/format-skills.md: le modèle planifie et écrit une spécification JSON, un script construit, un script valide le fichier terminé ; les jetons sont lus au moment de la construction ; les écarts sont enregistrés, jamais les refus. Les compétences vocales et d'audit suiventreferences/voice-and-audit.mdà la place. - Remplir SKILL.md : la description (déclencheurs, ce qu'elle ne fera pas, moins de 1 024 caractères), les étapes, l'intégration avec son tableau de correspondance visuelle-à-spécification, la référence de spécification, la section avertir-ne-jamais-refuser, et une ligne de livraison par plateforme.
- Instantané et vérifier.
python3 LIB/tools/snapshot/snapshot.py LIB/tools/snapshot/<nom>.json, puis--check, puispython3 LIB/skills/<nom>/scripts/verify_context.py. Ajoutez les polices, feuilles de style et illustrations àbundled_assetsdans la configuration pour que le prévol les prouve. - Tester (
references/qa-and-testing.md) : le test de plateforme, les constructions de fixtures sur les deux thèmes, un test de falsification par vérification QA, le test d'échange de jetons. Ensuite, des boucles pilotes avec une invite réaliste, en réexécutant la même invite après chaque correction. - Empaqueter sur demande (
references/packaging.md) :python3 LIB/tools/package/package_skill.py LIB/skills/<nom> <nom> <nouveau dossier temporaire>/<nom>.zip --date AAAA-MM-JJ. Déballez dans un autre nouveau dossier et exécutez les tests à partir de là avant de placer le zip dansLIB/finalized-skills/. - Journaliser. Chaque étape ci-dessus va dans
LIB/DEV-LOG.mdau fur et à mesure.
C. Révision
Lisez la compétence (ou bibliothèque) et comparez-la au modèle. Rapportez, dans cet ordre, chacun avec le fichier et la ligne :
- Structure : un travail, aucun appel à d'autres compétences à l'exécution,
agents/openai.yaml, aucun chemin mono-plateforme. - Contexte : un instantané groupé avec un manifeste et des condensés, un prévol qui avertit plutôt que d'arrêter, une ère de marque.
- Constructeur : les jetons sont lus au moment de la construction (ou valeurs codées en dur), une spécification JSON, des écarts au lieu de refus.
- Assurance qualité : une validation sur le fichier terminé mappée à la vérification de conformité, des tests de falsification, un mode de restyling s'il restyle.
- Flux de travail : intégration avec valeurs par défaut, planification avec revendication et preuve, approbation avant construction, livraison qui commence par les avertissements.
- Empaquetage : frontmatter strict, longueur de description et déclencheurs, un enregistrement de version.
Recommandez les corrections par ordre d'impact. Ne changez rien sauf demande.
Règles pour chaque mode
- N'inventez jamais de valeurs de marque. Aucune couleur, police, taille, règle, affirmation, chiffre ou client ne provient de connaissances générales. Une lacune est enregistrée et décidée par le propriétaire, ou l'élément est omis.
- Le guide de marque est la règle de référence ; les fichiers de conception des propriétaires comblent ses silences ; chaque écart est une décision interne avec sa portée, les mots du guide dont il s'écarte, son statut et qui l'a décidé.
- Avertissez, ne refusez jamais, dans les compétences que vous construisez : réparez et rapportez, livrez les fichiers défaillants étiquetés, arrêtez seulement pour une impossibilité physique. La compétence vocale sans fichier vocal est cette impossibilité.
- Recommandez, puis demandez sur chaque choix qui appartient au propriétaire. Construisez seulement après leur décision.
- Mesurez, ne devinez pas : contraste, largeurs de texte, nombres de lignes, rendus.
- Regardez le résultat dans le moteur de rendu réel avant de déclarer quoi que ce soit terminé.
Livraison
- sur Claude : résumez ce qui a été créé ou modifié avec les chemins, et partagez tout zip empaqueté depuis le dossier de sortie.
- sur ChatGPT : résumez ce qui a été créé ou modifié avec les chemins, et liez tout zip empaqueté en téléchargement.
Ensuite, listez ce qui reste à faire, chaque lacune en attente du propriétaire, et chaque décision PROPOSED.
Référence
| Fichier | Lisez-le pour |
|---|---|
references/architecture.md | Types de compétences, l'espace de travail, le dossier de compétence, contexte basé sur un instantané, neutralité de plateforme |
references/brand-foundations.md | Transformer un guide de marque en données : fichiers, architecture de couleur et de type, décisions internes, balises de statut |
references/format-skills.md | Le flux de travail à l'intérieur d'une compétence de format, avertir-ne-jamais-refuser, la spécification, le constructeur, la validation QA, notes par format |
references/voice-and-audit.md | La compétence vocale et la compétence d'audit |
references/qa-and-testing.md | Tests, rendus, pilotes, règles de débogage qui interagissent |
references/packaging.md | Frontmatter strict, la description, étapes de version, échecs de téléchargement |
references/process.md | Décisions, le registre vivant, ordre de travail, travailler en sécurité, leçons de la chaîne d'outils Office |