ankitai-s/superdialog-playbook-skill

O que superdialog-playbook-skill faz?

Habilidade para Claude Code / Codex para criar e revisar playbooks YAML de agentes de voz SuperDialog — referência de schema, checklist de 15 pontos de padrões de falha e padrão de código para proteção de interrupção.

Descrição

Esta habilidade auxilia no desenvolvimento de playbooks YAML para agentes de voz SuperDialog, fornecendo:

• Referência completa do schema YAML do SuperDialog.
• Checklist de 15 pontos para identificar padrões de falha comuns.
• Padrão de código para proteção contra interrupções.

Compatibilidade

• Claude Code
• Codex

Uso

1. Criação de Playbook: Use a habilidade para gerar playbooks YAML a partir de descrições em linguagem natural.
2. Revisão de Playbook: Cole o YAML do playbook e solicite uma revisão. A habilidade aplicará o checklist de 15 pontos.
3. Correção de Padrões de Falha: A habilidade identifica e sugere correções para padrões como:
   • Loops infinitos
   • Tratamento incorreto de contexto
   • Ausência de timeouts
   • Proteção de interrupção inadequada

Exemplo de Requisição

Revise este playbook YAML do SuperDialog e aplique o checklist de 15 pontos de padrões de falha.

```yaml
playbook:
  name: MeuAgenteVoz
  steps:
    - prompt: "Como posso ajudar?"
      input: voz
      actions:
        - type: resposta
          mensagem: "Você disse {{input}}"

## Checklist de 15 Pontos

1. Verificar se todos os prompts têm timeout configurado.
2. Garantir que ações de interrupção estão definidas.
3. Confirmar que variáveis de contexto são inicializadas.
4. Validar que não há loops infinitos sem condição de saída.
5. Assegurar que a resposta de fallback está presente.
6. Verificar se o tratamento de erros cobre todos os cenários.
7. Garantir que a proteção de interrupção usa o padrão correto.
8. Validar que os nomes das intenções seguem a convenção.
9. Confirmar que as ações de saída estão definidas.
10. Verificar se as transições entre estados são válidas.
11. Garantir que o schema YAML está bem formado.
12. Validar que não há dependências circulares.
13. Assegurar que as mensagens de erro são amigáveis.
14. Verificar se a lógica de repetição está limitada.
15. Confirmar que o playbook é compatível com a versão alvo do SuperDialog.

## Padrão de Código para Proteção de Interrupção

```yaml
playbook:
  name: AgenteComProtecaoInterrupcao
  steps:
    - prompt: "Fale sua mensagem"
      input: voz
      timeout: 5000  # 5 segundos
      on_interrupt:
        - type: resposta
          mensagem: "Entendi, interrompendo."
        - type: aguardar
          duracao: 100
      actions:
        - type: resposta
          mensagem: "Você disse {{input}}"

Referência de Schema

Para uma referência completa do schema YAML do SuperDialog, consulte a documentação oficial.

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.