Communitygithub.com

Cobsidian

Skill de workflow agnostique pour maintenir des bases de connaissances Obsidian.

Qu'est-ce que Cobsidian ?

Cobsidian est un skill de workflow agnostique pour les agents AI conçu pour maintenir des bases de connaissances Obsidian. Il vous aide à gérer votre coffre (vault) Obsidian en tant que système de connaissances liées, plutôt que de simplement générer des fichiers Markdown isolés. Ce skill supporte plusieurs modes (apprentissage, projet, revue, comparaison, index, capture, dissection) et s'adapte à la langue de l'utilisateur. Il permet de résoudre automatiquement le chemin du coffre, de rechercher des notes existantes, d'ajouter des liens wiki, et d'éviter les doublons. Cobsidian est conçu pour être utilisé avec des agents AI comme Claude Code, Cursor ou Codex, et offre des scripts utilitaires pour analyser le coffre, suggérer des rétroliens et valider les notes.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add Totoro-qaq/Cobsidian

Demander à votre IA préférée

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

Documentation

Que fait Cobsidian ?

Principe Fondamental

Maintenez le coffre comme un système de connaissances liées. Ne générez pas simplement un fichier Markdown isolé.

Langue de Réponse

Adaptez la langue de l'utilisateur pour la sélection du mode, les questions de clarification et les rapports d'achèvement.

  • Requête en chinois -> noms de mode en chinois.
  • Requête en anglais -> noms de mode en anglais.
  • Requête multilingue -> utilisez la langue dominante de l'utilisateur et incluez les identifiants canoniques du mode entre backticks si nécessaire.

Résolution du Coffre

Résolvez le coffre cible dans cet ordre :

  1. Chemin explicite du coffre dans la requête de l'utilisateur.
  2. cobsidian.config.yml avec vault.path.
  3. Configuration de l'hôte MCP via COBSIDIAN_CONFIG.
  4. Configuration de l'hôte MCP via COBSIDIAN_VAULT.

Ne devinez pas un chemin de coffre privé. Si aucun chemin de coffre valide n'est disponible, demandez une saisie concise : le chemin du coffre ou le chemin du fichier de configuration. Si un chemin est présent mais invalide, signalez le chemin invalide et demandez un chemin de coffre/config corrigé avant d'écrire.

Sélection du Mode

Si l'utilisateur sélectionne explicitement un mode, utilisez-le et n'affichez pas le menu complet des modes. Si aucun mode n'est sélectionné, déduisez le plus petit mode utile et indiquez-le avant d'écrire. Si le mode est ambigu et que des modifications de fichiers sont impliquées, présentez brièvement les modes et posez une question concise avant d'écrire.

ModeDéclencheurs anglaisDéclencheurs chinoisUtilisation
learninglearning mode, study note, explain学习模式, 知识点整理, 学习笔记Concepts, cours, vidéos, articles, explications techniques.
projectproject mode, repo analysis, architecture项目模式, 项目整理, 源码项目Architecture de projet, notes d'implémentation, analyse de dépôt, documents opérationnels.
reviewreview mode, retrospective, failure review复盘模式, 事故复盘, 实验复盘, 失败复盘Incidents, résultats d'expériences, échecs, leçons apprises.
comparisoncomparison mode, compare, evaluate options对比模式, 选型, 方案比较Choix d'outils, options d'architecture, comparaisons modèle/base de données/framework.
indexindex mode, map, learning path索引模式, 总览, 知识地图, 学习路线Cartes thématiques, notes centrales, parcours d'apprentissage, pages de navigation.
capturecapture mode, daily capture, quick note捕获模式, 日常记录, 先记下来Capture quotidienne légère avant une organisation plus approfondie.
dissectiondissection mode, teardown, source analysis拆解模式, 源码拆解, 框架拆解, skill拆解Rétro-ingénierie d'outils, de dépôts, de frameworks, de systèmes d'agents, de prompts, de skills, de workflows.

Présentation Interactive du Mode

Ne présumez pas que l'utilisateur a lu le README ou la documentation des modes. Expliquez les modes dans la conversation lorsque :

  • l'utilisateur est nouveau avec Cobsidian ou demande ce que Cobsidian peut faire
  • l'utilisateur demande largement d'organiser/écrire du matériel dans Obsidian sans type de note clair
  • le même matériel pourrait raisonnablement devenir différents types de notes
  • la modification cible différerait selon le mode, comme une note d'apprentissage soignée vs une capture quotidienne brute

Ignorez le sélecteur lorsque l'utilisateur a déjà choisi un mode, que le mode est évident ou que l'utilisateur a demandé une exécution directe. Dans ce cas, indiquez le mode déduit et continuez :

Mode: dissection / 拆解, car il s'agit d'un démontage de framework ou de workflow.

Lorsque le sélecteur est nécessaire, utilisez la langue de l'utilisateur.

Sélecteur de mode anglais :

Cobsidian can organize this in several modes:
- learning: concepts, courses, videos, papers
- project: repos, architecture, implementation, operations
- review: failures, incidents, experiments, lessons
- comparison: tool/model/database/architecture choices
- index: topic maps, learning paths, hub notes
- capture: quick rough notes for later cleanup
- dissection: internals of tools, frameworks, repos, skills, prompts

Choose one mode, or tell me to infer it.

Sélecteur de mode chinois :

Cobsidian 可以按这些模式整理:
- 学习模式:概念、课程、视频、论文、技术解释
- 项目模式:仓库、架构、实现、运维记录
- 复盘模式:失败、事故、实验结果、经验教训
- 对比模式:工具、模型、数据库、架构选型
- 索引模式:主题地图、学习路线、导航页
- 捕获模式:先快速保存粗糙材料,后续再整理
- 拆解模式:拆解工具、框架、仓库、skill、提示词系统

选一个模式,或者告诉我由我推断。

Workflow

  1. Identifiez le chemin du coffre de l'utilisateur et le sujet cible.
  2. Recherchez les notes existantes avant d'écrire.
  3. Sélectionnez, déduisez ou présentez le mode avant d'écrire.
  4. Décidez d'une des options suivantes :
    • créer une nouvelle note
    • ajouter à une note existante
    • diviser en plusieurs notes
    • signaler uniquement les doublons et demander avant de modifier
  5. Écrivez du Markdown concis avec des titres stables.
  6. Ajoutez les [[liens wiki]] pertinents vers les notes existantes.
  7. Ajoutez une section Notes associées lorsque c'est utile.
  8. Exécutez la validation ou au moins signalez ce qui a été vérifié.

Règles d'Écriture

  • Conservez le style de dénomination des notes existant de l'utilisateur.
  • Privilégiez les concepts durables plutôt que les résumés de transcription de chat.
  • Gardez les chemins privés, jetons, noms de compte et journaux bruts hors des notes génériques, sauf si l'utilisateur souhaite explicitement des enregistrements opérationnels locaux.
  • N'inventez pas de sources, noms de fichiers ou vérifications terminées.
  • Si le même sujet existe déjà, ajoutez-y ou fusionnez plutôt que de créer un quasi-doublon.

Scripts Utilitaires

  • scripts/scan_vault.py : résume les notes, titres, tags et liens wiki.
  • scripts/find_duplicates.py : détecte les titres de notes en double ou similaires.
  • scripts/suggest_backlinks.py : suggère des notes associées pour un brouillon ou une note cible.
  • scripts/validate_notes.py : signale les liens wiki manquants et les problèmes d'hygiène de base.
  • scripts/dry_run.py : planifie une écriture sans modifier les fichiers ; signale la décision de création/ajout, les risques de doublons, les suggestions de rétroliens, l'intention de validation et les écritures vides.

Utilisez --config cobsidian.config.yml lorsque l'utilisateur dispose d'une configuration de projet avec vault.path, des seuils, des limites de rétroliens et des préférences de validation.

Lisez references/note-types.md lors du choix de la forme de la note. Lisez references/backlink-policy.md lors de l'ajout de liens. Lisez references/markdown-style.md lors du formatage des notes.

Rapport d'Achèvement

Terminez par :

  • fichiers créés ou modifiés
  • décision de création/ajout
  • vérifications des doublons effectuées
  • suggestions de rétroliens ajoutées ou ignorées
  • résultat de la validation ou raison pour laquelle la validation n'a pas été exécutée

Skills associés