fskill-creator
Ziel
Vereinheitliche die Erstellungs- und Migrationspfade, um ein in sich geschlossenes, überprüfbares, testbares funktionales Agenten-Skill-Verzeichnis zu erzeugen. Das Haupt-Skill übernimmt das Routing, die Blueprint-Normalisierung, die gemeinsame Artefakterzeugung, die Bereitstellung von Laufzeitfähigkeiten, das Dateischreiben und die Validierung; Sub-Skills übernehmen nur die Voranalyse für ihre jeweiligen Eingabeformen.
Verwende dieses Skill, wenn der Benutzer „ein funktionales Skill generieren“, „ein funktionales Skill erstellen“, „Funktionen zu einem bestehenden funktionalen Skill hinzufügen“ oder „ein vorhandenes Legacy-Skill-Verzeichnis in ein funktionales Skill migrieren“ möchte.
Prinzipien
- Die Hauptdatei
SKILL.mdorchestriert nur den gemeinsamen Erstellungs-/Migrations-/Erweiterungs-/Validierungs-Workflow. - Erstellen und Migrieren sind zwei Vorspuren; sie müssen zunächst in einem einheitlichen
skill_blueprintzusammenlaufen. - Funktionsspezifisches Verhalten befindet sich in
functions/*.md; erstellungs-/migrationsspezifisches Vorverhalten insub-skills/*/functions/*.md. - Gemeinsames Vokabular, Richtlinien und Schemas befinden sich in
references/*.md. - Deterministisches Parsen, Formatieren, Validieren und mechanische Transformationen befinden sich in
scripts/. - Berichts-, Unit-Test-, Viewer- und Testfall-Fähigkeiten werden nur einmal im Haupt-Skill gepflegt und durch
add_runtime_capabilitiesin das Ziel-Skill eingebunden. - Bewahre benutzerdefinierte Domain-Einschränkungen; der Migrationspfad muss auch Belege für das Legacy-Verhalten erhalten.
- Wenn der Benutzer eine direkte Änderung nicht genehmigt hat, sollten erzeugte Dateien als Vorschläge behandelt werden.
Sub-Skills
| Sub-Skill | Wann | Verantwortung | Ausgabe |
|---|---|---|---|
sub-skills/create | Benutzer liefert eine neue Skill-Kurzbeschreibung oder möchte ein bestehendes funktionales Skill erweitern | Anforderungen, Zielpfad, Ein-/Ausgaben, Einschränkungen und Viewer-Auswahl normalisieren | create_context |
sub-skills/migrate | Benutzer liefert ein Legacy-Skill-Verzeichnis, monolithischen Skill-Inhalt oder eine Migrationsanfrage | Legacy-Skill-Paket laden, zu erhaltende Verhalten identifizieren, Funktionsgrenzen und Belege vorschlagen | migration_context |
Sub-Skills schreiben keine endgültigen Ziel-Skill-Dateien direkt. Ihre Ausgabe muss normalize_skill_blueprint durchlaufen, bevor sie in die gemeinsame Artefakt-Pipeline gelangt.
Referenzen
| Ressource | Ladezeitpunkt | Zweck |
|---|---|---|
shared_glossary | Bei Bedarf | Stabile Terminologie und spaltenübergreifende Feldsemantik. |
script_rules | Vor dem Entwurf von Skripten | Regeln, ob deterministische Arbeit in scripts/ gehört. |
sub-skills/create | Erstellungsspur | create_context aus Benutzerkurzbeschreibung bilden. |
sub-skills/migrate | Migrationsspur | migration_context aus einem Legacy-Skill-Verzeichnis bilden. |
Externe Eingaben
| Feld | Quelle | Beschreibung |
|---|---|---|
task_mode | Benutzer oder abgeleitet | create, migrate, enhance oder validate; bei Fehlen durch resolve_task_mode ermittelt. |
skill_request | Benutzer | Anforderungsbeschreibung zum Erstellen oder Erweitern eines Skills. |
legacy_skill_dir | Benutzer oder Repository | Pfad zu einem vorhandenen Legacy-Skill-Verzeichnis mit SKILL.md und optionalen Begleitdateien. |
legacy_skill_path | Benutzer oder Repository | Veralteter Alias für legacy_skill_dir; kann auch ein direkter Pfad zu SKILL.md sein, der in das übergeordnete Verzeichnis aufgelöst wird. |
legacy_skill_content | Benutzer | Legacy-Skill-Markdown, bereitgestellt, wenn der Pfad nicht zugänglich ist. |
target_skill_path | Benutzer oder abgeleitet | Verzeichnis, in dem das funktionale Skill leben soll. |
skill_name | Benutzer oder abgeleitet | Optionaler Ziel-Skill-Name. |
existing_skill_files | Repository | Optional vorhandene funktionale Skill-Dateien. |
migration_constraints | Benutzer | Dateinamen, Ton, Plattformregeln oder Verhalten, die bei der Migration erhalten bleiben müssen. |
known_testcases | Benutzer oder Repository | Vorhandene Beispiele, Ablaufverfolgungen oder erwartete Verhalten. |
existing_scripts | Repository | Hilfsskripte, die dem Legacy-Skill zugeordnet sind. |
include_report | Benutzer | Ob eine Berichtsprotokoll-Laufzeit im Ziel-Skill erzeugt werden soll; Standard ist true. |
include_unittest | Benutzer | Ob ein Unit-Test-/Testfall-Läufer im Ziel-Skill erzeugt werden soll; Standard ist true. |
script_runtime | Umgebung | Ob die eigenen Node.js-Skripte dieses Skills ausgeführt werden können. |
report_mode | Benutzer | off, local oder remote; Standard ist off. |
Viewer werden gemäß den Fähigkeitsflags erzeugt: tools/log_viewer.mjs wenn include_report=true; tools/tester_viewer.mjs wenn include_unittest=true.
Ausführungspipeline
| Schritt | Funktion | Zweck | Eingabe | Ausgabe |
|---|---|---|---|---|
| 1 | resolve_task_mode | Bestimme, ob diese Anfrage durch Erstellen, Migrieren, Erweitern oder Validieren gehen soll. | task_modeskill_requestlegacy_skill_dirlegacy_skill_pathlegacy_skill_contentexisting_skill_files | task_context |
| 2A | sub-skills/create::collect_create_brief | Erstellungs-/Erweiterungsspur: Benutzerkurzbeschreibung normalisieren. | skill_requesttarget_skill_pathskill_name | create_context |
| 2B | sub-skills/migrate::load_legacy_skill + map_existing_behavior + propose_function_split + extract_shared_references | Migrationsspur: Legacy-Skill-Paket lesen, Verhalten und Migrationsbelege extrahieren. | legacy_skill_dirlegacy_skill_pathlegacy_skill_contentmigration_constraintsinclude_reportinclude_unittestscript_runtime | migration_context |
| 3 | normalize_skill_blueprint | Erstellungs-/Migrations-/Erweiterungseingaben in einen einheitlichen Blueprint zusammenführen. | task_contextcreate_contextmigration_contexttarget_skill_pathinclude_reportinclude_unittest | skill_blueprint |
| 4 | design_skill_structure | Funktionspipeline, Referenzen, Skripte, Testfälle und Dateilayout basierend auf Blueprint entwerfen. | skill_blueprintexisting_skill_filesscript_rules | skill_structurescript_plantool_plan |
| 5 | draft_skill_artifacts | SKILL.md, Funktionsverträge, Referenzen, Skriptspezifikationen und Testfallvorschläge entwerfen. | skill_blueprintskill_structurescript_plan | skill_artifacts |
| 6 | add_runtime_capabilities | Berichtsprotokoll, Laufzeit-Wrapper, Unit-Test-Läufer, Viewer und Rauchtests gemäß Einschlussflags bereitstellen. | skill_blueprint.include_reportskill_blueprint.include_unittestskill_artifacts | runtime_artifactsskill_artifacts |
| 7 | assemble_skill_files | Dateien des Ziel-Skill-Verzeichnisses erzeugen oder aktualisieren. | target_skill_pathskill_structureskill_artifactsruntime_artifactsscript_runtime | file_plancreated_filesupdated_files |
| 8 | validate_skill | Struktur des funktionalen Skills, Laufzeitfähigkeiten, Testfälle und Bewahrung des Migrationsverhaltens validieren. | target_skill_pathfile_planskill_blueprintreport_mode | validation_result |
Ausgabeumfang
Dieses Skill kann Legacy-Skills lesen und funktionale Skill-Dateien unter target_skill_path erstellen oder ändern. Lösche das ursprüngliche Legacy-Skill nicht, es sei denn, der Benutzer fordert es explizit an; ändere keine nicht zugehörigen Repository-Dateien, es sei denn, der Benutzer fordert explizit eine Integration auf Projektebene an.