컨텐츠로 건너뛰기
레시피 생태계 소스 코드 문서

커스텀 Skill 워크플로 구축

반복 가능한 다단계 워크플로를 OpenCode Skill로 패키징하여 에이전트가 주문형으로 실행하게 합니다. Skills를 사용하면 모범 사례를 재사용 가능하고 트리거 가능한 프로세스로 인코딩할 수 있습니다.

이 레시피를 사용하는 경우

  • 동일한 다단계 워크플로를 반복적으로 실행할 때.
  • 에이전트가 매번 팀의 정확한 프로세스를 따르게 할 때.
  • 프로젝트나 팀원 간에 워크플로를 공유하고 싶을 때.

전제 조건

  • OpenCode를 설치.
  • 개별 단계로 설명할 수 있는 워크플로.

단계

  1. 워크플로 분해

    수동으로 수행하는 단계를 적습니다. 이것이 Skill 본체가 됩니다.

    • 이슈 읽기
    • 로컬에서 재현
    • 실패하는 테스트 작성
    • 수정 구현
    • 검증하고 PR 초안 열기

  2. skill 파일 생성

    skills 디렉토리에 skill 형식의 SKILL.md를 둡니다.

    # Fix-and-PR

## When to use
Use when asked to fix a GitHub issue end to end.

## Steps
1. Read the issue and summarize the problem.
2. Reproduce it locally with a test.
3. Implement the minimal fix.
4. Run the full test suite.
5. Open a draft PR with a summary referencing the issue.

  3. 트리거 정의

    Skill이 언제 활성화되어야 할지 명확히 하여 에이전트가 적절한 순간에 호출하게 합니다.

  4. skill 테스트

    실제 이슈로 트리거하고 각 단계의 실행을 관찰합니다.

  5. 반복

    에이전트가 추가 프롬프트 없이 각 단계를 안정적으로 따를 때까지 표현을 다듬습니다.

핵심 프롬프트

반복되는 워크플로가 있습니다: GitHub 이슈를 트리아지하고, 재현하고, 수정하고, 테스트하고, PR을 여는 것입니다. 이것을 인코딩한 SKILL.md를 작성해 주세요. 이슈 번호를 주면 전체 흐름을 실행할 수 있게요.

흔한 주의점

  • 너무 넓은 트리거: 트리거가 너무 느슨하면 원하지 않을 때 Skill이 발동합니다. “When to use”를 엄격하게 제한하세요.
  • 암묵적 단계: 에이전트는 적히지 않은 것을 건너뜁니다. 검증을 포함해 모든 단계를 명시하세요.
  • 테스트 단계 건너뛰기: 항상 “검증” 단계를 포함하세요. 그렇지 않으면 Skill이 미완성 작업을 배포할 수 있습니다.

관련 문서

  • Skills — 완전한 Skills 레퍼런스와 작성 형식
  • 명령 — 반복 가능한 작업을 위한 커스텀 슬래시 명령 정의

관련 레시피

관련 문서

다음 단계