Skip to content

Funcionalidades da Plataforma

Este capítulo explica em profundidade os módulos de funcionalidades principais do OpenCode Agent Skills, incluindo descoberta de skills, consulta, carregamento, recomendação automática, execução de scripts e leitura de arquivos. Após dominar estas funcionalidades, você poderá aproveitar ao máximo a capacidade de gerenciamento de skills do plugin, permitindo que a AI sirva seu trabalho de desenvolvimento com maior eficiência.

Pré-requisitos

Antes de começar, confirme

Antes de estudar este capítulo, certifique-se de ter completado:

Conteúdo do Capítulo

CursoDescriçãoFerramenta Principal
Mecanismo de Descoberta de SkillsEntender de quais posições o plugin descobre skills automaticamente, dominar regras de prioridade-
Consultar e Listar Skills DisponíveisUsar ferramenta get_available_skills para buscar e filtrar skillsget_available_skills
Carregar Skills no Contexto da SessãoUsar ferramenta use_skill para carregar skills, entender mecanismo de injeção XMLuse_skill
Recomendação Automática de SkillsEntender princípio de correspondência semântica, permitir que a AI descubra skills relevantes automaticamente-
Executar Scripts de SkillsUsar ferramenta run_skill_script para executar scripts automatizadosrun_skill_script
Ler Arquivos de SkillsUsar ferramenta read_skill_file para acessar arquivos de suporte de skillsread_skill_file

Caminho de Aprendizado

┌─────────────────────────────────────────────────────────────────────────┐
│                        Ordem de Aprendizado Recomendada                   │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   1. Mecanismo de Descoberta  ──→  2. Listar Skills  ──→  3. Carregar Skills │
│         │                     │                    │                    │
│         │                     │                    │                    │
│         ▼                     ▼                    ▼                    │
│   Entender de onde vêm skills      Aprender buscar skills      Dominar método de carregamento │
│                                                                         │
│                              │                                          │
│                              ▼                                          │
│                                                                         │
│   4. Recomendação Automática  ←──  5. Executar Scripts  ←──  6. Ler Arquivos │
│         │                    │                  │                       │
│         ▼                    ▼                  ▼                       │
│   Entender correspondência inteligente      Executar automação      Acessar arquivos de suporte │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Recomenda-se estudar em ordem:

  1. Primeiro aprenda o mecanismo de descoberta - Entender de onde vêm as skills, como a prioridade é determinada
  2. Depois aprenda a consultar skills - Dominar o uso da ferramenta get_available_skills
  3. Então aprenda a carregar skills - Entender use_skill e o mecanismo de injeção XML
  4. Em seguida aprenda a recomendação automática - Entender como funciona a correspondência semântica (opcional, mais focado em princípios)
  5. Finalmente aprenda scripts e arquivos - Estas duas são funcionalidades avançadas, aprenda conforme necessário

Caminho Rápido

Se você só quer começar rapidamente, pode estudar apenas os três primeiros cursos (Descoberta → Consulta → Carregamento), os outros preencha conforme necessário.

Próximos Passos

Após completar este capítulo, você pode continuar aprendendo:

  • Funcionalidades Avançadas - Entenda em profundidade compatibilidade com Claude Code, integração com Superpowers, prioridade de namespaces e outros tópicos avançados
  • Perguntas Frequentes - Consulte solução de problemas e instruções de segurança quando encontrar problemas
  • Apêndice - Consulte referência de API e melhores práticas