add-core-function
Ajouter des fonctions cœur à Catalyst-Relay
Les changements cœur nécessitent des fichiers, imports, retours et exports cohérents. Cette skill guide les ajouts de logique métier Catalyst-Relay avec des modèles typés et des checklists.
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-core-function". Add a getPackages discovery operation for ADT.
Résultat attendu:
- Emplacement de fichier recommandé sous le dossier de découverte ADT.
- Définition du type de package public près de la fonction.
- Convention de retour AsyncResult avec gestion des erreurs du requestor.
- Conseils de barrel export pour l'API publique ADT.
Utilisation de "add-core-function". Review my plan for a new create operation.
Résultat attendu:
- Vérifie que la fonction appartient au dossier CRAUD.
- Signale la logique de helper qui devrait être déplacée dans helpers.ts.
- Confirme que les types partagés doivent venir de types.ts.
- Rappelle à l'utilisateur d'exécuter la vérification des types du projet.
Audit de sécurité
SûrThe static analyzer flagged Markdown backticks, relative TypeScript import examples, and the word description as security patterns. Manual review found no executable shell commands, no path traversal behavior, no weak cryptography, no network exfiltration, and no prompt injection attempts.
Problèmes à risque faible (3)
Score de qualité
Ce que vous pouvez construire
Ajouter une opération ADT
Créer une nouvelle fonction de découverte, prévisualisation, lecture ou création qui respecte les conventions cœur de Catalyst-Relay.
Standardiser les exports publics
Placer une nouvelle fonction cœur dans le bon dossier et l'exposer via le bon barrel export.
Former un contributeur
Apprendre à un contributeur comment organiser les fichiers cœur, helpers, types de retour et chemins d'import.
Essayez ces prompts
Use add-core-function to add a pure core function for [domain]. Name it [function] and explain each file change.
Use add-core-function to design a new ADT discovery operation named [operation]. Include file placement, return type, helper usage, and export guidance.
Use add-core-function to review this implementation plan: [plan]. Check file location, imports, AsyncResult use, helper placement, and barrel exports.
Use add-core-function to refactor these proposed core API changes: [changes]. Identify circular dependency risks, public API boundaries, and missing typecheck steps.
Bonnes pratiques
- Conserver une fonction cœur publique par fichier, sauf si le modèle du projet diffère déjà.
- Utiliser des tuples AsyncResult pour les fonctions asynchrones qui peuvent échouer.
- Exporter uniquement les fonctions d'API publiques depuis index.ts et garder les helpers internes locaux.
Éviter
- Ne pas placer plusieurs fonctions cœur non liées dans un seul fichier.
- Ne pas créer d'imports circulaires entre types, helpers, sous-dossiers et fichiers index.
- Ne pas exporter les fonctions helper internes via le fichier barrel public.