Primitivas de personalização
Escolha a menor primitiva que forneça de forma confiável o comportamento ausente.
---
config:
theme: base
look: classic
themeVariables:
darkMode: false
background: "#ffffff"
primaryColor: "#f5f5f5"
primaryTextColor: "#111111"
primaryBorderColor: "#555555"
secondaryColor: "#e0e0e0"
secondaryTextColor: "#111111"
secondaryBorderColor: "#666666"
tertiaryColor: "#bdbdbd"
tertiaryTextColor: "#111111"
tertiaryBorderColor: "#444444"
lineColor: "#444444"
textColor: "#111111"
mainBkg: "#f5f5f5"
nodeBorder: "#555555"
clusterBkg: "#ffffff"
clusterBorder: "#999999"
edgeLabelBackground: "#ffffff"
actorBkg: "#e0e0e0"
actorBorder: "#555555"
actorTextColor: "#111111"
actorLineColor: "#777777"
signalColor: "#333333"
signalTextColor: "#111111"
labelBoxBkgColor: "#f5f5f5"
labelBoxBorderColor: "#777777"
labelTextColor: "#111111"
loopTextColor: "#111111"
activationBkgColor: "#bdbdbd"
activationBorderColor: "#555555"
noteBkgColor: "#f5f5f5"
noteTextColor: "#111111"
noteBorderColor: "#777777"
attributeBackgroundColorOdd: "#f5f5f5"
attributeBackgroundColorEven: "#e0e0e0"
---
flowchart TD
accTitle: Selecionar a menor primitiva de personalização
accDescr: Decida se o contexto é automático e escolha um prompt de tarefa, uma skill reutilizável, um perfil de papel, uma capacidade externa ou uma verificação determinística.
N["O que está faltando?"] --> A{"Aplicar automaticamente?"}
A -- Sim --> I["Instruções"]
A -- Não --> K{"Qual é o tipo de necessidade?"}
K -- Comando repetível --> P["Arquivo de prompt"]
K -- Conhecimento especializado reutilizável --> S["Agent Skill"]
K -- Papel + ferramentas --> C["Agente personalizado"]
K -- Capacidade externa --> M["Servidor MCP"]
K -- Aplicação determinística de regras --> H["Hook"]
Legenda. Os losangos são perguntas de seleção. As setas rotuladas descrevem a necessidade; os retângulos são as primitivas de personalização.
Explicação. Escolha com base na responsabilidade e na forma de invocação, não na sofisticação percebida. Uma skill não é um limite de permissão e um prompt não é contexto aplicado automaticamente.
| Necessidade | Primitiva | Limite principal |
|---|---|---|
| Contexto aplicado automaticamente | Instruções do repositório ou específicas por caminho | Mantenha o escopo explícito e evite conflitos |
| Um modelo de tarefa invocado manualmente | Arquivo de prompt | A invocação local é intencional, não automática |
| Conhecimento especializado reutilizável carregado quando relevante | Agent Skill | Conhecimento especializado não é uma persona permanente |
| Um papel com ferramentas e transferências opcionais | Agente personalizado (.agent.md) |
O acesso a ferramentas e as transferências devem ser explícitos |
| Acesso a um sistema externo | Servidor Model Context Protocol | Confiança, autenticação, exposição de dados e efeitos colaterais variam |
| Um comando determinístico de ciclo de vida | Hook | O esquema em versão prévia (Preview), a segurança do shell, o tempo limite e o tratamento de segredos importam |
[!IMPORTANT] Arquivos de prompt têm suporte no harness VS Code Local, mas agentes executados no Agent Host não os utilizam. Use uma Agent Skill quando o comportamento precisar ser levado ao Copilot harness.
[!WARNING] Os hooks de agentes no VS Code estão em versão prévia (Preview) em 2026-09-05. Revise cada comando, entrada, saída, tempo limite e caminho de exposição de segredos.
Portabilidade
| Primitiva | VS Code Local | Copilot harness / Agent Host | Copilot CLI | Cloud agent |
|---|---|---|---|---|
| Instruções | Sim, conforme o escopo | Sim, conforme a descoberta | Sim, conforme a descoberta | Sim, aplicam-se os locais documentados |
| Arquivos de prompt | Sim | Não | Não presuma | Não presuma |
| Agent Skills | Sim | Sim | Sim | Sim |
| Agentes personalizados | Sim | Sim | Sim | Sim, com diferenças nas propriedades |
| MCP | Sim | Use configuração portável | Sim | O suporte e a política variam |
| Hooks | Versão prévia (Preview) | Versão prévia (Preview) | O suporte documentado varia | O suporte documentado varia |
Não use modos de chat personalizados obsoletos como substitutos de agentes personalizados. MCP significa Model Context Protocol.
Pratique com Leis de Eldoria, Skills de Algora e Agentes de Stellaris.