Community코딩 & 개발github.com

ankitai-s/superdialog-playbook-skill

SuperDialog 음성 에이전트 플레이북 YAML 작성 및 검토를 위한 Claude Code / Codex 스킬 — 스키마 참조, 15가지 실패 패턴 체크리스트, 인터럽트 가드 코드 패턴

superdialog-playbook-skill란 무엇인가요?

이 스킬은 SuperDialog 음성 에이전트의 플레이북(playbook)을 YAML 형식으로 작성하고 검토하는 과정을 지원합니다. 개발자와 AI 에이전트 사용자가 SuperDialog 플레이북의 올바른 스키마 구조를 참조하고, 음성 대화 시스템에서 자주 발생하는 15가지 실패 패턴을 사전에 점검할 수 있도록 도와줍니다. 또한 인터럽트(중단) 가드 코드 패턴을 제공하여 비정상적인 대화 흐름을 방지하고 안정적인 음성 에이전트 동작을 보장합니다. Claude Code 및 Codex 환경에서 바로 사용 가능하며, 플레이북 작성 시 일관성과 정확성을 높이는 데 유용합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add ankitai-s/superdialog-playbook-skill

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

superdialog-playbook-skill은(는) 무엇을 하나요?

Claude Code / Codex 스킬 — SuperDialog 음성 에이전트 플레이북 YAML 작성 및 검토를 위한 도구입니다. 스키마 참조, 15가지 실패 패턴 체크리스트, 인터럽트 가드 코드 패턴을 제공합니다.

개요

SuperDialog는 고급 음성 대화 에이전트를 구축하기 위한 프레임워크입니다. 이 스킬은 올바른 YAML 구조를 유지하면서 플레이북을 효율적으로 작성하고, 일반적인 오류를 사전에 방지할 수 있도록 설계되었습니다.

지원 플랫폼

주요 기능

  1. 스키마 참조 — SuperDialog 플레이북 YAML의 필수 필드와 선택 필드, 데이터 타입, 중첩 구조를 문서화합니다.
  2. 15가지 실패 패턴 체크리스트 — 음성 에이전트에서 자주 발생하는 문제(예: 무한 루프, 불완전한 컨텍스트 전환, 잘못된 상태 관리)를 점검합니다.
  3. 인터럽트 가드 코드 패턴 — 비정상적인 사용자 입력이나 시스템 상태 변화에 대응하는 코드 템플릿을 제공합니다.

사용 방법

Claude Code 또는 Codex에서 이 스킬을 활성화하고, SuperDialog 플레이북 YAML 파일을 열거나 새로 작성할 때 다음과 같이 요청하세요:

SuperDialog 플레이북 검토:
- 현재 YAML의 스키마 유효성 검사
- 15가지 실패 패턴 체크리스트 적용
- 인터럽트 가드 코드 패턴 추가

예시

# 기본 SuperDialog 플레이북 구조
playbook:
  name: 고객 지원 에이전트
  version: 1.0
  intents:
    - 인사
    - 문의
    - 종료
  flows:
    - step: 환영
      action: say
      text: "안녕하세요, 무엇을 도와드릴까요?"
    - step: 대기
      action: listen
      timeout: 10s

라이선스

MIT

관련 스킬