O que example-claude-code-skills faz?
Exemplo prático para skil-lock — fixar o comportamento de Habilidades de IA e bloquear desvios não aprovados em CI.
Visão Geral
Este repositório serve como um modelo funcional para demonstrar o uso de skil-lock, uma ferramenta que permite fixar ("travar") o conteúdo de uma habilidade de IA a uma versão específica. Isso garante que assistentes como Claude Code, Cursor ou Codex executem exatamente a mesma lógica definida, mesmo após alterações no arquivo da habilidade, a menos que a mudança seja aprovada explicitamente.
Como Funciona
- Defina sua habilidade em um arquivo Markdown (ex.:
SKILL.md). - Utilize
skil-lockpara gerar um hash do conteúdo da habilidade. - Integre a validação no seu pipeline de CI: o script verifica se o hash atual corresponde ao hash fixado.
- Se houver divergência (drift), o pipeline falha, impedindo que um comportamento não aprovado seja utilizado.
Exemplo de Uso
# Gerar lock para a habilidade atual
skil-lock lock --skill SKILL.md
# Verificar no CI se a habilidade não foi alterada sem aprovação
skil-lock verify --skill SKILL.md
Plataformas Suportadas
- Claude Code — suporte nativo para habilidades em Markdown.
- Cursor — utiliza o mesmo formato de habilidades.
- Codex — compatível com habilidades baseadas em Markdown.
Benefícios
- Consistência: Garante que todos os desenvolvedores usem a mesma versão da habilidade.
- Segurança: Bloqueia alterações não autorizadas em pipelines automatizados.
- Rastreabilidade: Cada mudança aprovada exige uma atualização explícita do lock.
Licença
Este é um exemplo educacional. Sinta-se à vontade para adaptá-lo às suas necessidades.