Skill Bill: Uma Estrutura de Governança Baseada em Markdown para Habilidades de Codificação em IA

O que é o Skill Bill

Skill Bill é um framework de governança para habilidades de codificação com IA construído inteiramente em Markdown. Ele aborda problemas comuns que os desenvolvedores enfrentam ao gerenciar múltiplos prompts de IA em diferentes agentes: derivação de nomenclatura, lógica duplicada, código específico de plataforma infiltrando-se em habilidades genéricas e falta de uma única fonte da verdade.

Como começou

O desenvolvedor começou com habilidades individuais para tarefas específicas: um prompt de revisão de código para trabalho Android/KMP, uma habilidade gradle check com convenções para corrigir problemas em vez de suprimi-los, uma habilidade feature flag e uma habilidade para implementar funcionalidades a partir de documentos de design. Após acumular cerca de uma dúzia de habilidades espalhadas por agentes, eles experimentaram a "deterioração familiar" de nomenclatura inconsistente e lógica específica do Kotlin aparecendo em habilidades supostamente genéricas.

A inovação do orquestrador

A inovação principal foi criar feature-implement, uma habilidade que chama outras habilidades em sequência. Este orquestrador pega um documento de design, cria um plano, pergunta sobre a estratégia de feature flag, implementa código, executa revisões e verifica a completude. Uma única execução de feature-implement encadeia 10-12 invocações de habilidades: um orquestrador, um roteador de revisão de código que detecta a stack, 3-5 revisores especialistas executando em paralelo, uma verificação de qualidade, descrição de PR e configuração opcional de feature flag.

Considerações de custo

O desenvolvedor usa Claude Code com assinatura Max e inicialmente não considerou os custos de uso. No entanto, um amigo usando assinatura Codex Pro relatou que uma única invocação da habilidade code-review (não a cadeia completa) consome 40-50% do limite de taxa de 5 horas do Pro. O Copilot usa um modelo de cobrança diferente (por turno de conversa em vez de por volume de tokens), tornando-o mais econômico para esta abordagem.

Arquitetura técnica

O framework evoluiu para suportar múltiplas linguagens de programação através de Markdown estruturado que funciona como código:

• Herança: Habilidades base com substituições de plataforma
• Lógica de roteamento: Detecção de stack e delegação para especialistas apropriados
• Contratos de interface: Relações definidas entre habilidades
• Validação: Impõe regras de nomenclatura e estrutura para prevenir deterioração do repositório

Uma vez que a camada base se tornou adequadamente genérica, adicionar suporte a PHP foi direto, seguido por Go. O framework agora inclui 44 habilidades em Kotlin, Android/KMP, backend Kotlin, PHP e Go.

Principais recursos

• Habilidades base que roteiam automaticamente para o especialista de plataforma correto
• Um validador que impõe regras de nomenclatura e estrutura
• Repositório único que sincroniza com Claude Code, Copilot, GLM e Codex
• Habilidades de orquestração como feature-implement que encadeiam tudo de ponta a ponta
• Atualmente mais forte para família Kotlin e backends Go/PHP, mas projetado para estender para novas plataformas

Implicações práticas

O desenvolvedor descobriu que repositórios de prompts têm os mesmos problemas de engenharia que softwares regulares. Ao tratar habilidades como código—com contratos, validação e composabilidade—todo o sistema se tornou dramaticamente mais sustentável. O framework está disponível no GitHub sob licença MIT em https://github.com/Sermilion/skill-bill.