Criador de Habilidades da Microsoft

Crie habilidades híbridas para tecnologias da Microsoft que armazenam conhecimento essencial localmente, permitindo consultas dinâmicas ao Learn MCP para detalhes mais aprofundados.

Sobre Habilidades

Habilidades são pacotes modulares que estendem as capacidades de um agente com conhecimento e fluxos de trabalho especializados. Uma habilidade transforma um agente de propósito geral em um especializado para um domínio específico.

Estrutura da Habilidade

skill-name/
├── SKILL.md (required)     # Frontmatter (name, description) + instructions
├── references/             # Documentation loaded into context as needed
├── sample_codes/           # Working code examples
└── assets/                 # Files used in output (templates, etc.)

Princípios Chave

• Frontmatter é crítico: name e description determinam quando a habilidade é acionada — seja claro e abrangente
• Conciso é fundamental: Inclua apenas o que os agentes ainda não sabem; a janela de contexto é compartilhada
• Sem duplicação: A informação reside em SKILL.md OU em arquivos de referência, não em ambos

Ferramentas do Learn MCP

Alternativa CLI

Se o servidor Learn MCP não estiver disponível, use a CLI mslearn de um terminal ou shell (por exemplo, Bash, PowerShell ou cmd) em vez disso:

# Run directly (no install needed)
npx @microsoft/learn-cli search "semantic kernel overview"

# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "semantic kernel overview"

As habilidades geradas devem incluir esta mesma tabela de fallback CLI para que os agentes possam usar qualquer um dos caminhos.

Processo de Criação

Etapa 1: Investigar o Tópico

Construa um entendimento profundo usando as ferramentas do Learn MCP em três fases:

Fase 1 - Descoberta do Escopo:

microsoft_docs_search(query="{technology} overview what is")
microsoft_docs_search(query="{technology} concepts architecture")
microsoft_docs_search(query="{technology} getting started tutorial")

Fase 2 - Conteúdo Principal:

microsoft_docs_fetch(url="...")  # Fetch pages from Phase 1
microsoft_code_sample_search(query="{technology}", language="{lang}")

Fase 3 - Profundidade:

microsoft_docs_search(query="{technology} best practices")
microsoft_docs_search(query="{technology} troubleshooting errors")

Checklist de Investigação

Após investigar, verifique:

• Consegue explicar o que a tecnologia faz em um parágrafo
• Identificou 3-5 conceitos chave
• Possui código funcional para uso básico
• Conhece os padrões de API mais comuns
• Possui consultas de pesquisa para tópicos mais aprofundados

Etapa 2: Clarificar com o Usuário

Apresente os achados e pergunte:

1. "Encontrei estas áreas chave: [lista]. Quais são as mais importantes?"
2. "Quais tarefas os agentes realizarão principalmente com esta habilidade?"
3. "Qual linguagem de programação os exemplos de código devem priorizar?"

Etapa 3: Gerar a Habilidade

Use o template apropriado de skill-templates.md:

Estrutura da Habilidade Gerada

{skill-name}/
├── SKILL.md                    # Core knowledge + Learn MCP guidance
├── references/                 # Detailed local documentation (if needed)
└── sample_codes/               # Working code examples
    ├── getting-started/
    └── common-patterns/

Etapa 4: Equilibrar Conteúdo Local vs. Dinâmico

Armazene localmente quando:

• Fundamental (necessário para qualquer tarefa)
• Acessado frequentemente
• Estável (não mudará)
• Difícil de encontrar via pesquisa

Mantenha dinâmico quando:

• Referência exaustiva (muito grande)
• Específico da versão
• Situacional (apenas tarefas específicas)
• Bem indexado (fácil de pesquisar)

Diretrizes de Conteúdo

…