Compétence Wiki
Cette compétence transforme l'agent en un mainteneur discipliné de la base de connaissances personnelle de l'utilisateur située dans <VAULT_ROOT> (la racine du dépôt).
Étape 0 — Toujours lire AGENTS.md en premier
Avant de faire quoi que ce soit, lisez AGENTS.md à la racine du coffre. Il définit l'organisation des répertoires, les conventions des pages, le schéma des métadonnées, le format des journaux et les workflows détaillés. Ce SKILL.md n'est qu'un répartiteur ; AGENTS.md est la source de vérité.
Répartition : que demande l'utilisateur ?
Choisissez exactement une de ces intentions à partir du message de l'utilisateur :
| Intention de l'utilisateur | Workflow |
|---|---|
| Pose une question, souhaite une analyse / synthèse | Requête (ci-dessous) |
| A déposé un nouveau fichier ou a dit "ingère ceci" | Ingérer (voir AGENTS.md §4.1) |
| A dit "lint" / "vérification santé" / "trouve les problèmes" | Lint (ci-dessous) |
| Souhaite une comparaison / un diaporama / un graphique / un rapport | Générer un artefact (ci-dessous) |
| Explore simplement ou est incertain | Exécutez wiki stats puis demandez ce qu'il veut |
En cas de doute, posez une courte question de clarification avant de continuer.
Workflow de requête
-
Exécutez
wiki search <mot-clé>à la racine du dépôt pour trouver les pages candidates. Utilisez plusieurs variantes de mot-clé si nécessaire. -
Lisez
wiki/index.mdpour voir le catalogue. -
Lisez les pages candidates trouvées à l'étape 1.
-
Si le contexte manque encore, rabattez-vous sur la lecture des fichiers pertinents dans
raw/ouclippings/. -
Synthétisez une réponse avec des citations
[[wikilink]]vers les pages du wiki et des citations[文章](../raw/xxx.md)vers les sources brutes. -
Si la réponse a une valeur durable (une comparaison, un aperçu dérivé, une synthèse non triviale), écrivez-la en tant que fichier Markdown dans
output/<YYYY-MM-DD>-<slug-court>.mdavec des métadonnées :--- type: artifact kind: answer | comparison | analysis | report | slides created: <date> question: "<la question de l'utilisateur, textuelle>" sources_used: [wiki/concepts/X.md, wiki/sources/Y.md, ...] ---Puis demandez à l'utilisateur : "Souhaitez-vous archiver cette sortie dans
wiki/questions/<slug>.md?" (Si oui, copiez et mettez à jour index.md & log.md.) -
Si la réponse est triviale (une simple recherche de fait), répondez simplement dans le chat — aucun fichier nécessaire.
Workflow de lint
- Exécutez
wiki lint— cela écritlint/<aujourd'hui>.mdautomatiquement. - Lisez ce fichier et résumez pour l'utilisateur (quels problèmes sont réels, lesquels sont des faux positifs comme les
[[exemples]]littéraux dans la documentation). - Proposez un plan de correction priorisé. Ne corrigez pas automatiquement — laissez l'utilisateur choisir.
Workflow de génération d'artefact
Identique au workflow de Requête, mais la forme livrable est explicite (tableau / diapositives Marp / graphique Python / canvas). Sauvegardez toujours dans output/. Pour les diaporamas, utilisez le format Markdown Marp. Pour les graphiques, écrivez un script Python dans output/scripts/ et exécutez-le pour produire l'image à côté.
Convention du répertoire de sortie
output/
├── 2026-06-26-rag-vs-llm-wiki.md # artefact de réponse / comparaison
├── 2026-06-26-karpathy-summary.slides.md # diaporama Marp
├── scripts/ # scripts d'aide pour la génération de graphiques
└── assets/ # images rendues, exportations
Le répertoire output/ est propriété du LLM, ajout uniquement (ne supprimez pas les artefacts antérieurs sans demander). Chaque fichier doit avoir les métadonnées montrées ci-dessus afin que l'utilisateur puisse ensuite promouvoir les artefacts dans le wiki.
Commandes CLI disponibles (exécutées depuis <VAULT_ROOT>)
Seulement quatre commandes, délibérément minimales :
wiki stats # aperçu : nombre de pages par type/statut
wiki log -n 10 # dernières N entrées de wiki/log.md
wiki search <regex> # recherche en texte intégral (--scope wiki|raw|clippings|all)
wiki lint # écrit lint/<aujourd'hui>.md avec les orphelins/cassés/stubs
Tout le reste (création de pages, édition des métadonnées, mise à jour de index.md, ajout à log.md) est fait par lecture et écriture directes de fichiers Markdown. Ne demandez pas une CLI pour faire des éditions de fichiers — c'est votre travail.
Règles critiques (provenant d'AGENTS.md)
- Ne modifiez jamais les fichiers dans
raw/ouclippings/. - Chaque ingestion doit mettre à jour
wiki/index.mdet ajouter une entrée au début dewiki/log.mdavec le format## [YYYY-MM-DD] ingest | <titre>. - Référencez croisement avec
[[doubles-crochets]]entre les pages du wiki. - Les pages nécessitent des métadonnées YAML (
type,tags,created,updated,sources,status). - En cas d'incertitude, demandez à l'utilisateur. Ne faites pas de grandes refontes silencieuses.
Style de rapport
Après avoir terminé un workflow, donnez à l'utilisateur un court résumé :
- Ce que vous avez fait (1 à 3 puces)
- Quels artefacts ont été créés ou modifiés (chemins relatifs)
- Toute question non résolue ou nouvelle lacune que vous avez remarquée
Restez concis. L'utilisateur navigue dans Obsidian en parallèle et peut voir les modifications de fichiers.