Communitygithub.com

liyading1818/obsidian-llm-wiki

Base de connaissances Karpathy LLM pour Obsidian : base de connaissances maintenue par LLM + compétences d'agent Cursor (wiki, video2wiki)

Qu'est-ce que obsidian-llm-wiki ?

Cette compétence transforme l'agent IA en un mainteneur discipliné d'une base de connaissances personnelle située dans le répertoire racine `<VAULT_ROOT>`. Elle est conçue pour les utilisateurs d'Obsidian et les agents comme Cursor, Claude Code ou Codex. L'agent suit un flux de travail structuré : il commence toujours par lire `AGENTS.md` pour comprendre la mise en page, les conventions et les schémas de métadonnées. En fonction de l'intention de l'utilisateur (question, ingestion, lint ou génération d'artefact), l'agent exécute des workflows spécifiques tels que la recherche dans le wiki, l'analyse des pages candidates, la synthèse de réponses avec citations, ou la création de nouveaux fichiers de sortie dans le répertoire `output/`. La compétence fournit quatre commandes CLI minimales (`wiki stats`, `wiki log`, `wiki search`, `wiki lint`) pour l'exploration et l'analyse, tandis que toutes les éditions de fichiers (création, mise à jour des index, ajout de journaux) sont effectuées directement par l'agent. Des règles critiques encadrent l'ingestion, l'utilisation de métadonnées YAML, les liens internes via `[[double-brackets]]`, et l'interdiction de modifier les répertoires `raw/` ou `clippings/`. L'agent doit résumer brièvement ses actions à l'utilisateur.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add liyading1818/obsidian-llm-wiki

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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'utilisateurWorkflow
Pose une question, souhaite une analyse / synthèseRequê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 rapportGénérer un artefact (ci-dessous)
Explore simplement ou est incertainExé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

  1. 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.

  2. Lisez wiki/index.md pour voir le catalogue.

  3. Lisez les pages candidates trouvées à l'étape 1.

  4. Si le contexte manque encore, rabattez-vous sur la lecture des fichiers pertinents dans raw/ ou clippings/.

  5. Synthétisez une réponse avec des citations [[wikilink]] vers les pages du wiki et des citations [文章](../raw/xxx.md) vers les sources brutes.

  6. 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>.md avec 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.)

  7. Si la réponse est triviale (une simple recherche de fait), répondez simplement dans le chat — aucun fichier nécessaire.

Workflow de lint

  1. Exécutez wiki lint — cela écrit lint/<aujourd'hui>.md automatiquement.
  2. 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).
  3. 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/ ou clippings/.
  • Chaque ingestion doit mettre à jour wiki/index.md et ajouter une entrée au début de wiki/log.md avec 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.

Skills associés