DOCUMENTATION PUBLIQUE

plugin-kit-ai

Travaillez dans un seul dépôt, commencez par Go par défaut, puis ajoutez plus tard des packages, des hooks Claude, Gemini ou une configuration d'intégration gérée par le dépôt sans scinder le projet.

Démarrage par défaut

• Codex runtime Go est le démarrage par défaut lorsque vous souhaitez l'histoire d'exécution et de version la plus solide.

Ce qu'il faut savoir immédiatement

• un dépôt reste la source de vérité à mesure que vous ajoutez plus de voies
• choisissez le chemin de départ qui correspond à ce dont vous avez besoin aujourd'hui
• développer plus tard à partir du même référentiel lorsque le produit a besoin de plus de sorties
• utilisez generate et validate --strict comme flux de travail de préparation partagé

Chemins Node et Python pris en charge

• codex-runtime --runtime node --typescript est le principal chemin non-Go pris en charge.
• codex-runtime --runtime python est le premier chemin Python pris en charge.
• les deux sont des chemins d'exécution interprétés localement, donc la machine cible a toujours besoin de Node.js 20+ ou Python 3.10+.
• ce sont des options précoces claires pour les équipes travaillant déjà dans ces piles, mais ce ne sont pas le départ par défaut.

Démarrage rapide

Utilisez d'abord le chemin par défaut le plus fort, puis développez-le uniquement lorsque le produit a besoin de plus de sorties.

Voir la forme du produit

Découvrez comment un référentiel se transforme en configuration d'exécution, de package, d'extension et d'intégration appartenant au référentiel.

Choisissez une cible

Faites correspondre la cible à la manière dont vous souhaitez expédier le plugin au lieu de traiter chaque sortie comme la même chose.

Vérifiez le contrat exact

Utilisez les pages de référence lorsque vous avez besoin des limites précises du support et des conditions de compatibilité.

Si vous en avez besoin plus tard

• Ajoutez Claude default lane lorsque les crochets Claude sont l'exigence du produit.
• Ajoutez Codex package ou Gemini packaging lorsque le produit est une sortie de package ou d'extension.
• Ajoutez OpenCode ou Cursor lorsque le dépôt doit posséder la configuration d'intégration.
• Utilisez validate --strict comme porte de préparation avant le transfert ou le CI.

Chemins d'extension courants

• Commencez avec un référentiel d'exécution Codex, puis ajoutez le package Codex ou Gemini lorsque l'emballage fait partie du produit.
• Commencez par Claude lorsque les hooks Claude sont le produit, puis gardez le dépôt ouvert pour des voies de livraison plus larges plus tard. - Démarrez sur Node ou Python localement, puis ajoutez un transfert de bundle lorsque la livraison en aval est importante.
• Ajoutez OpenCode ou Cursor lorsque le dépôt doit gérer la configuration d'intégration, pas seulement le comportement de l'exécutable.

Lire dans cet ordre

1. Démarrage rapide

Commencez par un chemin recommandé avant de penser à l'expansion.

2. Ce que vous pouvez construire

Voir la forme du produit à travers les voies d'exécution, de package, d'extension et d'intégration.

3. Choisissez une cible

Choisissez la cible qui correspond à la manière dont vous souhaitez réellement expédier le plugin.

4. Limite de support

Utilisez le cluster de référence lorsque vous avez besoin d'un langage de compatibilité exact et de détails de support.

Si vous êtes nouveau, arrêtez-vous après ces quatre pages. Tout le reste est une référence plus profonde ou des détails de mise en œuvre.

Base de référence actuelle du dépôt

• La référence publique actuelle dans cet ensemble de documents est v1.0.6.
• Cette version a fait de la livraison partagée des packages d'exécution pour Python et Node une histoire entièrement prise en charge.
• Commencez par là lorsque vous souhaitez connaître la ligne de base recommandée actuelle.

Ce que ce site vous aide à faire- démarrer un dépôt de plugin au lieu de diviser la source de vérité par écosystème

• choisissez un chemin de départ recommandé sans apprendre tous les détails de la cible à l'avance
• étendre le même dépôt plus tard dans plus de chemins d'expédition
• conserver une histoire de révision et de validation à mesure que le dépôt se développe
• trouvez le contrat exact uniquement lorsque vous en avez besoin