fskill-creator
목표
생성(create)과 마이그레이션(migrate) 경로를 통합하여 자체 완결적이고, 검토 가능하며, 테스트 가능한 기능형(functional) 에이전트 스킬 디렉토리를 생성합니다. 메인 스킬은 라우팅, 청사진 정규화, 공유 아티팩트 생성, 런타임 기능 제공, 파일 쓰기, 검증을 담당하고, 서브 스킬은 각 입력 형태에 대한 사전 분석만 처리합니다.
이 스킬은 사용자가 "기능형 스킬 생성", "기능형 스킬 만들기", "기존 기능형 스킬에 함수 추가", 또는 "기존 레거시 스킬 디렉토리를 기능형 스킬로 마이그레이션"하고자 할 때 사용합니다.
원칙
- 메인
SKILL.md는 공유된 생성/마이그레이션/향상/검증 워크플로우만 오케스트레이션합니다. - 생성과 마이그레이션은 두 개의 사전 경로이며, 먼저 통합된
skill_blueprint로 수렴되어야 합니다. - 함수별 동작은
functions/*.md에 있으며, 생성/마이그레이션별 사전 동작은sub-skills/*/functions/*.md에 있습니다. - 공유 어휘, 정책 및 스키마는
references/*.md에 있습니다. - 결정론적 파싱, 포맷팅, 검증 및 기계적 변환은
scripts/에 있습니다. - 리포트, 유닛 테스트, 뷰어 및 테스트케이스 기능은 메인 스킬에서 한 번만 유지 관리되며,
add_runtime_capabilities에 의해 대상 스킬에 벤더링됩니다. - 사용자가 제공한 도메인 제약 조건을 유지하고, 마이그레이션 경로는 레거시 동작 증거도 유지해야 합니다.
- 사용자가 직접 수정을 승인하지 않은 경우, 생성된 파일은 제안으로 처리되어야 합니다.
서브 스킬
| 서브 스킬 | 사용 시점 | 책임 | 출력 |
|---|---|---|---|
sub-skills/create | 사용자가 새 스킬 개요를 제공하거나 기존 기능형 스킬을 향상시키고자 할 때 | 요구사항, 대상 경로, 입/출력, 제약 조건 및 뷰어 선택 정규화 | create_context |
sub-skills/migrate | 사용자가 레거시 스킬 디렉토리, 모놀리식 스킬 콘텐츠 또는 마이그레이션 요청을 제공할 때 | 레거시 스킬 패키지 로드, 보존해야 할 동작 식별, 함수 경계 및 증거 제안 | migration_context |
서브 스킬은 대상 스킬 파일을 직접 쓰지 않습니다. 해당 출력은 공유 아티팩트 파이프라인에 진입하기 전에 normalize_skill_blueprint를 거쳐야 합니다.
참조
| 리소스 | 로드 시점 | 목적 |
|---|---|---|
shared_glossary | 필요 시 | 안정적인 용어 및 경로 간 필드 의미론 |
script_rules | 스크립트 설계 또는 초안 작성 전 | 결정론적 작업이 scripts/에 속하는지 여부를 결정하는 규칙 |
sub-skills/create | 생성 경로 | 사용자 개요로부터 create_context 형성 |
sub-skills/migrate | 마이그레이션 경로 | 레거시 스킬 디렉토리로부터 migration_context 형성 |
외부 입력
| 필드 | 출처 | 설명 |
|---|---|---|
task_mode | 사용자 또는 유도 | create, migrate, enhance, 또는 validate; 없을 경우 resolve_task_mode에 의해 추론 |
skill_request | 사용자 | 스킬 생성 또는 향상을 위한 요구사항 설명 |
legacy_skill_dir | 사용자 또는 저장소 | SKILL.md 및 선택적 동반 파일을 포함하는 기존 레거시 스킬 디렉토리 경로 |
legacy_skill_path | 사용자 또는 저장소 | legacy_skill_dir의 사용 중단된 별칭; SKILL.md의 직접 경로일 수도 있으며, 이 경우 상위 디렉토리로 해석됨 |
legacy_skill_content | 사용자 | 경로에 접근할 수 없을 때 제공되는 레거시 스킬 마크다운 |
target_skill_path | 사용자 또는 유도 | 기능형 스킬이 위치할 디렉토리 |
skill_name | 사용자 또는 유도 | 선택적 대상 스킬 이름 |
existing_skill_files | 저장소 | 선택적 기존 기능형 스킬 파일 |
migration_constraints | 사용자 | 마이그레이션 중 보존해야 할 파일 이름, 톤, 플랫폼 규칙 또는 동작 |
known_testcases | 사용자 또는 저장소 | 기존 예제, 추적 또는 예상 동작 |
existing_scripts | 저장소 | 레거시 스킬과 관련된 도우미 스크립트 |
include_report | 사용자 | 대상 스킬에 리포트 로그 런타임을 생성할지 여부; 기본값은 true |
include_unittest | 사용자 | 대상 스킬에 유닛테스트/테스트케이스 러너를 생성할지 여부; 기본값은 true |
script_runtime | 환경 | 이 스킬 자체의 Node.js 스크립트를 실행할 수 있는지 여부 |
report_mode | 사용자 | off, local, 또는 remote; 기본값은 off |
뷰어는 기능 플래그에 따라 생성됩니다: include_report=true일 때 tools/log_viewer.mjs; include_unittest=true일 때 tools/tester_viewer.mjs.
실행 파이프라인
| 단계 | 함수 | 목적 | 입력 | 출력 |
|---|---|---|---|---|
| 1 | resolve_task_mode | 이 요청이 생성, 마이그레이션, 향상 또는 검증 중 어떤 경로를 통해 처리되어야 하는지 결정 | task_modeskill_requestlegacy_skill_dirlegacy_skill_pathlegacy_skill_contentexisting_skill_files | task_context |
| 2A | sub-skills/create::collect_create_brief | 생성/향상 경로: 사용자 개요 정규화 | skill_requesttarget_skill_pathskill_name | create_context |
| 2B | sub-skills/migrate::load_legacy_skill + map_existing_behavior + propose_function_split + extract_shared_references | 마이그레이션 경로: 레거시 스킬 패키지 읽기, 동작 및 마이그레이션 증거 추출 | legacy_skill_dirlegacy_skill_pathlegacy_skill_contentmigration_constraintsinclude_reportinclude_unittestscript_runtime | migration_context |
| 3 | normalize_skill_blueprint | 생성/마이그레이션/향상 입력을 통합 청사진으로 수렴 | task_contextcreate_contextmigration_contexttarget_skill_pathinclude_reportinclude_unittest | skill_blueprint |
| 4 | design_skill_structure | 청사진 기반으로 함수 파이프라인, 참조, 스크립트, 테스트케이스 및 파일 레이아웃 설계 | skill_blueprintexisting_skill_filesscript_rules | skill_structurescript_plantool_plan |
| 5 | draft_skill_artifacts | SKILL.md, 함수 계약, 참조, 스크립트 사양 및 테스트케이스 제안 초안 작성 | skill_blueprintskill_structurescript_plan | skill_artifacts |
| 6 | add_runtime_capabilities | 포함 플래그에 따라 리포트 로그, 런타임 래퍼, 유닛 테스트케이스 러너, 뷰어 및 스모크 테스트 제공 | skill_blueprint.include_reportskill_blueprint.include_unittestskill_artifacts | runtime_artifactsskill_artifacts |
| 7 | assemble_skill_files | 대상 스킬 디렉토리 파일 생성 또는 업데이트 | target_skill_pathskill_structureskill_artifactsruntime_artifactsscript_runtime | file_plancreated_filesupdated_files |
| 8 | validate_skill | 기능형 스킬 구조, 런타임 기능, 테스트케이스 및 마이그레이션 동작 보존 검증 | target_skill_pathfile_planskill_blueprintreport_mode | validation_result |
출력 범위
이 스킬은 레거시 스킬을 읽고 target_skill_path 아래에 기능형 스킬 파일을 생성하거나 수정할 수 있습니다. 사용자가 명시적으로 삭제를 요청하지 않는 한 원본 레거시 스킬을 삭제하지 마십시오. 사용자가 명시적으로 프로젝트 수준 통합을 요청하지 않는 한 관련 없는 저장소 파일을 수정하지 마십시오.