add-endpoint
Ajouter des endpoints HTTP Catalyst Relay
L’ajout d’endpoints peut devenir incohérent lorsque les fichiers de routes, la validation, les handlers et la documentation suivent des modèles différents. Cette skill fournit à Claude, Codex et Claude Code une checklist Catalyst-Relay claire pour un travail cohérent sur les endpoints HTTP.
Télécharger le ZIP du skill
Importer dans Claude
Allez dans Paramètres → Capacités → Skills → Importer un skill
Activez et commencez à utiliser
Ressources lisibles par les agents
Utilisez ces liens lorsqu'un AI Agent, un crawler ou un script a besoin d'un contexte propre au lieu de lire toute la page.
Tester
Utilisation de "add-endpoint". Ajouter un endpoint de connexion à Catalyst-Relay.
Résultat attendu:
- Un plan de fichier de route pour la catégorie auth.
- Une checklist de validation de requête et de typage de réponse.
- Une étape d’enregistrement de route pour l’application Hono.
- Des éléments de documentation pour la page d’endpoint auth.
Utilisation de "add-endpoint". Documenter un endpoint de liste de packages.
Résultat attendu:
- Un plan de documentation avec des tableaux de requête et de réponse.
- Une liste de cas d’utilisation pour la découverte de packages.
- Une note d’utilisation de la bibliothèque pour la méthode client correspondante.
Audit de sécurité
Risque faibleStatic analysis flagged Markdown backticks, relative import examples, and documentation text as command execution, path traversal, weak crypto, and reconnaissance. Review found only instructional TypeScript examples and endpoint documentation guidance, with no executable skill code, network access, secret handling, or prompt injection attempts.
Problèmes à risque faible (1)
Facteurs de risque
⚙️ Commandes externes (8)
📁 Accès au système de fichiers (4)
Score de qualité
Ce que vous pouvez construire
Ajouter une nouvelle route API
Créer un fichier de route avec validation, typage de réponse et un handler Hono conforme aux conventions Catalyst-Relay.
Standardiser la documentation des endpoints
Produire une documentation d’endpoint avec des tableaux de requête, des tableaux de réponse, des exemples, des erreurs, des cas d’utilisation et des notes d’utilisation de la bibliothèque.
Exposer les fonctionnalités principales via HTTP
Connecter une fonctionnalité principale à un endpoint HTTP et ajouter une méthode ADTClient correspondante lorsque le mode bibliothèque en a besoin.
Essayez ces prompts
Utilise la skill add-endpoint pour ajouter un endpoint Catalyst-Relay simple pour [feature]. Inclue le fichier de route, la validation de requête, le type de réponse et les étapes d’enregistrement de route.
Utilise la skill add-endpoint pour concevoir un endpoint pour [operation]. Suis le modèle standard de schéma Zod et l’enveloppe de réponse de succès ou d’erreur.
Utilise la skill add-endpoint pour créer la documentation de [endpoint]. Inclue les détails de la requête, les champs du body, les champs de réponse, les erreurs, les cas d’utilisation et l’utilisation de la bibliothèque.
Utilise la skill add-endpoint pour ajouter [endpoint] et l’associer à une méthode ADTClient. Assure-toi que le câblage des routes, la validation, le format de réponse, la documentation et les consignes de typecheck sont couverts.
Bonnes pratiques
- Conserver chaque endpoint dans son propre fichier de route avec le schéma, les types et le handler colocalisés.
- Utiliser l’enveloppe de réponse standard pour les cas de succès comme d’erreur.
- Mettre à jour l’enregistrement des routes, la documentation et les mappings ADTClient dans le même changement lorsque cela s’applique.
Éviter
- Ne pas ajouter de handlers sans validation de requête Zod.
- Ne pas renvoyer des formes de réponse ad hoc qui contournent l’enveloppe de succès et d’erreur.
- Ne pas reporter la documentation des endpoints ou les mappings client à un changement ultérieur sans rapport.