Communitygithub.com

Shiinama/idea-capture

Un skill pour agents IA permettant de capturer des idées de manière structurée et à faible friction pendant le workflow, de préserver leur contexte et de les transformer en fiches d'idées réutilisables.

Qu'est-ce que idea-capture ?

Ce skill permet à un agent IA (comme Claude Code, Cursor ou Codex) de capturer des idées émergeant en cours de travail sans interrompre le flux de l'utilisateur. Il exploite le contexte de la conversation en cours pour enregistrer non seulement l'idée brute, mais aussi l'environnement mental dans lequel elle est apparue (scène, déclencheur, problème en cours). Les idées sont stockées sous forme de fiches au format Markdown dans un répertoire local (`~/.idea-pool` ou `$IDEA_POOL_DIR`), avec une structure prédéfinie comprenant les sections Raw, Context, Core Judgment, Evidence, Expansion, Content Forms et Missing. Le skill suit un flux de capture simple : création immédiate d'une fiche avec la Raw, puis remplissage des sections structurées à partir du contexte existant, sans demander à l'utilisateur de fournir des informations supplémentaires. Il prend en charge la synchronisation via Git si le pool est un dépôt, et permet la recherche et le croisement des fiches via un système de tags et de références croisées. L'approche est minimaliste et respecte la langue d'origine de l'idée, sans traduction forcée.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add Shiinama/idea-capture

Demander à votre IA préférée

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

Documentation

Capture d'idées

Vous êtes le gardien du réservoir d'idées de l'utilisateur. Les idées émergent en cours de travail — pendant que l'on code, que l'on débat d'une fonctionnalité, que l'on lit des données — et leur valeur est liée au contexte mental dans lequel elles sont apparues. Votre travail consiste à attraper l'idée avant que l'attention de l'utilisateur ne change, puis à utiliser le contexte que vous avez déjà de la conversation en cours pour préserver cette scène mentale, afin que l'utilisateur futur puisse y revenir au lieu de trouver une simple ligne sans vie.

Vous n'avez besoin d'aucun outil externe. Tout ce qui suit est réalisé avec vos propres capacités de fichier, de recherche et de shell.

Le réservoir d'idées

  • Emplacement : $IDEA_POOL_DIR si défini, sinon ~/.idea-pool. Créez-le lors de la première utilisation.
  • Fiches : <pool>/YYYY/MM/<id>.md où <id> est l'heure de création formatée YYYYMMDD-HHMMSS (utilisez l'heure locale actuelle).
  • Pièces jointes (captures d'écran, fichiers) : copiez-les dans <pool>/assets/<id>-<nom_fichier> et référencez-les depuis la fiche.
  • Si le pool est un dépôt git, synchronisez après chaque écriture (voir Synchronisation). S'il ne l'est pas, ne le transformez jamais en dépôt de votre propre chef — suggérez-le une fois si l'utilisateur semble travailler sur plusieurs machines.

Format de la fiche

---
id: 20260101-090000
created: 2026-01-01 09:00
updated: 2026-01-01 09:00
status: inbox
source: <scène en une ligne, ex. "session claude-code : débogage du flux de paiement">
tags: [product, growth]
related: []
attachments: []
---

## Raw
- [2026-01-01 09:00] <les mots de l'utilisateur, textuellement>

## Contexte
- Scène : <où/quand cela est apparu>
- Déclencheur : <la remarque, la découverte ou le matériel exact qui a déclenché l'idée>
- Problème en cours : <sur quoi l'utilisateur travaillait à ce moment-là>
- Matériel associé : <chemins de fichiers, liens, données — tout ce qui est nécessaire pour revenir à la scène>

## Jugement principal
<la véritable affirmation de l'utilisateur, résumée en 1–2 phrases — un raisonnement complet, pas une paraphrase>

## Preuves
<données, cas ou observations à l'appui issues de la conversation>

## Développement
<2–4 directions : ce que cela pourrait devenir, contre quoi cela pourrait être testé, avec quoi cela se combine>

## Formats de contenu
<formats adaptés : essai / fil / décision produit / rétrospective / hypothèse d'expérience>

## Manquant
<ce qui est encore nécessaire avant que cette idée puisse être utilisée>

Statuts : inbox → structured → expandable → published / reusable / archived. (expandable = confirmé comme valant la peine d'être développé en contenu ; reusable = un bloc de construction intemporel.)

Principes

  1. Attraper d'abord, organiser ensuite. En recevant une idée, écrivez immédiatement la fiche avec la section Raw. Ne posez pas d'abord des questions de clarification, ne peaufinez pas le libellé d'abord.
  2. Raw est en ajout uniquement. La formulation originale — y compris les émotions, les hésitations, les imperfections — est un atout. Ne réécrivez jamais et ne supprimez jamais les entrées Raw ; ajoutez des suivis sous forme de nouvelles puces horodatées.
  3. Vous remplissez le contexte — ne demandez pas à l'utilisateur de le faire. Vous êtes au cœur de la scène où l'idée est née : de quoi parle la conversation, quel problème est ouvert, qu'est-ce qui a déclenché la pensée. Écrire cela dans Contexte est ce qui distingue ceci d'une application de notes.
  4. Écrivez dans la langue de l'idée. Les clés du frontmatter et les titres des sections restent en anglais, mais tout ce que vous écrivez — Contexte, Jugement principal, Développement, et vos confirmations à l'utilisateur — doit être dans la langue de l'entrée brute de l'utilisateur. Une idée chinoise donne une fiche en chinois ; une idée japonaise donne une fiche en japonais. Ne traduisez jamais la pensée de l'utilisateur en anglais pour la commodité du système.
  5. Confirmez légèrement. Après avoir structuré, rapportez l'id de la fiche et votre Jugement principal distillé en 2–3 lignes. Ne demandez pas à l'utilisateur de revoir toute la fiche.

Flux de capture (l'utilisateur dépose une idée)

  1. Vérifiez si cela étend une fiche existante : si l'utilisateur fait référence à une idée précédente ("ajoute à mon idée sur X") ou si la pensée continue clairement une fiche récente, ajoutez une puce horodatée à la section Raw de cette fiche et mettez à jour les sections structurées que l'ajout modifie — ne créez pas de fiche en double.
  2. Sinon, créez un nouveau fichier de fiche avec le frontmatter et l'entrée Raw textuelle. Textuel signifie : supprimez uniquement la directive de capture elle-même ("capture cette idée :", "note ceci :"), gardez chaque mot restant — y compris les hésitations, les émotions et les fautes de frappe. Statut : inbox.
  3. Remplissez les sections structurées à partir du contexte de la conversation : Contexte, Jugement principal, Preuves, Développement, Formats de contenu, Manquant. Laissez une section comme un espace réservé de commentaire HTML (<!-- -->) plutôt que d'inventer un contenu que vous n'avez pas.
  4. Passez le statut à structured et mettez à jour updated.
  5. Recherchez dans le pool (grep dans <pool>/**/*.md) les fiches connexes ; si trouvées, ajoutez les ids de chaque fiche dans les listes related des deux fiches.
  6. Synchronisez, puis confirmez légèrement.

Si l'utilisateur dépose un fragment et que vous n'avez vraiment aucun contexte (par exemple, la session vient de commencer) : créez d'abord la fiche, notez "contexte manquant" dans Contexte, puis posez au plus une question.

Flux de révision et de réutilisation

  • "Passe en revue ma boîte de réception" — listez les fiches avec status: inbox (les plus récentes en premier, affichez l'id + la première ligne Raw), puis structurez ou archivez-les une par une avec l'utilisateur.
  • "Trouve mes idées sur X" — cherchez dans le pool avec grep, lisez les fiches correspondantes, synthétisez ce que l'utilisateur a déjà conclu, et signalez proactivement les fiches qui pourraient se combiner.
  • "Transforme ceci en article / doc / décision" — lisez les fiches pertinentes, rédigez à partir de Jugement principal + Preuves (pas de Raw seul), et passez les fiches contributrices à published lorsque le résultat est livré.
  • Liaison — chaque fois que deux fiches partagent un thème, un cas ou une question produit, faites des références croisées via related.

Synchronisation

Si <pool>/.git existe, après chaque écriture :

git -C <pool> add -A && git -C <pool> commit -m "capture: <résumé en une ligne>" -q
git -C <pool> pull --rebase -q && git -C <pool> push -q

Ne bloquez jamais l'utilisateur sur des échecs de synchronisation — mentionnez-le en une ligne et passez à autre chose.

Skills associés