¿Qué hace fskill-creator?
Objetivo
Unificar los flujos de creación y migración para producir un directorio de habilidades de agente funcional autocontenido, revisable y comprobable. La habilidad principal gestiona el enrutamiento, la normalización del plano, la generación de artefactos compartidos, el aprovisionamiento de capacidades de ejecución, la escritura de archivos y la validación; las sub-habilidades solo manejan el preanálisis de sus respectivos formatos de entrada.
Utiliza esta habilidad cuando el usuario quiera "generar una habilidad funcional", "crear una habilidad funcional", "añadir funciones a una habilidad funcional existente" o "migrar un directorio de habilidades heredado existente a una habilidad funcional".
Principios
- El
SKILL.mdprincipal solo orquesta el flujo de trabajo compartido de crear / migrar / mejorar / validar. - Crear y migrar son dos pre-flujos; primero deben converger en un
skill_blueprintunificado. - El comportamiento específico de las funciones reside en
functions/*.md; el comportamiento previo específico de crear / migrar reside ensub-skills/*/functions/*.md. - El vocabulario compartido, las políticas y los esquemas residen en
references/*.md. - El análisis determinista, el formateo, la validación y las transformaciones mecánicas residen en
scripts/. - Las capacidades de informe, prueba unitaria, visor y casos de prueba se mantienen solo una vez en la habilidad principal y se incorporan a la habilidad de destino mediante
add_runtime_capabilities. - Preservar las restricciones de dominio proporcionadas por el usuario; el flujo de migración también debe preservar la evidencia del comportamiento heredado.
- Cuando el usuario no ha aprobado la modificación directa, los archivos generados deben tratarse como propuestas.
Sub-habilidades
| Sub-habilidad | Cuándo | Responsabilidad | Salida |
|---|---|---|---|
sub-skills/create | El usuario proporciona un resumen de nueva habilidad o quiere mejorar una habilidad funcional existente | Normalizar requisitos, ruta de destino, entradas/salidas, restricciones y opciones de visor | create_context |
sub-skills/migrate | El usuario proporciona un directorio de habilidades heredado, contenido de habilidad monolítico o una solicitud de migración | Cargar el paquete de habilidades heredado, identificar comportamientos que deben preservarse, proponer límites de funciones y evidencia | migration_context |
Las sub-habilidades no escriben directamente los archivos finales de la habilidad de destino. Su salida debe pasar por normalize_skill_blueprint antes de entrar en el canal de artefactos compartido.
Referencias
| Recurso | Momento de carga | Propósito |
|---|---|---|
shared_glossary | Bajo demanda | Terminología estable y semántica de campos entre flujos. |
script_rules | Antes de diseñar o redactar scripts | Reglas para decidir si el trabajo determinista pertenece a scripts/. |
sub-skills/create | Flujo de creación | Formar create_context a partir del resumen del usuario. |
sub-skills/migrate | Flujo de migración | Formar migration_context a partir de un directorio de habilidades heredado. |
Entradas externas
| Campo | Fuente | Descripción |
|---|---|---|
task_mode | usuario o derivado | create, migrate, enhance o validate; inferido por resolve_task_mode cuando está ausente. |
skill_request | usuario | Descripción de requisitos para crear o mejorar una habilidad. |
legacy_skill_dir | usuario o repositorio | Ruta a un directorio de habilidades heredado existente que contiene SKILL.md y archivos complementarios opcionales. |
legacy_skill_path | usuario o repositorio | Alias obsoleto para legacy_skill_dir; también puede ser una ruta directa a SKILL.md, que se resuelve en su directorio padre. |
legacy_skill_content | usuario | Markdown de la habilidad heredada proporcionado cuando la ruta es inaccesible. |
target_skill_path | usuario o derivado | Directorio donde debe residir la habilidad funcional. |
skill_name | usuario o derivado | Nombre opcional de la habilidad de destino. |
existing_skill_files | repositorio | Archivos de habilidad funcional existentes opcionales. |
migration_constraints | usuario | Nombres de archivo, tono, reglas de plataforma o comportamientos que deben preservarse durante la migración. |
known_testcases | usuario o repositorio | Ejemplos, trazas o comportamientos esperados existentes. |
existing_scripts | repositorio | Scripts auxiliares asociados con la habilidad heredada. |
include_report | usuario | Si se debe generar el tiempo de ejecución del registro de informes en la habilidad de destino; por defecto es true. |
include_unittest | usuario | Si se debe generar el ejecutor de pruebas unitarias / casos de prueba en la habilidad de destino; por defecto es true. |
script_runtime | entorno | Si los scripts de Node.js propios de esta habilidad se pueden ejecutar. |
report_mode | usuario | off, local o remote; por defecto es off. |
Los visores se generan siguiendo las banderas de capacidad: tools/log_viewer.mjs cuando include_report=true; tools/tester_viewer.mjs cuando include_unittest=true.
Canal de ejecución
| Paso | Función | Propósito | Entrada | Salida |
|---|---|---|---|---|
| 1 | resolve_task_mode | Determinar si esta solicitud debe pasar por crear, migrar, mejorar o validar. | task_modeskill_requestlegacy_skill_dirlegacy_skill_pathlegacy_skill_contentexisting_skill_files | task_context |
| 2A | sub-skills/create::collect_create_brief | Flujo de creación/mejora: normalizar el resumen del usuario. | skill_requesttarget_skill_pathskill_name | create_context |
| 2B | sub-skills/migrate::load_legacy_skill + map_existing_behavior + propose_function_split + extract_shared_references | Flujo de migración: leer el paquete de habilidades heredado, extraer comportamientos y evidencia de migración. | legacy_skill_dirlegacy_skill_pathlegacy_skill_contentmigration_constraintsinclude_reportinclude_unittestscript_runtime | migration_context |
| 3 | normalize_skill_blueprint | Converger las entradas de crear / migrar / mejorar en un plano unificado. | task_contextcreate_contextmigration_contexttarget_skill_pathinclude_reportinclude_unittest | skill_blueprint |
| 4 | design_skill_structure | Diseñar el pipeline de funciones, referencias, scripts, casos de prueba y diseño de archivos basado en el plano. | skill_blueprintexisting_skill_filesscript_rules | skill_structurescript_plantool_plan |
| 5 | draft_skill_artifacts | Redactar SKILL.md, contratos de funciones, referencias, especificaciones de scripts y sugerencias de casos de prueba. | skill_blueprintskill_structurescript_plan | skill_artifacts |
| 6 | add_runtime_capabilities | Aprovisionar el registro de informes, envoltorio de ejecución, ejecutor de pruebas unitarias, visor y pruebas de humo según las banderas de inclusión. | skill_blueprint.include_reportskill_blueprint.include_unittestskill_artifacts | runtime_artifactsskill_artifacts |
| 7 | assemble_skill_files | Generar o actualizar archivos del directorio de la habilidad de destino. | target_skill_pathskill_structureskill_artifactsruntime_artifactsscript_runtime | file_plancreated_filesupdated_files |
| 8 | validate_skill | Validar la estructura de la habilidad funcional, las capacidades de ejecución, los casos de prueba y la preservación del comportamiento de migración. | target_skill_pathfile_planskill_blueprintreport_mode | validation_result |
Alcance de la salida
Esta habilidad puede leer habilidades heredadas y crear o modificar archivos de habilidades funcionales bajo target_skill_path. No elimines la habilidad heredada original a menos que el usuario lo solicite explícitamente; no modifiques archivos de repositorio no relacionados a menos que el usuario solicite explícitamente la integración a nivel de proyecto.