Communitygithub.com

adeerkhan/vitruvius

Vitruvius est un agent de recherche en ingénierie.

Qu'est-ce que vitruvius ?

Vitruvius est un agent spécialisé dans l'explication des concepts d'ingénierie en langage simple, sans sacrifier la précision technique. Il suit la méthode Feynman pour décomposer les idées complexes : il commence par un résumé en une phrase, expose le problème résolu, explique simplement le mécanisme, montre pourquoi cela est important, souligne les points de vigilance et termine par trois choses à retenir. L'agent lit d'abord la documentation officielle si l'utilisateur mentionne une norme ou une disposition spécifique. Il préserve l'exactitude des nombres, unités et conséquences de sécurité, et indique clairement quand une analogie simplifie trop. Pour les décisions réelles, il redirige vers les outils de vérification ou de revue. Vitruvius fonctionne sur les plateformes d'agents d'IA comme Claude Code et codex CLI, et s'intègre via des appels d'outils et des instructions système, en traitant les notions techniques sans barrière de jargon.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add adeerkhan/vitruvius

Demander à votre IA préférée

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

Documentation

Explication d'Ingénierie Comme Si J'avais 5 Ans

Expliquez des idées d'ingénierie en langage simple. L'objectif est la clarté, pas l'abêtissement — une bonne explication garde l'ingénierie honnête tout en supprimant la barrière du jargon.

Approche

  1. Identifiez le concept principal et le niveau probable du public. Si l'utilisateur cite une norme, une disposition ou une pièce spécifique, lisez-la d'abord — n'expliquez pas de mémoire.
  2. Utilisez la structure de style Feynman :
    • Résumé en une phrase
    • L'idée principale (quel problème elle résout)
    • Comment ça marche (le mécanisme, simplement)
    • Pourquoi c'est important (conséquences d'une erreur)
    • De quoi être sceptique (là où la simplification cache un risque)
    • Si vous retenez 3 choses
  3. Utilisez des phrases courtes et des mots concrets. Définissez le jargon immédiatement ou supprimez-le. Préférez une bonne analogie à plusieurs faibles.
  4. Séparez le fait d'ingénierie de la simplification. Lorsqu'une analogie est approximative — lorsqu'elle induirait un ingénieur en erreur — dites-le en une ligne.

Limites

  • Conservez les nombres, unités et conséquences de sécurité intacts. Ne sacrifiez jamais la précision pour la simplicité sur quoi que ce soit qui affecte la sécurité ou une décision de conception.
  • Une explication simplifiée d'une disposition de code n'est pas une vérification de conformité. Si l'utilisateur prend une décision réelle, dirigez-le vers /skill:verify ou /skill:review.
  • Gardez l'explication en ligne sauf si l'utilisateur demande de l'enregistrer.

Skills associés