Le chemin IA — Construire un acteur avec /create-actor

](fr/track-a/setup-and-generate/) fait de vous le pilote : vous répondez aux questions de copier, vous écrivez le code de domaine. Le chemin IA répartit le travail autrement — un skill mène avec vous une conversation de découverte structurée, puis génère l’acteur et implémente le code de domaine. Vous apportez la connaissance du domaine et le jugement ; il apporte la connaissance du template et la saisie.

Le skill est /create-actor (SKILL.md). Il est livré dans le dépôt kaboum, et sa règle fondamentale est que le template kaboum est l’unique source de vérité : il relit les fichiers du template à chaque exécution et ne copie jamais de motifs d’acteurs générés précédemment, parce que ceux-ci prennent du retard sur le template.

Ce chemin est pour vous si vous pouvez tenir une conversation précise sur votre domaine mais ne voulez pas écrire à la main Python, le code client et les migrations.

Prérequis

Claude Code. Le skill pilote en son sein un flux interactif de questions-réponses.
Accès au dépôt kaboum. Le skill vit dans .claude/skills/create-actor/ de kaboum et lit le template depuis ce checkout. Il vous faut un checkout sur lequel pointer Claude Code.
Un environnement de vérification. Le skill vérifie son propre travail, il lui faut donc : Python 3.11–3.13 avec copier 9.4.0 ou plus récent (les minimums revendiqués plus anciens ne s’installent en réalité pas sur les Python modernes), ruff, et la pile de tests de l’acteur — pytest, avec Docker disponible pour que PostgreSQL et Redis puissent être démarrés pour les tests qui en ont besoin.
Rien de Kaoohi pour l’instant. Un compte Kaoohi ne vous sert qu’au moment de la publication, dans le Creator Hub.

Les six phases

Phase 1 — Découverte du domaine

Le skill pose des questions structurées en trois séries groupées : identité et domaine d’abord ; puis capacités, framework d’agent, interrupteurs d’intelligence, connecteurs et serveurs MCP ; enfin une plongée ouverte sur la façon dont l’acteur doit concrètement se comporter. Répondez avec vos mots — cette conversation est la matière première de tout ce qui suit.

Phase 2 — Le document de découverte

Le skill écrit documentation/discovery.md dans votre nouveau projet d’acteur : identité, choix d’intégration, serveurs MCP, outils, modèle de données, comportement de l’acteur, configuration et variables de template résolues. Lisez-le. Si quelque chose cloche, dites-le maintenant — c’est bon marché à corriger ici et coûteux plus tard.

Phase 3 — Génération du scaffolding

Le skill rend le projet depuis le template Copier kaboum épinglé au commit exact de votre checkout — un instantané reproductible, pour que votre acteur puisse suivre proprement plus tard les mises à jour du template. Le scaffolding neuf est ensuite nettoyé avec ruff avant tout code de domaine.

Phase 4 — Implémentation du code de domaine

C’est la partie que Track A fait à la main. Le skill implémente le vrai code de domaine en suivant les conventions du template :

Les modèles de domaine et le client de domaine.
Les outils LangChain, enregistrés proprement dans le registre d’outils.
Le prompt système ROLE_PLAYBOOK. Les prompts possédés par le template ne sont jamais édités ; les phrases qui comptent sont épinglées dans un test de prompt système, pour que les mises à jour ultérieures du template ne puissent pas faire dériver silencieusement le comportement de votre acteur.
Un test de frontières de capacité qui encode ce que l’acteur doit et ne doit pas faire.
Des champs de configuration annotés x-kaoohi-* — ils pilotent le formulaire de réglages du marketplace et les métadonnées de l’acteur.
Les métadonnées marketplace, les déclarations de sécurité et de sortie réseau dans pyproject.
Les migrations de base de données, numérotées à partir de 004_ (les trois premières appartiennent au template), avec une garde contre l’exposition de colonnes sensibles.
.env.example avec des valeurs placeholder, et le câblage de MCP_SERVERS_JSON si votre découverte demandait des outils MCP.

Phase 5 — Vérification

Le skill vérifie avant de rendre la main : ruff doit passer propre, le fichier dérivé src/kaoohi/config.json doit être régénéré et contrôlé en fraîcheur (il est émis depuis vos champs de configuration — l’éditer à la main est interdit, et un fichier mal formé fait échouer le build d’image plus tard), et la suite de tests doit être verte. Le fichier de configuration rafraîchi est commité avec le code qui l’a produit.

Phase 6 — Résumé et conseils de publication

Vous obtenez un résumé : quels fichiers ont été écrits, les résultats de tests, quelles valeurs restent des placeholders (des identifiants, surtout), et comment exécuter et publier l’acteur.

Ce qui reste à votre charge

Répondre honnêtement à la découverte. L’acteur n’est meilleur que vos réponses. Des réponses vagues produisent un acteur vague.
Les vrais identifiants. Le skill écrit des placeholders. Les vrais secrets sont à fournir à l’exécution — jamais commités dans le dépôt.
Le polissage marketplace. Nom d’affichage, description, catégorie, modèle tarifaire : l’identité commerciale de l’acteur est votre décision, pas celle du skill.
La publication. C’est vous qui faites l’enregistrement et la soumission dans le Creator Hub.

Publier après le skill

L’acteur est du code tant que vous n’en faites pas un produit : construisez l’image (sa configuration cuite dedans), poussez-la vers un registre public comme GHCR, puis enregistrez-la dans le Creator Hub. L’enregistrement prend la référence d’image, pas une configuration collée — la plateforme tire l’image et extrait la configuration elle-même. Vous prévisualisez, ajustez nom, description, catégorie, étiquettes et tarification, puis vous enregistrez comme brouillon ou soumettez à la revue. Le parcours complet, versionnement et étiquetage de l’image compris, est dans ](fr/publishing/) ; avant de soumettre, testez le brouillon dans le ](fr/track-b/sandbox/).

Comment l’invoquer

Ouvrez Claude Code là où il peut lire votre checkout kaboum, et tapez :

/create-actor

Puis répondez aux questions au fil de leur venue.

Conseils pour de bonnes réponses de découverte

Arrivez avec une intention en une phrase. « Un acteur de réception d’hôtel qui répond aux questions de réservation et crée des tickets de ménage » vaut mieux que « un assistant pour hôtels ».
Nommez les services externes, et ce que l’acteur en fait. Lire, écrire, ou les deux ? Quelles actions sont dangereuses et doivent être refusées ?
Décrivez les entités de données comme à un nouveau collègue : une réservation a un invité, des dates, une chambre, un statut.
Dans la ronde ouverte, parcourez une histoire utilisateur réelle de bout en bout. C’est là que le skill capte le comportement que les cases à cocher ne peuvent pas exprimer.
Traitez les valeurs par défaut avec intention. Le fan-out de sous-agents est l’interrupteur d’intelligence le plus coûteux ; la planification et la summarization sont actives par défaut. Dites-le si vous les voulez désactivées.
Choisissez le nom du module de domaine avec soin — les noms réservés sont rejetés, et il devient un répertoire et un chemin d’import que vous habiterez.
En cas de doute sur les connecteurs, dites aucun. Les serveurs MCP peuvent être ajoutés plus tard sans changement de code.

Où aller ensuite

Testez votre brouillon dans le ](fr/track-b/sandbox/) avant de soumettre.
Vous voulez comprendre ce que le skill a construit ? Les points d’extension qu’il a remplis sont les mêmes que ceux qu’enseigne le ](fr/track-a/extension-points/).
kaboum guide de développement et d’extension — les modes opératoires derrière chaque fichier que le skill écrit.