CommunityRédaction et éditiongithub.com

steffen74/savoirs-prealables

Règles pour définir la frontière des prérequis d'un cours – ce que les apprenants peuvent être supposés savoir et avoir à chaque étape, et comment distinguer une lacune d'une hypothèse raisonnable. À utiliser lors de la rédaction ou de la relecture d'instructions, de tâches, d'étapes de configuration ou de quiz destinés aux participants, ainsi que lorsqu'un apprenant rencontre un blocage.

Qu'est-ce que savoirs-prealables ?

Ce skill définit et applique le concept de « frontière des prérequis » dans un parcours d'apprentissage. Il permet aux IA agentiques (comme Claude Code, Cursor ou Codex) de vérifier automatiquement que chaque consigne, tâche ou quiz présenté à un apprenant se situe bien dans ce qui peut raisonnablement être supposé connu, possédé ou réalisable à ce stade du cours. Le skill distingue clairement les lacunes (éléments en dehors de la frontière) des hypothèses valides. Il couvre non seulement les concepts, mais aussi les comptes, abonnements, logiciels installés, actions effectuées (cloner, fork, uv sync), emplacements de fichiers ou de dépôts, et conventions d'utilisation. Utile pour les formateurs, rédacteurs de documentation et agents d'assistance, il permet d'éviter les incompréhensions en définissant des règles précises (comme l'origine de chaque artefact, la prise en compte des outils automatisés ou des différences entre profils d'apprenants). Il fournit également des signaux d'alerte (questions identiques, attentes avant démarrage, livrables manquants) et peut déclencher le chargement de vérifications automatiques via le skill `course-checks`. Compatible avec les agents de développement et les assistants d'apprentissage.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steffen74/agentic-course-creation/tree/HEAD/skills/assumed-knowledge

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · 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

Savoirs préalables

La frontière représente ce qu'un apprenant peut être supposé savoir, posséder et être capable de faire à un moment donné du cours. Le bloc 6 du Canvas la définit pour le début du cours ; le contenu de chaque unité l'étend. Chaque étape demandée à l'apprenant doit se situer à l'intérieur de cette frontière à ce moment. Une étape en dehors constitue une lacune : l'apprenant bloque, devine ou demande de l'aide.

Ce que couvre la frontière

Pas seulement les concepts. Les lacunes proviennent au moins aussi souvent de :

  • Ce qu'ils possèdent : comptes, abonnements, logiciels installés, droits d'administration, un ordinateur personnel, un dépôt qui leur appartient.
  • Ce qu'ils ont fait : un clone, un fork, un uv sync, avoir rejoint un salon de discussion, accepté une invitation.
  • Où se trouvent les choses : quel dépôt, quel dossier, quel lien. « Votre clone du dépôt modèle » suppose qu'ils en ont créé un.
  • Conventions : ce qu'est une invite de commande, ce que signifie « exécuter » dans un notebook, que /commande est tapé dans l'agent.

Règles

  • La frontière est une décision du formateur. Lorsqu'il n'est pas clair si quelque chose peut être supposé, demandez ; ne décidez pas.
  • Quelque chose devient connu seulement lorsque le contenu l'a enseigné avant son utilisation, ou a demandé aux apprenants de le faire avec des instructions qu'ils pouvaient suivre. Être présent dans une vidéo listée pour la même unité compte uniquement si la vidéo précède la tâche.
  • Un outil qui fait l'action à la place de l'apprenant (un agent, un script d'installation) compte uniquement si l'apprenant est invité à l'utiliser à cette étape, avec l'invite ou la commande exacte.
  • Chaque artefact sur lequel une étape s'appuie nécessite une origine : une étape qui l'a créé, ou un lien vers son emplacement.
  • Le contenu optionnel n'étend jamais la frontière.
  • Lorsque deux profils d'apprenants diffèrent, la frontière suit le plus faible, sauf si le bloc 6 les exclut explicitement.

Lacunes typiques

  • Une instruction fait référence à un objet (dépôt, fichier, salon, compte) dont l'étape de création est manquante ou seulement implicite.
  • Deux pages nomment des dépôts ou dossiers différents pour la même étape.
  • Une commande ne fonctionne que depuis un dossier spécifique, et la page ne précise pas lequel.
  • Un outil dont dépend l'étape est gratuit dans un plan et payant dans un autre ; la page suppose le plan payant.
  • Une tâche nécessite un concept prévu pour une unité ultérieure.

Signaux d'alerte en classe

Les mêmes questions de la part de plusieurs apprenants ; des apprenants qui attendent le formateur avant de pouvoir commencer ; un livrable manquant pour tout un groupe. Traitez chacun comme une violation de la frontière jusqu'à preuve du contraire, et chargez course-checks pour en faire une vérification automatisée.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés