Que fait fskill-creator ?
Objectif
Uniformiser les voies de création et de migration pour produire un répertoire de compétence d'agent fonctionnel, autonome, révisable et testable. Le skill principal gère le routage, la normalisation du plan, la génération d'artefacts partagés, le provisionnement des capacités d'exécution, l'écriture de fichiers et la validation ; les sous-skills ne gèrent que la pré-analyse pour leurs formulaires d'entrée respectifs.
Utilisez ce skill lorsque l'utilisateur souhaite « générer un skill fonctionnel », « créer un skill fonctionnel », « ajouter des fonctions à un skill fonctionnel existant » ou « migrer un répertoire de skill existant vers un skill fonctionnel ».
Principes
- Le
SKILL.mdprincipal orchestre uniquement le flux de travail partagé de création / migration / amélioration / validation. - Les voies de création et de migration sont deux pré-voies ; elles doivent d'abord converger vers un
skill_blueprintunifié. - Le comportement spécifique aux fonctions réside dans
functions/*.md; le comportement pré-spécifique à la création ou à la migration réside danssub-skills/*/functions/*.md. - Le vocabulaire partagé, les politiques et les schémas résident dans
references/*.md. - L'analyse syntaxique, le formatage, la validation et les transformations mécaniques déterministes résident dans
scripts/. - Les capacités de rapport, de test unitaire, de visualiseur et de cas de test sont maintenues une seule fois dans le skill principal, et vendues dans le skill cible par
add_runtime_capabilities. - Préservez les contraintes de domaine fournies par l'utilisateur ; la voie de migration doit également préserver les preuves de comportement héritées.
- Lorsque l'utilisateur n'a pas approuvé la modification directe, les fichiers générés doivent être traités comme des propositions.
Sous-skills
| Sous-skill | Quand | Responsabilité | Sortie |
|---|---|---|---|
sub-skills/create | L'utilisateur fournit un nouveau brief de skill ou souhaite améliorer un skill fonctionnel existant | Normaliser les exigences, le chemin cible, les entrées/sorties, les contraintes et les choix du visualiseur | create_context |
sub-skills/migrate | L'utilisateur fournit un répertoire de skill existant, un contenu de skill monolithique ou une demande de migration | Charger le package de skill existant, identifier les comportements à préserver, proposer des limites de fonctions et des preuves | migration_context |
Les sous-skills n'écrivent pas directement les fichiers finaux du skill cible. Leur sortie doit passer par normalize_skill_blueprint avant d'entrer dans le pipeline d'artefacts partagés.
Références
| Ressource | Moment de chargement | Objectif |
|---|---|---|
shared_glossary | À la demande | Terminologie stable et sémantique des champs entre les voies. |
script_rules | Avant de concevoir ou de rédiger des scripts | Règles pour décider si un travail déterministe appartient à scripts/. |
sub-skills/create | Voie de création | Former le create_context à partir du brief utilisateur. |
sub-skills/migrate | Voie de migration | Former le migration_context à partir d'un répertoire de skill existant. |
Entrées externes
| Champ | Source | Description |
|---|---|---|
task_mode | utilisateur ou dérivé | create, migrate, enhance ou validate ; inféré par resolve_task_mode en l'absence. |
skill_request | utilisateur | Description des exigences pour créer ou améliorer un skill. |
legacy_skill_dir | utilisateur ou dépôt | Chemin vers un répertoire de skill existant contenant SKILL.md et des fichiers compagnons optionnels. |
legacy_skill_path | utilisateur ou dépôt | Alias obsolète pour legacy_skill_dir ; peut également être un chemin direct vers SKILL.md, qui se résout en son répertoire parent. |
legacy_skill_content | utilisateur | Contenu markdown du skill existant fourni lorsque le chemin est inaccessible. |
target_skill_path | utilisateur ou dérivé | Répertoire où le skill fonctionnel doit être placé. |
skill_name | utilisateur ou dérivé | Nom optionnel du skill cible. |
existing_skill_files | dépôt | Fichiers de skill fonctionnel existants optionnels. |
migration_constraints | utilisateur | Noms de fichiers, ton, règles de plateforme ou comportements qui doivent être préservés pendant la migration. |
known_testcases | utilisateur ou dépôt | Exemples existants, traces ou comportements attendus. |
existing_scripts | dépôt | Scripts d'association associés au skill existant. |
include_report | utilisateur | Indique s'il faut générer un journal de rapport dans le skill cible ; par défaut true. |
include_unittest | utilisateur | Indique s'il faut générer un exécuteur de tests unitaires / cas de test dans le skill cible ; par défaut true. |
script_runtime | environnement | Indique si les scripts Node.js de ce skill peuvent être exécutés. |
report_mode | utilisateur | off, local ou remote ; par défaut off. |
Les visualiseurs sont générés selon les indicateurs de capacité : tools/log_viewer.mjs lorsque include_report=true ; tools/tester_viewer.mjs lorsque include_unittest=true.
Pipeline d'exécution
| Étape | Fonction | Objectif | Entrée | Sortie |
|---|---|---|---|---|
| 1 | resolve_task_mode | Déterminer si cette demande doit passer par la création, la migration, l'amélioration ou la validation. | task_modeskill_requestlegacy_skill_dirlegacy_skill_pathlegacy_skill_contentexisting_skill_files | task_context |
| 2A | sub-skills/create::collect_create_brief | Voie de création/amélioration : normaliser le brief utilisateur. | skill_requesttarget_skill_pathskill_name | create_context |
| 2B | sub-skills/migrate::load_legacy_skill + map_existing_behavior + propose_function_split + extract_shared_references | Voie de migration : lire le package de skill existant, extraire les comportements et les preuves de migration. | legacy_skill_dirlegacy_skill_pathlegacy_skill_contentmigration_constraintsinclude_reportinclude_unittestscript_runtime | migration_context |
| 3 | normalize_skill_blueprint | Converger les entrées de création / migration / amélioration en un plan unifié. | task_contextcreate_contextmigration_contexttarget_skill_pathinclude_reportinclude_unittest | skill_blueprint |
| 4 | design_skill_structure | Concevoir le pipeline de fonctions, les références, les scripts, les cas de test et la disposition des fichiers en fonction du plan. | skill_blueprintexisting_skill_filesscript_rules | skill_structurescript_plantool_plan |
| 5 | draft_skill_artifacts | Rédiger le SKILL.md, les contrats de fonctions, les références, les spécifications de scripts et les suggestions de cas de test. | skill_blueprintskill_structurescript_plan | skill_artifacts |
| 6 | add_runtime_capabilities | Provisionner le journal de rapport, le wrapper d'exécution, l'exécuteur de tests unitaires, le visualiseur et les tests de validation selon les indicateurs d'inclusion. | skill_blueprint.include_reportskill_blueprint.include_unittestskill_artifacts | runtime_artifactsskill_artifacts |
| 7 | assemble_skill_files | Générer ou mettre à jour les fichiers du répertoire du skill cible. | target_skill_pathskill_structureskill_artifactsruntime_artifactsscript_runtime | file_plancreated_filesupdated_files |
| 8 | validate_skill | Valider la structure du skill fonctionnel, les capacités d'exécution, les cas de test et la préservation du comportement de migration. | target_skill_pathfile_planskill_blueprintreport_mode | validation_result |
Périmètre de sortie
Ce skill peut lire des skills existants et créer ou modifier des fichiers de skill fonctionnel sous target_skill_path. Ne supprimez pas le skill existant d'origine sauf si l'utilisateur le demande explicitement ; ne modifiez pas les fichiers du dépôt non liés sauf si l'utilisateur demande explicitement une intégration au niveau du projet.