Compétences add-core-function
📦

add-core-function

Sûr

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.

Prend en charge: Claude Codex Code(CC)
🥈 80 Argent
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

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ûr
v6 • 6/28/2026

The 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.

1
Fichiers analysés
147
Lignes analysées
3
résultats
6
Total des audits
Problèmes à risque faible (3)
Markdown Backticks Misidentified as Shell Execution
Static findings for Ruby or shell backtick execution are false positives. The flagged lines are Markdown inline code, fenced directory examples, or TypeScript examples, not executable Ruby or shell code.
Relative Import Paths Misidentified as Path Traversal
Static path traversal findings are false positives. The flagged paths are TypeScript import examples and project layout guidance for local source files.
Weak Cryptography Pattern Misidentified
The weak cryptography findings at lines 3 and 66 are false positives. They match ordinary description text, not cryptographic algorithms or security-sensitive code.

Score de qualité

55
Architecture
100
Maintenabilité
87
Contenu
71
Communauté
99
Sécurité
83
Conformité aux spécifications

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

Créer une fonction cœur
Use add-core-function to add a pure core function for [domain]. Name it [function] and explain each file change.
Ajouter une opération de découverte ADT
Use add-core-function to design a new ADT discovery operation named [operation]. Include file placement, return type, helper usage, and export guidance.
Revoir un plan de fonction cœur
Use add-core-function to review this implementation plan: [plan]. Check file location, imports, AsyncResult use, helper placement, and barrel exports.
Refactoriser la structure de l'API cœur
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.

Foire aux questions

Que cette skill aide-t-elle à créer ?
Elle aide à créer des fonctions de logique métier cœur Catalyst-Relay avec une structure de fichiers, des imports, des types de retour et des exports cohérents.
Écrit-elle automatiquement une logique métier complète ?
Non. Elle fournit une structure et des modèles, mais l'utilisateur doit fournir le comportement métier exact.
Quel style de retour recommande-t-elle ?
Elle recommande des tuples AsyncResult de style Go pour les fonctions asynchrones qui peuvent retourner des données ou des erreurs.
Où doivent aller les types cœur partagés ?
Les types partagés doivent aller dans types.ts lorsqu'ils sont utilisés par plusieurs fichiers cœur.
Quand une fonction doit-elle être ajoutée à index.ts ?
Ajoutez-la à index.ts uniquement lorsqu'elle fait partie de l'API publique de la bibliothèque.
La skill nécessite-t-elle l'exécution de commandes ?
Non. Elle recommande d'exécuter la vérification des types du projet, mais elle ne contient pas de commandes ni de scripts exécutables.

Détails du développeur

Structure de fichiers

📄 SKILL.md