criador-de-skill-funcional (fskill-creator)
Objetivo
Unificar os fluxos de criação e migração para produzir um diretório de skill funcional autocontido, revisável e testável. O skill principal gerencia roteamento, normalização de blueprint, geração de artefatos compartilhados, provisionamento de capacidades em tempo de execução, escrita de arquivos e validação; sub-skills tratam apenas da pré-análise para suas respectivas formas de entrada.
Use este skill quando o usuário quiser "gerar um skill funcional", "criar um skill funcional", "adicionar funções a um skill funcional existente" ou "migrar um diretório de skill legado existente para um skill funcional".
Princípios
- O
SKILL.mdprincipal apenas orquestra o fluxo de trabalho compartilhado de criar / migrar / aprimorar / validar. - Criar e migrar são dois pré-fluxos; eles devem primeiro convergir em um
skill_blueprintunificado. - O comportamento específico de função reside em
functions/*.md; o comportamento pré-específico de criar/migrar reside emsub-skills/*/functions/*.md. - Vocabulário, políticas e esquemas compartilhados residem em
references/*.md. - Análise sintática determinística, formatação, validação e transformações mecânicas residem em
scripts/. - As capacidades de relatório, teste unitário, visualizador e caso de teste são mantidas apenas uma vez no skill principal e fornecidas ao skill alvo por
add_runtime_capabilities. - Preserve as restrições de domínio fornecidas pelo usuário; o fluxo de migração também deve preservar evidências de comportamento legado.
- Quando o usuário não aprovou modificação direta, os arquivos gerados devem ser tratados como propostas.
Sub-Skills
| Sub-skill | Quando | Responsabilidade | Saída |
|---|---|---|---|
sub-skills/create | O usuário fornece um resumo de novo skill ou deseja aprimorar um skill funcional existente | Normalizar requisitos, caminho alvo, entradas/saídas, restrições e escolhas de visualizador | create_context |
sub-skills/migrate | O usuário fornece um diretório de skill legado, conteúdo de skill monolítico ou uma solicitação de migração | Carregar o pacote de skill legado, identificar comportamentos que devem ser preservados, propor limites de função e evidências | migration_context |
Sub-skills não escrevem diretamente os arquivos finais do skill alvo. Sua saída deve passar por normalize_skill_blueprint antes de entrar no pipeline de artefatos compartilhados.
Referências
| Recurso | Momento de Carregamento | Propósito |
|---|---|---|
shared_glossary | Sob demanda | Terminologia estável e semântica de campo entre fluxos. |
script_rules | Antes de projetar ou redigir scripts | Regras para decidir se o trabalho determinístico pertence a scripts/. |
sub-skills/create | Fluxo de criação | Formar create_context a partir do resumo do usuário. |
sub-skills/migrate | Fluxo de migração | Formar migration_context a partir de um diretório de skill legado. |
Entradas Externas
| Campo | Fonte | Descrição |
|---|---|---|
task_mode | usuário ou derivado | create, migrate, enhance ou validate; inferido por resolve_task_mode quando ausente. |
skill_request | usuário | Descrição do requisito para criar ou aprimorar um skill. |
legacy_skill_dir | usuário ou repositório | Caminho para um diretório de skill legado existente contendo SKILL.md e arquivos complementares opcionais. |
legacy_skill_path | usuário ou repositório | Alias obsoleto para legacy_skill_dir; também pode ser um caminho direto para SKILL.md, que resolve para seu diretório pai. |
legacy_skill_content | usuário | Markdown de skill legado fornecido quando o caminho é inacessível. |
target_skill_path | usuário ou derivado | Diretório onde o skill funcional deve residir. |
skill_name | usuário ou derivado | Nome opcional do skill alvo. |
existing_skill_files | repositório | Arquivos opcionais de skill funcional existente. |
migration_constraints | usuário | Nomes de arquivos, tom, regras de plataforma ou comportamentos que devem ser preservados durante a migração. |
known_testcases | usuário ou repositório | Exemplos, rastreamentos ou comportamentos esperados existentes. |
existing_scripts | repositório | Scripts auxiliares associados ao skill legado. |
include_report | usuário | Se deve gerar o tempo de execução do relatório de log no skill alvo; o padrão é true. |
include_unittest | usuário | Se deve gerar o executor de teste unitário / caso de teste no skill alvo; o padrão é true. |
script_runtime | ambiente | Se os scripts Node.js próprios deste skill podem ser executados. |
report_mode | usuário | off, local ou remote; o padrão é off. |
Os visualizadores são gerados seguindo as flags de capacidade: tools/log_viewer.mjs quando include_report=true; tools/tester_viewer.mjs quando include_unittest=true.
Pipeline de Execução
| Etapa | Função | Propósito | Entrada | Saída |
|---|---|---|---|---|
| 1 | resolve_task_mode | Determinar se esta solicitação deve passar por criação, migração, aprimoramento ou validação. | task_modeskill_requestlegacy_skill_dirlegacy_skill_pathlegacy_skill_contentexisting_skill_files | task_context |
| 2A | sub-skills/create::collect_create_brief | Fluxo de criação/aprimoramento: normalizar resumo do usuário. | skill_requesttarget_skill_pathskill_name | create_context |
| 2B | sub-skills/migrate::load_legacy_skill + map_existing_behavior + propose_function_split + extract_shared_references | Fluxo de migração: ler o pacote de skill legado, extrair comportamentos e evidências de migração. | legacy_skill_dirlegacy_skill_pathlegacy_skill_contentmigration_constraintsinclude_reportinclude_unittestscript_runtime | migration_context |
| 3 | normalize_skill_blueprint | Convergir entradas de criação / migração / aprimoramento em um blueprint unificado. | task_contextcreate_contextmigration_contexttarget_skill_pathinclude_reportinclude_unittest | skill_blueprint |
| 4 | design_skill_structure | Projetar pipeline de funções, referências, scripts, casos de teste e layout de arquivos com base no blueprint. | skill_blueprintexisting_skill_filesscript_rules | skill_structurescript_plantool_plan |
| 5 | draft_skill_artifacts | Rascunhar SKILL.md, contratos de funções, referências, especificações de scripts e sugestões de casos de teste. | skill_blueprintskill_structurescript_plan | skill_artifacts |
| 6 | add_runtime_capabilities | Provisionar log de relatório, wrapper de tempo de execução, executor de caso de teste unitário, visualizador e testes smoke de acordo com as flags de inclusão. | skill_blueprint.include_reportskill_blueprint.include_unittestskill_artifacts | runtime_artifactsskill_artifacts |
| 7 | assemble_skill_files | Gerar ou atualizar arquivos do diretório do skill alvo. | target_skill_pathskill_structureskill_artifactsruntime_artifactsscript_runtime | file_plancreated_filesupdated_files |
| 8 | validate_skill | Validar estrutura do skill funcional, capacidades em tempo de execução, casos de teste e preservação de comportamento de migração. | target_skill_pathfile_planskill_blueprintreport_mode | validation_result |
Escopo da Saída
Este skill pode ler skills legados e criar ou modificar arquivos de skill funcional sob target_skill_path. Não exclua o skill legado original, a menos que o usuário solicite explicitamente a exclusão; não modifique arquivos de repositório não relacionados, a menos que o usuário solicite explicitamente integração em nível de projeto.