Mantenedores e propostas de mudança

Camada funcional

Uma skill útil acaba sendo usada por mais gente do que a criou. Daí a pergunta: quem pode alterá-la? O modelo permite dois regimes — só mantenedores, ou aberto — e, quando fechado, um caminho de proposta para quem não é mantenedor sugerir mudança.

Os dois modos de contribuição

Cada skill fica num dos dois, e a escolha aparece como um par de botões na tela de contribuições:

Anatomia de uma proposta

Uma proposta carrega o que muda e quem propôs, e as duas coisas ficam à vista de quem decide.

O que muda pode ser de três formas: acrescentar um trecho — opcionalmente a uma seção nomeada —, trocar um texto por outro, ou remover. Quem propôs pode ser uma ferramenta (tipicamente o próprio agente, enquanto trabalha), uma detecção automática, ou uma pessoa revisando.

Da chegada até o fim, a proposta passa por um destes desfechos:

• Pendente — esperando decisão. É o que a tela lista, com o botão de aplicar e o de rejeitar.
• Aplicada ou rejeitada — alguém decidiu.
• Isolada — não foi aceita nem recusada, foi posta de lado. Faz sentido num sistema onde agentes propõem mudança em texto que orienta outros agentes: conteúdo suspeito precisa de um desfecho que não seja nem aprovação nem descarte silencioso.
• Superada — outra proposta passou por cima. Evita aplicar duas mudanças conflitantes sobre a mesma base.

O sistema também guarda uma impressão do conteúdo proposto, o que permite reconhecer proposta repetida e perceber quando a mudança foi escrita sobre uma versão que já mudou desde então.

Mantenedores

A skill tem uma lista própria de mantenedores, com o dono sempre dentro. É o conjunto que escapa da fila de propostas quando o modo é fechado — e, quando ninguém foi acrescentado, a tela diz isso com todas as letras: nenhum mantenedor além do dono.

O que dá para fazer, e onde

Tudo acontece na tela de contribuições da skill, aberta a partir da lista de skills do agente:

Por que isso importa mais do que parece

Skill é instrução que muda o comportamento de um agente. Uma alteração maliciosa ou apenas descuidada numa skill compartilhada se propaga para todo agente que a usa, sem passar por revisão de código. O regime de mantenedores, o desfecho de isolamento e a impressão do conteúdo são a resposta a esse risco — e a razão de a governança de contribuição ser tratada como assunto próprio, e não como detalhe da edição.