스킬 생성기

스킬 생성기은(는) 무엇을 하나요?

워크플로우

1. 계약 수립

   • 기존 스킬과 해당 리소스를 읽거나, 새 스킬에 대한 구체적인 요청을 수집합니다.
   • 실제 워크플로우 브랜치와 동일한 브랜치의 동의어를 분리합니다.
   • 완료 조건: 모든 브랜치에 구체적인 트리거, 예상 결과, 지속성 대상이 있습니다.

2. 호출 방식 선택

   • 모델 발견 가능: 모델 대면 description을 작성하고 disable-model-invocation을 생략합니다.
   • 수동 전용: disable-model-invocation: true로 설정하고 사람 대면 요약을 작성합니다.
   • 직접 도구 명령: 명령이 모델을 우회하는 경우에만 command-dispatch: tool, command-tool, command-arg-mode를 추가합니다.
   • 완료 조건: 프론트매터가 실제 스킬에 도달하는 방식과 일치합니다.

3. 스킬 구조화

   • 공유된 순서 절차를 SKILL.md에 매핑합니다. 모든 단계는 확인 가능한 완료 기준으로 끝나고 검증으로 마무리됩니다.
   • 라우팅 조건은 description에 유지하고 본문은 실행으로 시작합니다.
   • 브랜치 전용 세부 사항은 references/에, 반복 가능한 도우미는 scripts/에, 출력 리소스는 assets/에, 선택적 UI 메타데이터는 agents/에 매핑합니다.
   • 완료 조건: 계획된 모든 리소스가 하나의 목적을 가지며 SKILL.md에서 직접 포인터를 제공합니다.

4. 초안 작성 및 유지

   • 라이브 작업 공간 스킬: skill_workshop을 사용하여 보류 중인 제안을 생성하거나 수정합니다. 적용할 때까지 라이브 파일을 변경하지 않고 유지합니다.
   • 저장소 소유 스킬 소스: 저장소의 일반 편집 및 검토 워크플로우를 사용합니다.
   • 완료 조건: 제안 또는 소스 diff가 1단계의 모든 브랜치를 구현하고 3단계의 모든 리소스를 포함합니다.

5. 검증

   • python {baseDir}/scripts/quick_validate.py <skill-directory>를 실행하고 모든 수정된 헬퍼의 집중 테스트를 실행합니다.
   • 완료 조건: 프론트매터 통과, 리소스 포인터 해결, 모든 수정된 헬퍼가 집중 테스트 통과.

프론트매터

필수: name, description.

OpenClaw는 또한 metadata, homepage, license, allowed-tools, user-invocable, disable-model-invocation, command-dispatch, command-tool, command-arg-mode를 지원합니다. 선택적 필드는 런타임 동작이나 검색을 변경하는 경우에만 추가합니다.