Nível 2 — Ferramenta de trabalho · Módulo 2.4 — Skills de verdade

2.4.5 · Compartilhando e versionando

4 min de vídeo TODOS

Objetivo: ao final, o consultor publica uma skill para a squad inteira via controle de versão, sabe o que revisar antes de publicar, e reconhece quando promover uma skill de projeto para a biblioteca geral da Wayon.

O que você precisa levar desta aula

Skill de projeto vai para o controle de versão, dentro do repositório (.claude/skills) — não fica só na máquina de quem criou.
Antes de publicar uma skill para a squad inteira, passa por revisão interna: description clara, sem dado sensível de cliente, scripts revisados, sem sobreposição com skill existente.
Promova uma skill de projeto específico (como Meridiano) para a biblioteca geral da Wayon quando o procedimento por trás for genérico o bastante para servir outros clientes.

Onde uma skill pode viver

Local	Quem herda	Quando faz sentido
Máquina pessoal	Só quem criou	Rascunho, ainda sendo testada
`.claude/skills` no repositório do projeto (Meridiano)	Toda a squad, ao clonar o repositório	Procedimento específico daquele projeto/cliente
Biblioteca geral da Wayon	Qualquer squad, em qualquer projeto	Procedimento genérico o bastante para servir vários clientes

Esta é a mesma progressão vista no Nível 1, módulo 1.5 (biblioteca de skills) — agora do lado de quem constrói, não só de quem usa.

Checklist de revisão antes de publicar para a squad

Description contém as palavras que a squad realmente digita no dia a dia (antecipa a aula 2.4.6)
Nenhum dado sensível ou específico de cliente esquecido dentro da pasta da skill
Scripts revisados como código (aula 2.4.2)
Sem sobreposição óbvia de gatilho com uma skill já publicada (antecipa a aula 2.4.6)

Quando promover para a biblioteca geral

Pergunta central: o procedimento por trás da skill depende do Meridiano especificamente, ou serviria a qualquer projeto de rollout S/4HANA? Se a resposta é "serviria", promova — e troque qualquer nome específico do Meridiano (RICEFW, sistema MRD) por um placeholder genérico antes da promoção.

Regra Wayon Nenhuma skill sai da pasta de um projeto de cliente para a biblioteca geral da Wayon sem revisão de um consultor sênior — a mesma lógica de aprovação já aplicada a templates e skills prontas no Nível 1 (módulo 1.5).

📖 Biblioteca de skills — Nível 1, módulo 1.5 · Skills — organização de projeto

Quiz — 3 questões

1.Uma skill foi construída para o projeto Meridiano, dentro do repositório do projeto. Onde ela deve ser salva para que qualquer colega da squad a receba automaticamente ao clonar o repositório?

a)Dentro de .claude/skills, versionada no próprio repositório do projeto
Correto.
b)Numa pasta pessoal, fora do repositório, compartilhada depois por e-mail
Não é herdada automaticamente pelo clone; exige um passo manual extra a cada novo integrante.
c)Anexada à última conversa do Claude Code sobre o assunto
Uma conversa não é um lugar de armazenamento reaproveitável pela squad.

Ver resposta e por quê

✅a) Correto.

❌b) Não é herdada automaticamente pelo clone; exige um passo manual extra a cada novo integrante.

❌c) Uma conversa não é um lugar de armazenamento reaproveitável pela squad.

2.Antes de publicar uma skill para toda a squad, o que deveria ser revisado?

a)Apenas se a skill "funciona", sem outro critério
Funcionar é necessário, mas não suficiente — falta checar dado sensível, scripts e sobreposição de gatilho.
b)Apenas o nome do arquivo, para garantir que segue um padrão visual
O nome do arquivo é o menor dos problemas; o que importa é o conteúdo e o comportamento da skill.
c)Description clara, ausência de dado sensível de cliente, scripts revisados, e sobreposição com skills já existentes
Correto.

Ver resposta e por quê

❌a) Funcionar é necessário, mas não suficiente — falta checar dado sensível, scripts e sobreposição de gatilho.

❌b) O nome do arquivo é o menor dos problemas; o que importa é o conteúdo e o comportamento da skill.

✅c) Correto.

3.Uma skill de checklist de cutover, construída para o Meridiano, usa nomes exatos de RICEFW do próprio Meridiano em todo o texto. Ela deveria ser promovida para a biblioteca geral da Wayon, como está? ---

a)Sim, promover como está — a biblioteca geral pode ter skills específicas de um único cliente
A biblioteca geral serve a qualquer squad; deixar nomes específicos do Meridiano confundiria quem a usar em outro projeto.
b)Não promover nunca — skills de checklist de cutover são sempre específicas demais para generalizar
O procedimento de cutover em si costuma ser genérico o bastante entre projetos de rollout; o que precisa mudar são os nomes específicos, não descartar a promoção.
c)Não como está — primeiro trocar os nomes específicos do Meridiano por placeholders genéricos, depois promover
Correto.

Ver resposta e por quê

❌a) A biblioteca geral serve a qualquer squad; deixar nomes específicos do Meridiano confundiria quem a usar em outro projeto.

❌b) O procedimento de cutover em si costuma ser genérico o bastante entre projetos de rollout; o que precisa mudar são os nomes específicos, não descartar a promoção.

✅c) Correto.