Compétence d'Apprentissage par Articles Illustrés
À partir d'un sujet, produisez un article de connaissance en chinois expliquant les principes, avec des schémas explicatifs générés et intégrés, ainsi que des sources traçables et les prompts utilisés, le tout sauvegardé dans Obsidian.
Prérequis
L'hôte doit pouvoir charger la compétence ou exécuter ces instructions, disposer d'un accès réseau, de capacités de lecture/écriture de fichiers et d'un modèle de génération d'images appelable. Un environnement Codex / ChatGPT avec ces capacités est recommandé ; d'autres agents peuvent utiliser des outils de génération d'images déjà configurés. L'écriture directe dans Obsidian local nécessite un accès aux fichiers locaux ; si seule l'exportation est possible, livrez l'article et les images en précisant le manque d'intégration. Vérifiez d'abord les outils réels, ne vous fiez pas uniquement au nom du produit.
Choix du format de livraison
- Article de connaissance : Suivez les étapes 1 à 6 ci-dessous pour la vérification des sources, la création illustrée et l'archivage dans Obsidian.
- README illustré de projet : Lisez d'abord le flux de travail README. Organisez le texte et les images autour de "ce qu'il fait, à quoi ressemblent les livrables, comment l'installer, comment l'utiliser la première fois", et sauvegardez dans le projet. Ce format n'exige pas de configuration Obsidian, ni la longueur, le nombre d'images, le YAML ou la figure de synthèse d'un article long. Les principes de vérification, d'écriture et d'illustration restent les mêmes.
Portée et résultats par défaut
- Un article complet compte généralement 3000 à 6000 caractères chinois, 3 à 5 schémas explicatifs ; le nombre d'images inclut une figure de synthèse finale, ajusté selon le sujet.
- Commencez par une introduction conceptuelle sur fond clair expliquant "ce que c'est, comment ça fonctionne, quel problème ça résout", avec une définition complète ; puis présentez le contexte, la motivation et l'origine.
- Les images adoptent par défaut le style de l'Atelier IA de Jiale. Le texte et les légendes précisent les conditions qui affectent la compréhension ; les images expliquent directement les connaissances.
- Les tâches de révision ne modifient que les parties spécifiées par l'utilisateur. Si seule la carte d'introduction est ajustée, conservez le corps, les illustrations, les légendes et le style des illustrations ; ne modifiez les figures que si l'utilisateur demande explicitement une redessin.
- Effectuez la vérification, l'écriture, la génération et l'archivage dans le périmètre autorisé. Si des configurations manquantes affectent le résultat, posez des questions ciblées sans transformer un choix de format ordinaire en approbation.
1. Déterminer le coffre de notes et les dépendances
Lisez le fichier config.local.json à la racine de la compétence (s'il existe). Les instructions actuelles priment sur la configuration ; en cas de paramètre manquant, utilisez l'environnement utilisateur ou les directives de la base de connaissances. Voir les champs dans Règles d'archivage. Si le coffre cible est manquant et ne peut être déduit du contexte, demandez uniquement le chemin du coffre cible et effectuez d'abord la recherche et la rédaction de manière indépendante.
Une fois dans le coffre, lisez les fichiers AGENTS.md, le guide d'utilisation et la page d'accueil existants ; référez-vous aux notes similaires pour déterminer la structure, les métadonnées et le style de liens. Ouvrez les fichiers réels pour les liens wikilink.
Utilisez les capacités suivantes selon les besoins de cette phase, en les localisant à partir du répertoire de compétences de l'environnement actuel, sans coder en dur les chemins d'installation :
| Capacité | Priorité de réutilisation | Si non installé |
|---|---|---|
| Recherche et lecture sur les plateformes | agent-reach ; lisez d'abord ses instructions, utilisez les canaux disponibles | Utilisez les outils de lecture seule de l'hôte et précisez les canaux utilisés |
| Vérification générale des pages web et articles | Outils réseau de l'hôte ; peut être complété par research-workflow | Lisez directement les sources primaires |
| Planification de l'écriture et des illustrations | Règles de ce paquet ; peut être complété par content-research-writer, baoyu-article-illustrator | Suivez le processus de ce paquet |
| Génération ou édition d'images bitmap | Outil de génération d'images appelable par l'hôte ; si Image / imagegen natif est disponible, utilisez-le en priorité | Conservez le brouillon terminé et le plan d'illustration, précisez les lacunes d'images |
| Archivage local | Python 3.10+, script d'archivage de ce paquet | Précisez l'environnement manquant, conservez les fichiers de travail transférables |
Ces compétences externes ne sont pas distribuées avec ce paquet. Continuez les étapes déjà autorisées ; respectez les capacités et limitations réelles de l'outil hôte.
2. Vérifier et établir le brouillon de sources
Enregistrez sources.md dans le répertoire de travail actuel : notez les documents réellement ouverts, les URL, les versions ou dates, les conclusions soutenues et les problèmes non résolus. Consultez d'abord la documentation officielle, les articles, le code source et les publications originales ; les publications sur les plateformes servent à découvrir des pistes, des retours d'expérience ou des controverses. Les informations pertinentes des plateformes sont obtenues de préférence via Agent Reach.
Les chiffres, dates, architectures et conclusions de performance importants dans l'article doivent correspondre aux textes originaux lus. Les résumés de recherche ne servent que d'indices ; distinguez les faits, les inférences, les exemples pédagogiques et les résultats mesurés. Vérifiez les sources originales pour les origines et les évolutions. Lisez les notes existantes si nécessaire, réutilisez les concepts et vérifiez les cibles des liens.
Condition d'achèvement : le mécanisme central et le contexte sont documentés, les divergences clés sont expliquées, les sources sont suffisantes pour étayer les exemples concrets de l'article.
3. Rédiger la trame d'apprentissage
Lisez les Règles d'écriture pour créer un brouillon Markdown avec un frontmatter YAML. Commencez par une définition complète, organisez le contenu selon "contexte et motivation → processus global → mécanismes clés → exemples concrets → compromis techniques → conclusion d'apprentissage", l'ordre étant adapté au sujet.
Placez des marqueurs uniques aux endroits où une illustration est pertinente, par exemple <!-- figure:01 -->. Le texte explique les raisons et le raisonnement intermédiaire ; les figures montrent la structure, le processus ou les différences ; les liens vers les sources sont placés près des conclusions correspondantes. La figure de synthèse finale se situe après l'explication principale et avant la liste des sources originales.
Condition d'achèvement : le lecteur peut expliquer le processus causal, reformuler un exemple et juger des conditions d'application ; la définition d'ouverture, le contexte et la conclusion de fin sont cohérents, les conclusions clés correspondent au brouillon des sources.
4. Planifier et générer les illustrations
Lisez le Guide visuel, enregistrez illustration-plan.md en listant pour chaque figure : la question abordée, le paragraphe correspondant, les nœuds, les connexions, les valeurs et les légendes. Si vous réutilisez les illustrations de Baoyu, copiez ce guide visuel dans le répertoire actuel sous .baoyu-skills/baoyu-article-illustrator/EXTEND.md.
Enregistrez le prompt final complet de chaque figure dans un fichier comme prompts/01-flow.md. Organisez la description positive autour de "objectif d'explication, objets et relations spécifiques, mise en page, visuel, étiquettes mot à mot, format". Utilisez l'outil de génération d'images appelable par l'hôte ; si Image / imagegen natif est disponible, utilisez-le en priorité ; les paramètres et l'appel suivent les règles de l'outil actuel, généralement deux par lot.
Localisez le fichier réel à partir du résultat de l'outil, copiez-le dans le répertoire de travail actuel. Vérifiez chaque image pour les termes, les caractères chinois, les chiffres, les flèches, l'échelle de comparaison et la lisibilité. Si une erreur évidente est constatée, enregistrez le prompt de révision et corrigez de manière ciblée ; conservez les versions utilisables, et en cas de lacune persistante, signalez-la. Si les images sont manquantes ou non vérifiées, ne prétendez pas à un résultat complet illustré.
5. Sauvegarder dans Obsidian
Lisez les Règles d'archivage, enregistrez images.json. Exécutez d'abord le script d'archivage en mode --dry-run sur le vrai brouillon, les images, les prompts et les enregistrements de sources, puis archivez après confirmation. Résolvez le répertoire de compétence en chemin réel, puis appelez scripts/archive_note.py en passant explicitement le coffre cible, le répertoire de notes et le répertoire de pièces jointes.
Le script d'archivage ne crée que de nouvelles notes ; en cas de nom identique, il ajoute un suffixe de version. Pour modifier un article existant, sauvegardez d'abord et modifiez in-situ selon l'autorisation actuelle ; ne créez pas une deuxième version par archivage redondant, et ne régénérez pas les images non modifiées.
Si un style de carte est nécessaire, utilisez assets/jiale-knowledge.css ; lors de la première installation du style, ajoutez uniquement ce fragment, en conservant les paramètres et personnalisations existants de l'utilisateur. Si la base de connaissances dispose d'un index approprié, ajoutez un lien, en évitant les doublons.
6. Vérification finale
Vérifiez que l'article final, les images et les fichiers existent réellement, que tous les marqueurs figure ont été remplacés, et que les embeddings et wikilinks sont résolubles. La vérification des fichiers, la revue des caractères dans les images et l'aperçu de l'interface rapportent chacun la portée réelle de la validation.
Lors de la livraison, indiquez brièvement le contenu réalisé, l'emplacement de sauvegarde et les éventuelles lacunes, en joignant la note ou le fichier exporté ouvrable. Un article de connaissance n'est marqué comme livré complètement que si les sources, le texte, les images réelles et l'archivage sont tous terminés ; le README de projet est vérifié selon les conditions d'achèvement de son flux de travail correspondant.