alfredzhang98/research-obsidian-skill

ai-wiki — archiver du contenu dans la base de connaissances (léger, par défaut)

Transforme "écris ça" en une note correctement nommée et correctement liée à l'intérieur du dossier géré par l'IA.

Cette commande ne crée pas de topics. Elle produit une note et nécessite au moins un [[wikilink]] vers une note existante. Pour placer une note sous un hub thématique avec des liens réciproques, utilisez /ai-wiki-full.

Pourquoi les topics sont désactivés par défaut : quand chaque article a son propre hub, le hub n'organise rien — il donne seulement à l'article un nom plus long. Un topic est une direction de recherche, pas le sujet d'un article. Le test se trouve dans references/note-specs.md sous "Ce qui qualifie un topic".

Où va la sortie

Tout ce que cette compétence archive atterrit dans le dossier géré par l'IA.

Zone	Comment la traiter
Dossier géré par l'IA (<AI_WIKI>/**)	créer / éditer / déplacer / renommer / supprimer — libre accès
Les dossiers de notes personnelles de l'utilisateur	lire et chercher librement ; les modifications additives sont acceptables ; demander avant de supprimer, renommer, déplacer ou écraser
.claude/rules/, CLAUDE.md	configuration statique — éditer uniquement lorsque l'utilisateur demande de modifier le comportement de Claude ; mettre à jour updated:. La seule exception dynamique est .claude/rules/active.md
.obsidian/, .trash/	accessible mais sans intervention — modifier la configuration d'Obsidian peut casser le coffre

Rien n'est bloqué au niveau des permissions, donc la retenue ci-dessus est une question de jugement. Un coffre n'est généralement pas un dépôt git ; une mauvaise réécriture d'une note manuscrite n'est récupérable qu'à partir de l'historique des versions de la synchronisation de fichiers.

Lire depuis ces zones et archiver un résumé dans le dossier géré par l'IA est exactement ce à quoi sert cette compétence.

Fichiers de référence — lisez celui dont vous avez besoin, pas les quatre

Fichier	À lire quand
references/vault-guide.md	décider quel dossier — table de routage, exemples de formulations utilisateur, le modèle des tags/wikilinks
references/note-specs.md	rédiger une note d'article, une note d'apprentissage ou un plan de topic — noms de fichiers, frontmatter, spécifications de sections, règles de rédaction
references/figures-diagrams.md	la note a besoin de figures — commande d'extraction, format d'intégration, règles mermaid
references/tools.md	choisir quelle compétence ou CLI traite l'entrée, ainsi que les workflows de bout en bout

L'archivage de routine (un dossier évident, pas de figures) n'a besoin d'aucun d'entre eux — la procédure ci-dessous suffit.

Procédure

1. Classifiez — choisissez exactement un dossier de destination dans la table de routage de references/vault-guide.md. Un contenu, un dossier ; tout ce qui est transversal repose sur tags: et [[wikilinks]], jamais une copie en double.
   • Les hits non validés, exploratoires ou par lot vont dans Inbox/, pas dans un vrai dossier.
   • Vraiment ambigu entre deux dossiers : demandez, ne devinez pas et ne dupliquez pas.
2. Nommez — selon references/note-specs.md (minuscules kebab-case) :
   • article → Research/papers/<nom-de-famille-premier-auteur>-<année>-<slug-de-2-3-mots-clés>.md (cette commande ne crée pas de topic, donc la note va à la racine de papers/ ; /ai-wiki-full la place dans papers/<topic-slug>/)
   • apprentissage → Research/learning/<topic-slug>-<AAAAMMJJ>.md
3. Vérifiez d'abord une note existante — Glob le dossier cible avant d'écrire (pour les articles utilisez Research/papers/**/*.md ; notez les sous-dossiers par topic). Mettre à jour la bonne note est mieux que de créer un quasi-doublon ; si une existe déjà, fusionnez-la et dites-le.
4. Remplissez — Lisez le squelette correspondant dans Templates/ (paper-note.md / learning-note.md) et remplissez-le sur place ; ne reconstruisez jamais la structure de mémoire. Les conseils de section se trouvent dans references/note-specs.md, pas dans les invites {{...}} du squelette.
   • Les blocs > [!callout] sont le système d'emphase — conservez-les, n'ajoutez pas de nouveaux types.
   • La fiche rapide en haut est rédigée en dernier : elle condense la note terminée. Si ses six lignes ne peuvent pas être remplies, la note ci-dessous n'est pas finie.
   • La section S0 "Ce que fait cet article, en langage simple" est obligatoire : 3-5 phrases pour quelqu'un qui connaît les bases du domaine mais n'a pas lu cet article. Ordre : la situation à laquelle ils sont confrontés, ce qu'ils ont construit, pourquoi cela fonctionne, ce qu'ils ont obtenu. Si vous ne pouvez pas écrire cette section, vous n'avez pas compris l'article — arrêtez-vous et relisez plutôt que de continuer.
   • Une note d'article répond, dans l'ordre : S0 langage simple → S1 contexte → S2 ce que les travaux antérieurs ne pouvaient pas faire → S3-S4 méthode et mathématiques → S5 ce qui a été exécuté → S6 ce qui en est ressorti → S7 limites et travaux futurs des auteurs → S8 mon analyse et opportunités de recherche.
   • S2 et S8 sont la raison d'être de la note — aucune ne peut être remplie avec un texte générique. Les mathématiques de S4 doivent pouvoir être reconstruites à partir de la note, pas seulement reconnaissables.
   • Chaque opportunité de S8 comporte les quatre lignes (opportunité → pourquoi encore non résolu → première expérience → sous quel topic elle est classée). "Aucune opportunité valable — " est valide ; une inventée ne l'est pas.
   • Rédaction professionnelle : pas d'étiquettes métaphoriques ("la coupure de cet article", "le verdict", "le nombre le plus fort"). Voir la table de rédaction dans references/note-specs.md. Chaque jugement doit reposer sur des preuves spécifiques.
   • Lisez l'article avant d'écrire. Ne remplissez jamais une section à partir du résumé ; si le texte PDF d'une section est indisponible, écrivez {{non disponible dans la source}} plutôt qu'un remplissage plausible.
5. Figures — selon references/figures-diagrams.md : figures d'article via la compétence paper-figures dans _attachments/paper-figures/<paper-slug>/ (l'arborescence des pièces jointes reste plate, jamais reflétée dans les dossiers de topic), intégrées à la section où chaque figure fait son travail.
   • Le préfixe d'intégration dépend de la profondeur de la note : ../../_attachments/... à la racine de papers/, ../../../_attachments/... à l'intérieur de papers/<topic-slug>/. C'est la seule chose qui échoue silencieusement lorsqu'une note est déplacée — vérifiez une image au hasard.
   • Les diagrammes créés utilisent une clôture mermaid. Les art ASCII sont interdits.
6. Liez (obligatoire, au moins un) — la note doit porter au moins un [[wikilink]] vers une note existante : un hub dans Research/topics/, une autre note d'article ou une note d'apprentissage.
   • Glob Research/topics/ et Research/papers/ d'abord, choisissez la cible la plus proche et indiquez la relation en une phrase plutôt que de déposer un lien brut.
   • Cette commande ne crée pas de topics. S'il n'y a vraiment rien à lier, signalez dans .claude/rules/active.md que cela ouvre un nouveau domaine et dites à l'utilisateur que /ai-wiki-full est la commande qui construit un hub.
   • Lorsque la note correspond à un topic existant, ajoutez le lien direct à la liste S6 de ce topic — les liens réciproques sont ce qui fait que le graphe se regroupe.
7. Enregistrez — si cela ouvre une nouvelle direction ou est un travail en cours, ajoutez un pointeur d'une ligne dans .claude/rules/active.md et mettez à jour son updated:. Ne reflétez pas l'état là-bas. active.md est le seul fichier de règles que ce workflow touche sans demande explicite de modification de la configuration.

Auto-vérification avant de terminer

• Chaque chemin écrit se trouve à l'intérieur du dossier géré par l'IA
• Le nom de fichier correspond aux spécifications pour son type de note ; une note d'article se trouve à la racine de papers/ (cette commande ne crée pas de topic)
• Le préfixe d'intégration correspond à la profondeur de la note, et au moins une image a été vérifiée au hasard
• Frontmatter complet (tags: présent et spécifique, pas seulement research/)
• Au moins un [[wikilink]] vers une note existante, avec la relation indiquée
• Construit à partir du fichier template réel, ordre des sections et callouts intacts
• Section S0 résumé en langage simple remplie, sans déversement de jargon
• Fiche rapide rédigée en dernier ; toutes les six lignes sont des déclarations concrètes et elle se tient toute seule
• Aucun {{placeholder}} laissé dans la note livrée
• Pas d'étiquettes métaphoriques
• Figures intégrées en ligne, pas déversées à la fin
• Note d'article : S2 nomme les méthodes antérieures réelles et leur échec spécifique ; S7 sépare les déclarations des auteurs / les miennes / leurs travaux futurs ; S8 la conclusion cite des preuves et chaque opportunité a les quatre lignes
• Note d'apprentissage : S1 est la question de l'utilisateur textuellement ; S5 a un exemple numérique réel
• Dit à l'utilisateur le(s) chemin(s) exact(s) écrit(s)

Apparenté

Pour créer ou trouver un hub thématique avec des liens réciproques, utilisez /ai-wiki-full. Choix d'outil par type d'entrée : references/tools.md. Règles de zone complètes : .claude/rules/permissions.md.