Utilizando a Skill
A Skill do Toolkit de IA pode ser usada de duas formas principais:
- Como contexto em uma conversa com a IA;
- Registrada como uma skill formal em ferramentas que suportam esse conceito como GitHub Copilot Chat ou Copilot CLI ou ChatGpt, Claude ou Gemini.
Como contexto em uma conversa com a IA
A forma mais simples de utilizar a Skill é anexar o arquivo que será analisado ou colar seu conteúdo diretamente na conversa. Assim, a IA terá acesso às informações necessárias para interpretar o contexto e executar a tarefa solicitada.
Uso no GitHub Copilot chat ou Copilot CLI
- Abra o Copilot Chat no VS Code ou o Copilot CLI no terminal;
- Anexe o arquivo
skill.md. No VS Code, use o botão de anexar arquivo. No CLI, referencie o caminho do arquivo; - Faça sua solicitação normalmente.
A IA utilizará automaticamente as regras da Skill como contexto para responder.
Exemplo de prompt
Usando as regras do arquivo skill.md anexado, gere em C# a função de inicialização (Oper="1") do Client Conecta, incluindo o tratamento do retorno imediato da RequestDispatcher e o mascaramento do ClientSecret nos logs. Uso no ChatGpt, Claude ou Gemini
- Abra uma nova conversa;
- Cole ou anexe o conteúdo de
skill.md; - Faça sua solicitação.
Exemplo de prompt
[conteúdo da skill.md]
Com base nesta Skill, revise o código abaixo em Java que realiza um pagamento no débito e identifique problemas relacionados às regras de MerchantOrderId e ao tratamento do callback final.
[código Java]Casos de uso da Skill
A Skill é especialmente eficiente para atividades como:
- Gerar o payload JSON correto para uma operação específica (inicialização, pagamento, estorno, status, consulta, reemissão, confirmação, desativação);
> Exemplo de prompt de geração de payload
Com base na skill client-conecta-skill, monte o JSON de estorno de um pagamento de crédito à vista aprovado, usando RefundPaymentId, com valor de R$ 35,90.
> Exemplo de resposta esperada da IA
{
"Oper": "005",
"TransactionType": "50",
"Amount": "3590",
"MerchantOrderId": "260812143512987",
"RefundPaymentId": "payment-id-original"
} -
Validar se um
MerchantOrderIdestá no formato correto (15 dígitos numéricos); -
Explicar o significado de um código de erro retornado pela DLL (ex.: CFL_ERROR_TIMEOUT);
-
Revisar se um código já existente segue as hard rules (ex.: se o ClientSecret está sendo logado sem máscara);
-
Gerar a estrutura de pastas recomendada para um novo projeto de integração.
Updated about 1 month ago