Capture de connaissances

Convertir conversations et notes en pages Notion structurées et liables pour une réutilisation facile.

Démarrage rapide

1. Clarifier ce à capturer (décision, how-to, FAQ, apprentissage, documentation) et le public cible.
2. Identifier la bonne base de données/template dans reference/ (wiki équipe, how-to, FAQ, journal des décisions, apprentissage, documentation).
3. Récupérer tout contexte antérieur depuis Notion avec Notion:notion-search → Notion:notion-fetch (pages existantes à mettre à jour/lier).
4. Rédiger la page avec Notion:notion-create-pages en utilisant le schéma de la base de données ; inclure résumé, contexte, liens sources et tags/propriétaires.
5. Lier depuis les pages hub et les enregistrements connexes ; mettre à jour statut/propriétaires avec Notion:notion-update-page à mesure que la source évolue.

Flux de travail

0) Si un appel MCP échoue car le MCP Notion n'est pas connecté, pausez et configurez-le :

1. Ajouter le MCP Notion :
   • codex mcp add notion --url https://mcp.notion.com/mcp
2. Activer le client MCP distant :
   • Définir [features].rmcp_client = true dans config.toml ou lancer codex --enable rmcp_client
3. Se connecter avec OAuth :
   • codex mcp login notion

Après une connexion réussie, l'utilisateur devra redémarrer codex. Vous devez terminer votre réponse et lui dire que lors de sa prochaine tentative, il pourra continuer à l'étape 1.

1) Définir la capture

• Demander le but, le public, la fraîcheur et s'il s'agit d'une création ou d'une mise à jour.
• Déterminer le type de contenu : décision, how-to, FAQ, entrée concept/wiki, apprentissage/note, page documentation.

2) Localiser la destination

• Choisir la bonne base de données avec les guides reference/*-database.md ; confirmer les propriétés requises (titre, tags, propriétaire, statut, date, relations).
• Si plusieurs bases candidates, demander à l'utilisateur laquelle utiliser ; sinon, créer dans la DB wiki/documentation principale.

3) Extraire et structurer

• Extraire faits, décisions, actions et justifications de la conversation.
• Pour les décisions, enregistrer alternatives, justification et résultats.
• Pour les how-tos/docs, capturer étapes, pré-requis, liens vers assets/code et cas limites.
• Pour les FAQs, formuler comme Q&A avec réponses concises et liens vers docs approfondies.

4) Créer/mettre à jour dans Notion

• Utiliser Notion:notion-create-pages avec le bon data_source_id ; définir propriétés (titre, tags, propriétaire, statut, dates, relations).
• Utiliser templates dans reference/ pour structurer contenu (en-têtes de section, checklists).
• Si mise à jour d'une page existante, récupérer puis éditer via Notion:notion-update-page.

5) Lier et surfacer

• Ajouter relations/backlinks vers pages hub, specs/docs connexes et équipes.
• Ajouter un court résumé/changelog pour futurs lecteurs.
• Si des tâches de suivi existent, créer tâches dans la base de données pertinente et les lier.

Références et exemples

• reference/ — schémas de bases de données et templates (ex. team-wiki-database.md, how-to-guide-database.md, faq-database.md, decision-log-database.md, documentation-database.md, learning-database.md, database-best-practices.md).
• examples/ — patterns de capture en pratique (ex. decision-capture.md, how-to-guide.md, conversation-to-faq.md).