FeixueCode/concept-forge

Compétence universelle pour agents IA : transforme les questions jetées sur des concepts, termes et « différence entre X et Y » en une réponse concise, un brouillon de connaissance Quarkdown, une page HTML interactive et une présentation Slidev, le tout stocké dans une base de connaissances personnelle réutilisable. Compatible avec Codex / Claude Code / Miaoclaw et autres assistants supportant SKILL.md, utilisable aussi en ligne de commande.

Qu'est-ce que concept-forge ?

Cette compétence pour agent IA (compatible avec Codex, Claude Code, Miaoclaw, etc.) transforme des questions posées à la volée sur des concepts, termes ou comparaisons en un véritable actif de connaissance durable. Elle produit systématiquement une réponse courte et immédiate, une fiche de connaissance structurée en JSON, un brouillon de lecture Quarkdown (concept.qd), une présentation Slidev (slides.md) et une page HTML interactive autonome, le tout organisé dans un espace de travail local. Le flux en 10 étapes suit un ordre précis : normalisation de la question, recherche d’entrées existantes, planification de la profondeur (rapide, standard, profonde), recherche ciblée via le prisme conceptuel (une grille d’analyse légère inspirée de hv-analysis), création ou mise à jour de la fiche, rendu des artefacts, validation, et rapport final. L’utilisateur reçoit toujours d’abord la réponse en chinois, puis le chemin vers la page HTML interactive ; les aspects techniques (compilation Quarkdown, export Slidev) ne sont dévoilés que sur demande explicite ou entrée dans une branche formelle (lecture formelle, présentation formelle). La compétence gère trois branches produit distinctes (concept normal, lecture formelle, présentation formelle) et exécute des commandes CLI dédiées (scripts/concept_forge.py) pour l’initialisation, la recherche, la mise à jour, la validation, le bootstrap et le diagnostic. Son objectif ultime est de constituer, à chaque interaction, une bibliothèque de connaissances HTML/Quarkdown locale, réutilisable et facile à mémoriser.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add FeixueCode/concept-forge

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

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

Documentation

Concept Forge

Concept Forge transforme les questions éparses d'un utilisateur en un actif de connaissance durable : une réponse concise, une fiche de connaissance structurée, un brouillon de lecture Quarkdown, un brouillon de présentation Slidev et un explicateur HTML interactif autonome.

L'objectif n'est pas de produire une réponse unique. L'objectif est de rendre le concept plus facile à mémoriser et de constituer progressivement une bibliothèque locale de connaissances/HTML réutilisable.

Boucle principale

Suivez toujours cet ordre :

  1. Normaliser la question : identifier le concept central, les alias, les cibles de comparaison et l'intention de l'utilisateur.
  2. Rechercher d'abord les entrées existantes avec scripts/concept_forge.py lookup.
  3. Planifier la profondeur avec scripts/concept_forge.py plan ou la méthode de recherche : choisir Rapide, Standard ou Profonde.
  4. Réutiliser avant de reconstruire : si une correspondance forte existe, retourner la réponse directe et le chemin HTML existants. Actualiser uniquement si l'utilisateur le demande, si l'entrée est obsolète ou si le concept est sensible au facteur temps.
  5. Rechercher à la profondeur choisie si aucune entrée utilisable n'existe : utiliser le prisme conceptuel ci-dessous, en naviguant si le sujet a pu changer ou si des sources précises sont nécessaires.
  6. Forger l'enregistrement du concept en JSON structuré selon references/concept-schema.md.
  7. Rendre et stocker avec scripts/concept_forge.py upsert ; cela doit créer les artefacts JSON, Quarkdown, Markdown, HTML et Slidev.
  8. Vérifier la branche de livraison avec scripts/concept_forge.py bootstrap "<requête originale>" si l'utilisateur a demandé une lecture formelle, un PDF, des slides, un exposé, un aperçu, une construction ou une exportation.
  9. Valider l'entrée stockée et les artefacts générés avec scripts/concept_forge.py validate.
  10. Rapporter en chinois : donner toujours la réponse en premier, puis le chemin HTML local. Éviter les détails d'implémentation sauf demande explicite.

Structure de la réponse à l'utilisateur

Chaque requête terminée doit retourner deux choses, dans cet ordre :

  1. Réponse directe : 1 à 3 courtes phrases en chinois répondant immédiatement à la question de l'utilisateur. Privilégier une analogie vivante lorsque cela aide la mémorisation. Cela doit se suffire à lui-même pour les utilisateurs qui n'ont pas le temps d'ouvrir le HTML.
  2. HTML interactif : un chemin local ou un lien vers l'explicateur HTML généré/réutilisé.

Utiliser une forme compacte comme :

一句话说,Skill 像给 AI 准备的一本小手册:Prompt 是这次怎么做,Skill 是以后遇到同类任务都按这套做。

互动页:<path/to/html>

Ne pas obliger l'utilisateur à ouvrir le HTML pour obtenir la réponse de base.

Espace de travail

Espace de travail par défaut :

<répertoire de travail courant>/concept-forge-workspace

Si l'utilisateur nomme un autre emplacement de stockage, utiliser celui-ci. Initialiser avant la première utilisation :

python <skill>/scripts/concept_forge.py init --workspace <workspace>

L'espace de travail contient :

knowledge/index.json
knowledge/concepts/<slug>/concept.json
knowledge/concepts/<slug>/concept.qd
knowledge/concepts/<slug>/concept.md
knowledge/concepts/<slug>/sources.json
html/<slug>.html
slidev/<slug>/slides.md
slidev/<slug>/package.json
quarkdown/
assets/
config.json

Prisme conceptuel

Emprunter l'esprit de hv-analysis, mais le garder léger et adapté à la taille d'un concept.

Pour chaque concept nouveau ou actualisé, répondre à ces couches :

  • Mémoire en une ligne : la définition la plus courte et utile.
  • Réponse directe : une explication prête pour la discussion, généralement un court paragraphe, éventuellement avec une métaphore.
  • Ce que c'est : explication en langage simple.
  • Pourquoi ça existe : quel problème, quelle confusion, quel workflow ou quel changement historique a créé le besoin.
  • Comment ça marche : le mécanisme minimum nécessaire à la compréhension.
  • Ce que ce n'est pas : idées reçues courantes et limites.
  • Comparaison horizontale : concepts, outils, prompts, workflows ou termes proches souvent confondus.
  • Carte des relations : concepts parents, concepts frères, concepts enfants, prérequis et questions suivantes.
  • Exemple : un scénario concret du quotidien.
  • Accroche mémoire : métaphore, phrase ou ancrage visuel qui fait adhérer le concept.
  • Mini quiz : 2 à 3 questions légères pour renforcer la mémorisation.

Utiliser la recherche web lorsque les faits peuvent être actuels, de niche, controversés, spécifiques à un produit ou sensibles en termes de sources. Privilégier la documentation officielle et les sources primaires. Sinon, marquer les sources comme « dérivé du modèle / fourni par l'utilisateur / contexte local » honnêtement dans l'enregistrement.

Modes de sortie

Sélection de branche

Il existe trois branches produit. Les distinguer précisément.

  1. Branche concept normal : l'utilisateur demande « X 是什么 », « X 和 Y 有什么区别 », « aide-moi à comprendre/mémoriser/organiser ce concept », ou donne un mot-clé. Générer la réponse directe, la source Quarkdown, la source Slidev, le HTML et l'index. Ne pas demander l'installation de Quarkdown ou Slidev.
  2. Branche lecture formelle : l'utilisateur demande « 正式阅读 » (lecture formelle), « 长文档 » (document long), « 报告 » (rapport), « PDF », « 文档 » (document), « 打印 » (impression), « 编译 » (compilation), « 导出 » (exportation), « 交付 » (livraison), ou nomme explicitement Quarkdown. Exécuter bootstrap avant la compilation. Si Quarkdown est manquant, s'arrêter avant la compilation/exportation et afficher les instructions d'installation.
  3. Branche présentation formelle : l'utilisateur demande « 演示 » (démonstration), « 公开讲解 » (exposé public), « 课件 » (support de cours), « 幻灯片 » (diapositives), « PPT », « slides », « deck », « presentation », « 预览 » (aperçu), « 构建 » (construction), « 导出 » (exportation), ou nomme explicitement Slidev. Exécuter bootstrap avant l'aperçu/la construction/l'exportation. Si Node/npm ou les dépendances du projet Slidev sont manquants, s'arrêter avant l'aperçu/la construction/l'exportation et afficher les instructions de configuration.

Si l'utilisateur demande à la fois lecture et présentation, utiliser Quarkdown comme brouillon mère et Slidev comme brouillon d'exposé dérivé, puis vérifier les deux branches.

Commandes d'aide aux branches :

python <skill>/scripts/concept_forge.py --workspace <workspace> plan "<requête originale>"
python <skill>/scripts/concept_forge.py --workspace <workspace> bootstrap "<requête originale>"
python <skill>/scripts/concept_forge.py --workspace <workspace> bootstrap --intent quarkdown
python <skill>/scripts/concept_forge.py --workspace <workspace> bootstrap --intent slidev
python <skill>/scripts/concept_forge.py --workspace <workspace> bootstrap --intent all

Entrée existante

Si la recherche trouve une entrée existante forte :

  • Dire qu'elle existe déjà.
  • Donner la réponse courte de direct_answer si présente, sinon utiliser summary plus memory_hook.
  • Lier la page HTML locale.
  • Proposer ce qui peut être actualisé seulement si utile ; ne pas reconstruire par défaut.

Nouvelle entrée

Pour un nouveau concept :

  1. Créer un enregistrement JSON suivant references/concept-schema.md.
  2. Inclure au moins : titre, alias, profondeur, réponse directe, résumé, quoi, pourquoi, pas, comparaisons, relations, accroche mémoire, quiz, sources.
  3. Exécuter :
python <skill>/scripts/concept_forge.py upsert --workspace <workspace> --input <concept.json>
python <skill>/scripts/concept_forge.py validate --workspace <workspace> --slug <slug>
  1. Retourner d'abord la réponse directe, puis le chemin HTML généré. Mentionner les chemins Quarkdown ou Slidev uniquement lorsque l'utilisateur demande des fichiers, des brouillons de lecture, des exposés, des exportations ou du débogage.

Actualisation

Actualiser uniquement lorsque :

  • l'utilisateur demande de mettre à jour / refaire / développer ;
  • l'âge de l'entrée dépasse refresh_policy.days ;
  • le sujet est actuel ou évolue rapidement ;
  • les sources sont faibles ou manquantes ;
  • l'utilisateur pose une question de suivi plus spécifique qui modifie les limites du concept.

Lors de l'actualisation, préserver les alias existants et les liens connexes, sauf s'ils sont clairement erronés.

Exigences HTML

Utiliser references/html-explainer.md pour la forme exacte du produit.

La page générée doit être autonome et doit inclure :

  • une définition héros ;
  • les sections « quoi / pourquoi / pas » ;
  • des fiches de comparaison ;
  • une carte des concepts connexes ;
  • une frise chronologique ou une bande d'origine lorsque utile ;
  • des fiches de révélation interactives ;
  • un mini quiz ;
  • « trois choses à retenir » ;
  • un pied de page avec les sources et la date de mise à jour.

La page doit être compréhensible sans la transcription de la discussion.

Quarkdown et Slidev de première classe

Quarkdown et Slidev font partie de la forme du produit.

  • Toujours générer concept.qd comme brouillon mère Quarkdown. C'est le document de lecture canonique de la base de connaissances.
  • Toujours générer slidev/<slug>/slides.md comme brouillon de présentation. Il est extrait de l'enregistrement du concept et du brouillon mère.
  • Toujours générer html/<slug>.html comme surface de mémoire interactive rapide.
  • Utiliser la profondeur dynamique pour décider de la quantité de recherche, de sourçage et de polissage à ajouter :
    • Rapide : concept stable et petit ; générer tous les artefacts source, normalement sauter la compilation/exportation.
    • Standard : par défaut pour les outils, méthodes, comparaisons et « qu'est-ce que X » ; générer tous les artefacts et vérifier la structure.
    • Profonde : l'utilisateur demande une recherche ou le sujet est actuel/complexe ; renforcer les sources, l'historique, la comparaison horizontale et la structure de l'exposé.
  • Compiler Quarkdown ou construire/exporter Slidev uniquement lorsque la requête entre dans une branche formelle. La génération des sources ne doit pas dépendre de l'installation des CLI.
  • Utiliser scripts/concept_forge.py doctor lors de la première utilisation pour une vérification générale de l'environnement.
  • Utiliser scripts/concept_forge.py bootstrap "<requête originale>" avant la compilation/exportation formelle pour décider s'il faut guider l'installation.
  • Pour la lecture formelle Quarkdown, nécessite quarkdown. Si manquant sur Windows, afficher : irm https://raw.githubusercontent.com/quarkdown-labs/get-quarkdown/refs/heads/main/install.ps1 | iex, puis vérifier avec quarkdown doctor get install-dir.
  • Pour la compilation Quarkdown, exécuter quarkdown c <concept.qd> --strict --out <verify-dir> lorsque quarkdown est disponible.
  • Pour la présentation formelle Slidev, nécessite Node avec npm ou pnpm. Dans slidev/<slug>, exécuter npm install ou pnpm install, puis npm run dev, npm run build ou npm run export selon les besoins.
  • Pour l'exportation PDF/PPTX de Slidev, installer playwright-chromium dans le projet de slides généré d'abord : npm i -D playwright-chromium.

Porte qualité

Avant de signaler l'achèvement, vérifier :

  • une recherche a été tentée avant la création ;
  • la réponse finale contient à la fois une réponse directe et un chemin HTML ;
  • le concept a une mémoire en une ligne claire ;
  • les concepts connexes et les idées reçues sont couverts ;
  • le HTML existe et n'est pas vide ;
  • le brouillon mère Quarkdown existe ;
  • la source Slidev existe ;
  • les branches formelles ont exécuté bootstrap avant la compilation/exportation ;
  • les outils formels manquants ont été signalés avant de tenter la compilation/exportation ;
  • validate réussit ;
  • l'index contient le titre, les alias, le slug, la réponse directe, le résumé, le chemin Quarkdown, le chemin Slidev et le chemin HTML ;
  • la réponse finale est courte, en chinois et destinée à l'utilisateur.

Références

  • references/concept-schema.md : forme de l'enregistrement JSON et Markdown.
  • references/research-method.md : adaptation légère de hv-analysis.
  • references/html-explainer.md : spécification du produit HTML interactif.

Skills associés