Introdução

Nos últimos meses, a conversa sobre agentes de IA mudou de nível. Primeiro falamos de prompts. Depois falamos de custom instructions, arquivos AGENTS.md, CLAUDE.md, copilot-instructions.md, MCP servers e modos agênticos. Agora, um conceito começa a organizar melhor tudo isso: Skills.

Um Skill é uma capacidade reutilizável. Em vez de explicar toda vez como revisar uma integração, criar testes, validar uma alteração X++ ou preparar uma análise de performance, você empacota esse conhecimento em um diretório com instruções, exemplos, scripts e referências. O agente carrega esse conhecimento quando a tarefa pede.

Para times técnicos, isso muda a forma de trabalhar com IA. O Skill transforma um bom prompt em um ativo versionado do time.

Para quem trabalha com Microsoft Dynamics 365 Finance & Operations, a ideia é ainda mais importante. D365 F&O exige processo, governança, extensibilidade, segurança, performance, integração, batch, data entities, X++, testes e validação funcional. Um agente genérico pode ajudar, mas um agente orientado por Skills consegue trabalhar muito mais próximo do padrão que o time precisa.

Este artigo explica:

  • O que são Skills.
  • Por que eles são diferentes de prompts e instruções globais.
  • Como aplicar Skills no Claude Code.
  • Como aplicar Skills no GitHub Copilot.
  • Onde cada ferramenta se encaixa.
  • Como criar Skills práticos para D365 F&O, ERP, integração e revisão técnica.
  • Quais cuidados de segurança e governança você deve ter antes de adotar isso em equipe.

O Que é um Skill?

Um Skill é um pacote de instruções que ensina um agente de IA a executar uma tarefa especializada de forma consistente.

Na prática, ele costuma ser uma pasta com um arquivo principal chamado SKILL.md:

my-skill/
├── SKILL.md
├── references/
│   └── guidelines.md
├── examples/
│   └── expected-output.md
├── templates/
│   └── report-template.md
└── scripts/
    └── validate.py

O SKILL.md contém metadados e instruções:

---
name: d365fo-code-review
description: Revisa alterações em Dynamics 365 Finance & Operations com foco em X++, extensibilidade, performance, integrações, segurança e testes.
---

# D365 F&O Code Review

Use este Skill quando revisar código X++, Chain of Command, event handlers, data entities, batch jobs ou integrações D365 F&O.

## Processo

1. Identifique o processo de negócio afetado.
2. Verifique se a abordagem usa extensibilidade suportada.
3. Revise transações, queries, loops e batch.
4. Revise segurança, roles, privileges e dados sensíveis.
5. Sugira testes técnicos e funcionais.
6. Liste riscos e perguntas abertas.

Esse arquivo faz duas coisas:

  • Ajuda o agente a descobrir quando usar a capacidade.
  • Ensina o agente como executar a tarefa.

Essa distinção é essencial. Um Skill não é apenas documentação. Ele é documentação feita para ser usada por um agente.

Por Que Skills São Importantes

1. Reduzem repetição

Se você sempre cola o mesmo checklist no chat, aquilo é candidato a Skill.

Exemplos:

  • “Revise este PR como arquiteto D365 F&O.”
  • “Gere plano de testes SysTest e funcional.”
  • “Analise esta integração OData.”
  • “Prepare uma descrição de PR com riscos e evidências.”
  • “Explique esta customização para um consultor funcional.”

Sem Skill, você repete a instrução. Com Skill, você versiona o procedimento.

2. Padronizam a qualidade

Um prompt bom na mão de uma pessoa não escala. Um Skill versionado escala.

Ele ajuda o time a responder sempre no mesmo formato:

  • Resumo funcional.
  • Achados por severidade.
  • Impacto técnico.
  • Impacto de negócio.
  • Testes recomendados.
  • Riscos.
  • Perguntas abertas.

Isso melhora revisão técnica, onboarding e governança.

3. Capturam conhecimento tácito

Todo time tem conhecimento que vive na cabeça de poucas pessoas:

  • “Aqui não usamos overlayering.”
  • “Batch com volume alto precisa ser idempotente.”
  • “Essa integração não pode usar OData para carga massiva.”
  • “Sempre validar impacto em localização Brasil.”
  • “Nunca aceitar Chain of Command sem revisar o next.”

Skills transformam esse conhecimento em instrução reutilizável.

4. Economizam contexto

Um problema clássico em agentes é excesso de contexto. Se você coloca tudo em um arquivo global como CLAUDE.md, AGENTS.md ou copilot-instructions.md, o agente pode carregar instruções demais mesmo quando não precisa.

Skills ajudam com carregamento sob demanda. O agente vê a descrição do Skill e só carrega o corpo completo quando a tarefa combina. Isso permite manter materiais longos, exemplos e referências sem poluir toda conversa.

5. Aproximam IA de processo real

IA aplicada a ERP não pode ser só geração de código. Ela precisa respeitar processo, dados e operação.

Um Skill bem escrito pode exigir que o agente sempre pergunte:

  • Qual módulo D365 F&O está envolvido?
  • Qual legal entity?
  • Qual volume esperado?
  • Existe integração?
  • Existe impacto fiscal?
  • Qual evidência o key user precisa validar?

Esse tipo de disciplina reduz respostas genéricas.

Skill, Prompt, Instrução Global e MCP: Qual a Diferença?

Recurso Melhor uso
Prompt Pedido pontual em uma conversa
Instrução global Regras gerais do projeto ou do usuário
Skill Procedimento reutilizável para uma tarefa especializada
MCP Conectar agente a ferramentas e fontes externas
Subagente Separar papel ou modo de trabalho

Uma regra prática:

  • Use prompt quando a tarefa é única.
  • Use instrução global quando a regra vale quase sempre.
  • Use Skill quando a tarefa é repetível e tem passos.
  • Use MCP quando o agente precisa acessar ferramentas ou dados externos.
  • Use subagente quando a tarefa precisa de outro papel, contexto ou isolamento.

Exemplo em D365 F&O:

  • Instrução global: “Não sugerir overlayering.”
  • Skill: “Revisar uma alteração D365 F&O seguindo checklist técnico e funcional.”
  • MCP: “Consultar issues do GitHub, documentação interna ou backlog.”
  • Subagente: “Fazer uma exploração independente de impacto técnico.”

Como Aplicar Skills no Claude Code

O Claude Code oferece um caminho bem direto para Skills. A documentação oficial descreve Skills como diretórios com SKILL.md, instruções e arquivos opcionais. Claude pode usar o Skill automaticamente quando relevante, ou você pode invocá-lo diretamente com /skill-name.

Onde salvar

Skills pessoais:

~/.claude/skills/<skill-name>/SKILL.md

Skills do projeto:

.claude/skills/<skill-name>/SKILL.md

Use Skills pessoais para seus próprios hábitos. Use Skills do projeto para padrões compartilhados com o time e versionados no repositório.

Exemplo de criação

.claude/
└── skills/
    └── d365fo-review/
        ├── SKILL.md
        ├── references/
        │   └── d365fo-checklist.md
        └── templates/
            └── review-output.md

SKILL.md:

---
name: d365fo-review
description: Revisa código, extensões e integrações de Dynamics 365 Finance & Operations. Use quando o usuário pedir revisão de X++, Chain of Command, event handlers, data entities, batch jobs, OData, custom services ou impacto funcional em D365 F&O.
---

# D365 F&O Review

Você é um revisor técnico especializado em Dynamics 365 Finance & Operations.

## Antes de revisar

Identifique:

- Módulo afetado.
- Artefato alterado.
- Processo de negócio.
- Ponto de extensão.
- Volume esperado.
- Legal entity.
- Integrações envolvidas.
- Evidência de teste disponível.

## Checklist

1. Verifique extensibilidade suportada.
2. Procure overlayering ou acoplamento indevido.
3. Revise Chain of Command e chamada a `next`.
4. Revise transações X++.
5. Procure queries dentro de loops.
6. Avalie batch, retry, idempotência e logs.
7. Revise segurança, roles, duties e privileges.
8. Avalie impacto em data entities e integrações.
9. Avalie impacto em localização Brasil.
10. Sugira SysTest e testes funcionais.

## Saída

Responda neste formato:

1. Resumo funcional.
2. Achados por severidade.
3. Correções recomendadas.
4. Testes recomendados.
5. Perguntas abertas.

Depois de salvo, você pode pedir:

/d365fo-review revise a alteração atual

Ou deixar Claude decidir usar automaticamente quando a descrição combinar com o pedido.

Quando usar disable-model-invocation

No Claude Code, alguns Skills devem ser invocados apenas pelo usuário. Isso é importante para tarefas sensíveis, como deploy, commit, alteração em banco, upload ou comandos que mexem no ambiente.

Exemplo:

---
name: deploy-check
description: Executa checklist pré-deploy do projeto.
disable-model-invocation: true
---

Com isso, o Skill não é chamado automaticamente pelo modelo. Você invoca quando quiser.

Quando usar allowed-tools

Claude Code permite configurar ferramentas pré-aprovadas no frontmatter do Skill. Isso é útil para automatizar tarefas seguras sem pedir aprovação a cada passo.

Exemplo read-only:

---
name: d365fo-readonly-explorer
description: Explora código D365 F&O de forma somente leitura. Use para localizar classes, tabelas, handlers, entidades e referências sem modificar arquivos.
allowed-tools: Read Grep Glob
---

O princípio: quanto mais sensível a tarefa, mais conservador deve ser o Skill.

Para um Skill de revisão, read-only costuma ser suficiente. Para um Skill que edita arquivos, rode testes ou cria commits, limite bem o escopo.

Como Aplicar Skills no GitHub Copilot

O GitHub Copilot também adotou Agent Skills. A documentação oficial descreve Agent Skills como pastas com instruções, scripts e recursos que o Copilot pode carregar quando relevantes para melhorar tarefas especializadas.

O ponto importante: no momento desta análise, os Agent Skills do Copilot funcionam com:

  • Copilot cloud agent.
  • GitHub Copilot CLI.
  • Agent mode no Visual Studio Code.

Isso significa que, se você usa Copilot dentro do Visual Studio 2022, talvez ainda precise usar caminhos complementares como copilot-instructions.md, prompt files e MCP. Para Copilot cloud agent, CLI e VS Code agent mode, Skills já entram diretamente no fluxo documentado.

Onde salvar

Skills de projeto:

.github/skills/<skill-name>/SKILL.md
.claude/skills/<skill-name>/SKILL.md
.agents/skills/<skill-name>/SKILL.md

Skills pessoais:

~/.copilot/skills/<skill-name>/SKILL.md
~/.agents/skills/<skill-name>/SKILL.md

Essa compatibilidade é interessante: um mesmo desenho de Skill pode ser reutilizado por diferentes agentes, desde que você mantenha o formato simples e evite recursos exclusivos de uma ferramenta quando quiser portabilidade.

Exemplo para Copilot

.github/
└── skills/
    └── d365fo-integration-review/
        ├── SKILL.md
        ├── references/
        │   └── integration-patterns.md
        └── templates/
            └── findings.md

SKILL.md:

---
name: d365fo-integration-review
description: Revisa integrações com Dynamics 365 Finance & Operations. Use quando avaliar OData, data entities, custom services, recurring integrations, business events, Azure Functions, Service Bus ou integrações ERP com volume, retry e segurança.
---

# D365 F&O Integration Review

Avalie a integração considerando:

1. Contrato de dados.
2. Volume e latência.
3. Autenticação e autorização.
4. Idempotência.
5. Retry e tratamento de erro.
6. Observabilidade e logs.
7. Impacto em batch ou processamento assíncrono.
8. Segurança de dados.
9. Escolha entre OData, data entity, recurring integration, custom service e business events.

## Saída

Use este formato:

- Cenário resumido.
- Abordagem atual.
- Riscos.
- Alternativas.
- Recomendação.
- Testes e monitoramento.

No Copilot cloud agent, esse Skill pode orientar uma tarefa de revisão em uma issue ou PR. No Copilot CLI, pode orientar uma análise local. No VS Code agent mode, pode ser usado durante edição e investigação de código.

Claude Code vs GitHub Copilot: Diferenças Práticas

Tema Claude Code GitHub Copilot
Arquivo principal SKILL.md SKILL.md
Skills de projeto .claude/skills .github/skills, .claude/skills, .agents/skills
Skills pessoais ~/.claude/skills ~/.copilot/skills, ~/.agents/skills
Invocação direta /skill-name Depende do host, cloud agent/CLI/VS Code agent mode
Invocação automática Sim, pela descrição Sim, quando relevante ao agente
Recursos específicos allowed-tools, disable-model-invocation, argumentos, subagentes Integração com cloud agent, CLI, repositório e PRs
Melhor encaixe Trabalho local profundo no código Fluxos GitHub, issues, PRs, CLI e agent mode

Minha recomendação prática:

  • Use Claude Code Skills para workflows locais ricos, investigação de código, refatoração e automações controladas.
  • Use GitHub Copilot Skills para padronizar tarefas em repositórios, issues, PRs e agentes do ecossistema GitHub.
  • Escreva Skills portáveis sempre que possível.
  • Use recursos exclusivos apenas quando realmente precisar.

O Que Colocar em um Bom Skill

Um bom Skill deve responder cinco perguntas:

  1. Quando usar?
  2. Qual contexto precisa coletar?
  3. Qual processo seguir?
  4. Qual saída entregar?
  5. Quais limites não pode cruzar?

Modelo:

---
name: nome-do-skill
description: O que este Skill faz e quando deve ser usado.
---

# Nome do Skill

## Quando usar

Use quando...

## Contexto necessário

Antes de agir, identifique...

## Processo

1. Primeiro passo.
2. Segundo passo.
3. Terceiro passo.

## Formato de saída

Responda com...

## Restrições

- Não fazer...
- Não assumir...
- Pedir confirmação quando...

## Exemplos

Entrada:
...

Saída esperada:
...

Não comece criando um Skill gigante. Comece pequeno, use em tarefas reais, ajuste e versione.

Skills Práticos Para Times D365 F&O

1. Skill de revisão técnica D365 F&O

Use para revisar X++, CoC, handlers, tabelas, forms, entidades e batch.

Foco:

  • Extensibilidade.
  • Transações.
  • Performance.
  • Segurança.
  • Testes SysTest.
  • Impacto funcional.

2. Skill de revisão de integração ERP

Use para OData, data entities, recurring integrations, custom services, business events, Azure Functions e Service Bus.

Foco:

  • Volume.
  • Latência.
  • Idempotência.
  • Retry.
  • Autenticação.
  • Logs.
  • Monitoramento.
  • Contrato de dados.

3. Skill de testes D365 F&O

Use para transformar alteração técnica em plano de testes.

Foco:

  • SysTest.
  • Teste funcional.
  • Dados mínimos.
  • Teste de regressão.
  • Evidência para key user.
  • Cenários negativos.

4. Skill de documentação funcional

Use para transformar código em explicação de negócio.

Foco:

  • Processo impactado.
  • O que muda para o usuário.
  • Configuração envolvida.
  • Riscos.
  • Dados de teste.
  • Critérios de aceite.

5. Skill de PR técnico

Use para criar descrição de PR com qualidade.

Foco:

  • Resumo.
  • Motivação.
  • Mudanças.
  • Riscos.
  • Testes executados.
  • Evidências.
  • Pontos para reviewer.

Exemplo Completo: Skill de Testes D365 F&O

---
name: d365fo-test-plan
description: Cria plano de testes técnico e funcional para alterações em Dynamics 365 Finance & Operations. Use quando houver mudança em X++, extensão, integração, batch, data entity, processo financeiro, SCM ou localização Brasil.
---

# D365 F&O Test Plan

## Objetivo

Criar um plano de testes que cubra validação técnica e funcional da alteração.

## Contexto necessário

Antes de gerar o plano, identifique:

- Módulo afetado.
- Processo de negócio.
- Artefato alterado.
- Ponto de extensão.
- Dados necessários.
- Integrações impactadas.
- Legal entity.
- Perfil de usuário.
- Risco principal.

## Processo

1. Resuma a alteração em linguagem funcional.
2. Liste pré-condições.
3. Liste dados mínimos.
4. Crie cenários SysTest quando aplicável.
5. Crie cenários funcionais para key user.
6. Crie cenários negativos.
7. Crie testes de regressão.
8. Liste evidências esperadas.

## Saída

Use o formato:

### Resumo funcional

### Pré-condições

### Dados necessários

### Testes técnicos

| Cenário | Objetivo | Resultado esperado |
|---|---|---|

### Testes funcionais

| Passo | Ação | Resultado esperado | Evidência |
|---|---|---|---|

### Riscos

### Perguntas abertas

## Restrições

- Não invente APIs.
- Não assuma configuração que não foi informada.
- Se faltar contexto fiscal, liste perguntas para o consultor funcional.
- Se houver integração, inclua teste de erro, retry e reprocessamento.

Esse Skill é simples, mas já muda o jogo. Ele tira o agente do modo “gerar texto bonito” e coloca no modo “produzir evidência útil para projeto”.

Exemplo Completo: Skill de Revisão de Integração

---
name: d365fo-integration-risk-review
description: Avalia riscos de integração com Dynamics 365 Finance & Operations. Use para OData, data entities, custom services, business events, recurring integrations, Azure Functions, Logic Apps, Service Bus e integrações com sistemas externos.
---

# D365 F&O Integration Risk Review

## Contexto necessário

Identifique:

- Sistema origem.
- Sistema destino.
- Direção da integração.
- Volume diário.
- Latência esperada.
- Tipo de autenticação.
- Estratégia de retry.
- Estratégia de idempotência.
- Monitoramento disponível.
- Dono funcional do processo.

## Processo

1. Classifique o cenário: consulta, carga, evento, comando ou sincronização.
2. Avalie se o padrão de integração escolhido é adequado.
3. Revise contrato de dados.
4. Revise autenticação e autorização.
5. Revise tratamento de erro.
6. Revise reprocessamento.
7. Revise logs e suporte.
8. Revise impacto no D365 F&O.
9. Sugira testes.

## Saída

Responda com:

- Diagnóstico.
- Riscos críticos.
- Riscos médios.
- Melhorias recomendadas.
- Alternativas de arquitetura.
- Testes e monitoramento.
- Perguntas abertas.

Esse tipo de Skill é excelente para consultorias, porque cria consistência entre projetos.

Exemplos de Skills Para Desenvolvedor D365 F&O em X++

Para desenvolvedores D365 F&O, Skills precisam sair do genérico. Um bom Skill para X++ deve falar a língua do produto: extensibilidade, Chain of Command, event handlers, tabelas, forms, data entities, transações, batch, SysTest, segurança e impacto funcional.

Abaixo estão exemplos práticos que podem ser usados no Claude Code, GitHub Copilot ou adaptados para prompt files.

Skill 1: Revisão de Chain of Command em X++

Use este Skill quando o desenvolvedor criar ou alterar uma extensão por Chain of Command.

---
name: d365fo-xpp-coc-review
description: Revisa implementações Chain of Command em X++ para Dynamics 365 Finance & Operations. Use quando houver extensão de classe, tabela ou form com CoC, chamada a next, alteração de parâmetros, retorno ou regra antes/depois do método base.
---

# D365 F&O X++ Chain of Command Review

## Objetivo

Revisar se a implementação Chain of Command é segura, suportada e funcionalmente correta.

## Contexto necessário

Antes de revisar, identifique:

- Classe, tabela ou form estendido.
- Método original.
- Módulo D365 F&O afetado.
- Processo de negócio impactado.
- Motivo da customização.
- Se a lógica roda antes ou depois do `next`.
- Volume esperado.
- Teste funcional disponível.

## Checklist técnico

1. Verifique se CoC é o ponto de extensão adequado.
2. Confirme se `next` é chamado quando necessário.
3. Avalie se a lógica antes do `next` pode bloquear comportamento padrão indevidamente.
4. Avalie se a lógica depois do `next` depende de retorno ou estado alterado pelo método base.
5. Procure alteração perigosa em parâmetros.
6. Procure efeitos colaterais não documentados.
7. Verifique transações e locks.
8. Verifique se existe alternativa por event handler.
9. Avalie risco em updates futuros da Microsoft.
10. Sugira testes SysTest e testes funcionais.

## Saída

Responda com:

### Resumo funcional

### Veredito

- Adequado
- Adequado com ajustes
- Risco alto

### Achados

| Severidade | Problema | Impacto | Correção |
|---|---|---|---|

### Testes recomendados

### Perguntas abertas

## Restrições

- Não sugerir overlayering.
- Não remover `next` sem justificar claramente.
- Não assumir comportamento funcional sem evidência.

Exemplo de uso:

/d365fo-xpp-coc-review revise esta extensão de SalesTableType.validateWrite()

Skill 2: Revisão de Transações X++

Use este Skill para revisar código com ttsBegin, ttsCommit, select forUpdate, update, insert, delete ou processamento de múltiplos registros.

---
name: d365fo-xpp-transaction-review
description: Revisa integridade transacional em X++ para Dynamics 365 Finance & Operations. Use quando houver ttsBegin, ttsCommit, forUpdate, update, insert, delete, doUpdate, transações longas ou processamento em lote.
---

# D365 F&O X++ Transaction Review

## Objetivo

Evitar inconsistência de dados, locks desnecessários e erros de escopo transacional.

## Contexto necessário

Identifique:

- Tabelas alteradas.
- Volume de registros.
- Se roda em tela, serviço, batch ou integração.
- Se há chamadas externas.
- Se há retry ou reprocessamento.
- Se existe risco de concorrência.

## Checklist

1. Verifique se registros atualizados foram selecionados com `forUpdate`.
2. Verifique se update ocorre no mesmo escopo transacional esperado.
3. Procure `ttsBegin` muito amplo.
4. Procure chamada externa dentro de transação.
5. Procure `while select forUpdate` com volume alto.
6. Verifique se exceções deixam o sistema em estado consistente.
7. Avalie se há risco de deadlock.
8. Avalie se a lógica deveria processar em lotes menores.
9. Verifique se a transação respeita legal entity e `DataAreaId`.
10. Sugira testes positivos, negativos e de concorrência.

## Saída

Forneça:

- Resumo do fluxo transacional.
- Riscos encontrados.
- Correção recomendada.
- Versão alternativa do código, se necessário.
- Testes recomendados.

## Restrições

- Não sugerir update fora de transação quando houver risco de consistência.
- Não sugerir transação longa sem justificar.
- Não esconder risco de concorrência.

Exemplo de prompt:

Use o Skill d365fo-xpp-transaction-review para revisar este job X++ que atualiza CustTable em massa.

Skill 3: Criação de Batch X++ Seguro

Use quando o time precisa criar uma classe batch, revisar uma rotina recorrente ou transformar processamento manual em batch.

---
name: d365fo-xpp-batch-design
description: Ajuda a desenhar e revisar batch jobs em X++ para Dynamics 365 Finance & Operations, com foco em idempotência, retry, logs, volume, paralelismo, transações curtas e operação segura.
---

# D365 F&O X++ Batch Design

## Objetivo

Criar ou revisar batch jobs prontos para operação real em D365 F&O.

## Contexto necessário

Pergunte ou identifique:

- Processo de negócio.
- Volume esperado.
- Frequência de execução.
- Critério de seleção dos registros.
- Como marcar registros processados.
- Como reprocessar falhas.
- Se pode haver execução paralela.
- Se existe integração externa.
- Quem monitora o batch.

## Processo

1. Classifique o batch: simples, recorrente, alto volume, integração ou reprocessamento.
2. Defina critério de seleção.
3. Defina estratégia de idempotência.
4. Defina logging e mensagens úteis para suporte.
5. Defina transações curtas.
6. Avalie paralelismo ou particionamento.
7. Avalie retry e reprocessamento.
8. Sugira estrutura X++.
9. Sugira testes técnicos e funcionais.

## Saída

Entregue:

### Desenho recomendado

### Estrutura de classes

### Pseudocódigo X++

### Riscos operacionais

### Plano de testes

## Restrições

- Não sugerir processar alto volume em transação única.
- Não ignorar reprocessamento.
- Não criar batch sem logs úteis.

Exemplo de uso:

/d365fo-xpp-batch-design desenhe um batch para reprocessar pedidos de venda com erro de integração, com retry e log.

Skill 4: Revisão de Data Entity em D365 F&O

Use para revisar entidades de dados criadas para integrações, importação, exportação ou OData.

---
name: d365fo-data-entity-review
description: Revisa data entities em Dynamics 365 Finance & Operations com foco em contrato de negócio, staging, OData, performance, segurança, campos expostos, nomenclatura e impacto em integrações.
---

# D365 F&O Data Entity Review

## Objetivo

Garantir que a data entity seja um contrato estável, performático e seguro para integração ou movimentação de dados.

## Contexto necessário

Identifique:

- Cenário de uso: OData, importação, exportação, recurring integration ou relatório.
- Sistema consumidor.
- Volume.
- Frequência.
- Campos obrigatórios.
- Tabelas envolvidas.
- Necessidade de staging.
- Regras de validação.
- Segurança dos dados.

## Checklist

1. A entidade representa um conceito de negócio claro?
2. Há campos demais expostos?
3. Os nomes são compreensíveis para consumidores externos?
4. OData é adequado para o volume?
5. A entidade precisa de staging?
6. Existe lógica customizada que pode afetar performance?
7. A entidade respeita segurança e dados sensíveis?
8. Há impacto em legal entity?
9. Há validações suficientes?
10. Existem testes de importação, exportação e erro?

## Saída

Responda com:

- Diagnóstico.
- Riscos.
- Melhorias no contrato.
- Melhorias de performance.
- Testes recomendados.
- Perguntas para o funcional ou integrador.

Exemplo:

Use o Skill d365fo-data-entity-review para revisar esta entidade criada para integração de fornecedores via OData.

Skill 5: Geração de SysTest Para X++

Use quando a alteração X++ precisa de testes técnicos.

---
name: d365fo-xpp-systest-generator
description: Ajuda a criar cenários SysTest para regras X++ em Dynamics 365 Finance & Operations. Use quando houver validação, cálculo, extensão, serviço, batch ou regra de negócio que precise de teste automatizado.
---

# D365 F&O X++ SysTest Generator

## Objetivo

Gerar cenários de teste técnico para validar regras X++ com dados controlados.

## Contexto necessário

Identifique:

- Classe ou método testado.
- Regra de negócio.
- Tabelas necessárias.
- Dados mínimos.
- Casos positivos.
- Casos negativos.
- Casos limite.
- Dependências externas.
- Se precisa mock, isolamento ou rollback.

## Processo

1. Explique a regra a ser testada.
2. Liste cenários em tabela.
3. Separe testes técnicos de testes funcionais.
4. Sugira nomes de métodos de teste.
5. Sugira estrutura SysTest.
6. Liste dados necessários.
7. Indique lacunas que precisam ser confirmadas no projeto.

## Formato de saída

### Regra sob teste

### Cenários

| Teste | Dado | Ação | Resultado esperado |
|---|---|---|---|

### Estrutura sugerida X++

### Lacunas

## Restrições

- Não inventar APIs do projeto.
- Não assumir dados mestres existentes.
- Preferir dados criados pelo próprio teste quando possível.
- Informar quando o teste deve ser funcional em vez de SysTest.

Exemplo:

/d365fo-xpp-systest-generator crie cenários para validar regra de bloqueio de crédito antes da confirmação do pedido.

Skill 6: Explicação Funcional de Código X++

Use quando o desenvolvedor precisa explicar uma alteração para consultor funcional, key user ou gerente de projeto.

---
name: d365fo-xpp-functional-explainer
description: Transforma código X++ e customizações D365 F&O em explicação funcional clara para consultores, key users e gestores. Use quando precisar documentar impacto de processo, testes funcionais ou critérios de aceite.
---

# D365 F&O X++ Functional Explainer

## Objetivo

Converter código técnico em explicação de processo de negócio.

## Contexto necessário

Identifique:

- Módulo.
- Processo.
- Tela ou rotina.
- Tabelas principais.
- O que muda para o usuário.
- Configurações envolvidas.
- Exceções.
- Integrações.

## Saída

Responda com:

### Resumo para negócio

### Processo impactado

### O que muda para o usuário

### Configurações ou dados necessários

### Cenários de teste funcional

### Riscos e perguntas

## Regras

- Evite jargão técnico quando possível.
- Explique X++ em linguagem de processo.
- Não invente impacto funcional não evidente no código.
- Liste perguntas quando faltar contexto.

Exemplo:

Use d365fo-xpp-functional-explainer para explicar esta customização de aprovação de compras para o consultor funcional.

Skill 7: Revisão de Segurança D365 F&O

Use quando a alteração envolve roles, duties, privileges, menu items, serviços, data entities ou exposição de dados.

---
name: d365fo-security-review
description: Revisa impacto de segurança em alterações Dynamics 365 Finance & Operations, incluindo roles, duties, privileges, menu items, data entities, serviços, dados sensíveis e integrações.
---

# D365 F&O Security Review

## Objetivo

Identificar riscos de acesso indevido, exposição de dados e permissões excessivas.

## Contexto necessário

Identifique:

- Artefato exposto.
- Perfil de usuário.
- Role, duty ou privilege envolvido.
- Menu item.
- Data entity ou serviço.
- Dados sensíveis.
- Integrações externas.
- Legal entity.

## Checklist

1. A permissão é mínima?
2. O usuário precisa mesmo executar essa ação?
3. Existe segregação de funções?
4. A data entity expõe campos sensíveis?
5. O serviço valida autorização?
6. Existe risco cross-company?
7. Logs expõem dados sensíveis?
8. Integração usa identidade apropriada?
9. Há evidência de teste por perfil?

## Saída

- Riscos de segurança.
- Ajustes recomendados.
- Testes por perfil.
- Perguntas para segurança ou funcional.

Exemplo:

/d365fo-security-review revise esta data entity e os privileges associados antes de liberar para integração.

Como Organizar Esses Skills no Repositório

Para um projeto D365 F&O, uma estrutura prática seria:

.claude/
└── skills/
    ├── d365fo-xpp-coc-review/
    │   └── SKILL.md
    ├── d365fo-xpp-transaction-review/
    │   └── SKILL.md
    ├── d365fo-xpp-batch-design/
    │   └── SKILL.md
    ├── d365fo-data-entity-review/
    │   └── SKILL.md
    ├── d365fo-xpp-systest-generator/
    │   └── SKILL.md
    ├── d365fo-xpp-functional-explainer/
    │   └── SKILL.md
    └── d365fo-security-review/
        └── SKILL.md

Para GitHub Copilot, a mesma lógica pode ir para:

.github/
└── skills/
    ├── d365fo-xpp-coc-review/
    ├── d365fo-xpp-transaction-review/
    ├── d365fo-xpp-batch-design/
    ├── d365fo-data-entity-review/
    ├── d365fo-xpp-systest-generator/
    ├── d365fo-xpp-functional-explainer/
    └── d365fo-security-review/

Comece com três:

  1. d365fo-xpp-coc-review
  2. d365fo-xpp-transaction-review
  3. d365fo-xpp-systest-generator

Esses três já cobrem uma parte grande do trabalho diário de desenvolvedor X++.

Como Versionar Skills em Equipe

Trate Skills como código.

Recomendações:

  • Salve Skills de projeto no repositório.
  • Revise mudanças em PR.
  • Inclua exemplos de entrada e saída.
  • Documente versão e histórico.
  • Evite Skills amplos demais.
  • Prefira nomes específicos.
  • Teste com casos reais.
  • Remova Skills que ninguém usa.

Um Skill ruim também gera risco. Se ele ensina o agente a fazer algo errado, o erro se repete com consistência. Por isso, revisão é essencial.

Segurança: Skills Podem Executar Coisas

Skills podem conter scripts, templates e instruções que levam o agente a usar ferramentas. Isso é poderoso, mas exige cautela.

Cuidados:

  • Use Skills apenas de fontes confiáveis.
  • Revise qualquer Skill de terceiros antes de instalar.
  • Leia scripts antes de permitir execução.
  • Evite permissões amplas.
  • Separe Skills read-only de Skills que alteram arquivos.
  • Use disable-model-invocation para tarefas sensíveis no Claude Code.
  • Use allowed-tools com escopo mínimo quando fizer sentido.
  • Não coloque segredos em Skills.
  • Não coloque tokens, senhas ou dados de cliente em exemplos.
  • Para deploy, banco, FTP ou produção, exija confirmação humana.

Skills são uma forma de automação. Automação boa reduz erro. Automação mal governada escala erro.

Roadmap Prático Para Começar

Semana 1: identificar repetição

Observe quais prompts você repete:

  • Revisão de PR.
  • Geração de teste.
  • Explicação funcional.
  • Integração.
  • Performance.
  • Documentação.

Escolha apenas um.

Semana 2: criar primeiro Skill

Crie um Skill pequeno:

.claude/skills/d365fo-review/SKILL.md

ou:

.github/skills/d365fo-review/SKILL.md

Use em uma tarefa real.

Semana 3: adicionar exemplos

Adicione:

  • Um exemplo de entrada.
  • Um exemplo de saída.
  • Um checklist.
  • Um template.

Semana 4: levar para o time

Abra PR.

Peça feedback:

  • O Skill ativou na hora certa?
  • A resposta ficou melhor?
  • Faltou contexto?
  • O formato ajudou?
  • Alguma instrução ficou perigosa?

Depois disso, crie o segundo Skill.

Conclusão

Skills são uma das formas mais práticas de transformar IA generativa em capacidade operacional.

Prompt é conversa. Skill é processo.

Para desenvolvedores, arquitetos e consultores D365 F&O, isso é uma mudança importante. O valor não está apenas em gerar código mais rápido. O valor está em capturar a forma correta de revisar, testar, documentar e governar alterações em sistemas empresariais.

No Claude Code, Skills funcionam muito bem para trabalho local profundo, workflows de engenharia, revisão de código, automação controlada e padronização de procedimentos. No GitHub Copilot, Agent Skills entram como um caminho natural para padronizar tarefas em repositórios, PRs, issues, CLI e agent mode.

O melhor começo é simples: escolha uma tarefa que você repete toda semana e transforme em um SKILL.md.

Se esse Skill ajudar o agente a fazer a pergunta certa antes de gerar a resposta, ele já valeu a pena.

Fontes Oficiais Consultadas