Lição 7: Programação com múltiplas competências: decomposição e combinação de limites e arbitragem de conflitos de acionamento
Objetivo desta lição: Quando tiver mais do que uma Skill no seu repositório, iráDecidir quando separar e quando juntar, e definir a descrição como mutuamente exclusiva; caso haja dois candidatos, há umTabela de arbitragem, em vez de se basear no princípio de «quem o incluir primeiro no diretório ganha». Na aula anterior, já realizaste regressão para uma única Skill utilizando um conjunto de testes:https://school.myshirtai.com/?p=4048; Esta aula vai além disso, abordando a ativação simultânea de múltiplas competências e a sobreposição de limites. Não se trata de escrever mais um artigo sobre «a importância da colaboração», mas sim de apresentar, ainda esta noite, as diretrizes de decomposição e composição, as instruções mutuamente exclusivas, a tabela de arbitragem e exemplos de conflitos.
Introdução
Por favor, conclua primeiro a Lição 6, «Regressão de uma Skill utilizando um conjunto de avaliação»:https://school.myshirtai.com/?p=4048. Tens de ter, pelo menos, dois ou mais que possam carregar Skills e que funcionem run_skill_eval.py(ou equivalente), exemplos de disparos errados/disparos em falta das lições 4 a 6. Se ainda lhe faltar alguma base anterior, por favor, recupere-a: Lição 1 https://school.myshirtai.com/archives/3378; Lição 2 https://school.myshirtai.com/archives/3462; Lição 3 https://school.myshirtai.com/archives/3521; Lição 4 https://school.myshirtai.com/archives/3661; Lição 5 https://school.myshirtai.com/?p=3948.
Lista de materiais: com direitos de escrita ou possibilidade de apresentar um PR; ao catálogo de avaliações podem ser adicionados exemplos de «pares em conflito»; a equipa deve chegar a acordo sobre uma tabela de prioridades de arbitragem (que pode ser colocada em skills/README.md). Na ausência de registos reais de duplo acionamento, utilize primeiro a frase «chamaram o A, mas foi o B que correu», apresentada na lição 6 sobre falhas; não invente histórias para encenar harmonia.
Se o gancho de avaliação da Lição 6 ainda só puder devolver «se foi acionado + nome da competência», isso é suficiente para esta lição; se o gancho só puder devolver um valor booleano, por favor, adicione primeiro a análise do nome da competência, caso contrário não será possível expressar o conflito de expectativas. Descrever a «lacuna nas capacidades do gancho» como um obstáculo antes do início da Lição 7 é mais honesto do que escrever exemplos à força.
Sugestão da «Caixa do Tempo»: esta noite, dedica 90 minutos apenas a tratar um par de competências sobrepostas; não tentes resolver todo o inventário de uma só vez. Só se consegue estabelecer uma regra sólida se um par for concluído com sucesso; se toda a lista ficar por tratar, só restará uma lista de tarefas que ninguém concluiu.

Conceito: na coreografia, resolve-se primeiro a questão dos limites e só depois discute-se quem é mais inteligente
A lição 6 garante que a ativação de uma única Skill seja regressiva. A lição 7 complementa:Mesmo quando ambos são «legítimos», pode acontecer que queiram jogar ao mesmo tempo. Elabore uma resposta a quatro perguntas: deve dividir-se em duas Skills? A descrição contém frases contraditórias? Em caso de conflito, qual tem prioridade? Em caso de empate, é necessário pedir esclarecimentos ao utilizador?
- A montagem e desmontagem são uma decisão relativa ao produto:As autorizações, o custo do fracasso e o grau de sobreposição do corpus têm prioridade sobre o facto de «o índice parecer mais apelativo».
- Escrita mútua na descrição:Independentemente do que se diga na parte principal, deve-se escrever, em frases curtas: «Não tratar X / Se ocorrer Y, utilize Z».
- Entrada da tabela de arbitragem no armazém:Versões das estratégias de prioridade e de empate; as alterações nas tabelas devem ser submetidas a uma avaliação de conflitos.
- Exemplos de conflitos para a avaliação da 6.ª lição:As duas frases candidatas devem incluir a competência esperada; não é permitido utilizar «ambas servem» como referência de referência.
Os materiais oficiais sobre as «Agent Skills» salientam que a descrição é responsável pelo acionamento; quando existem várias «Skills», o espaço entre os acionadores também deve ser claramente especificado. O conceito termina aqui; a seguir, passamos diretamente à decomposição, combinação e arbitragem.
A estruturação não consiste em criar mais uma «Super Habilidade» para incluir todas as capacidades. As «Super Habilidades» tornam difusas as fronteiras entre autorizações, avaliações e responsabilidades. Se for possível esclarecer algo através de uma tabela de arbitragem, não se deve arriscar a utilizar uma descrição mais abrangente.
A relação com a lição 6 pode ser resumida numa frase: a utilização de uma única Skill garante que «se deve ou não ativar-me»; a combinação de várias Skills garante «qual de nós deve ser ativada». Ambos os conjuntos de exemplos têm de ser incluídos no CI; nenhum deles é dispensável.
O que se pode fazer esta noite:Listar todas as Skills no repositório nome Tal como na primeira frase da descrição, assinale os pares que suspeita que se sobreponham; se houver mais de dois pares, trate primeiro do par com maior sobreposição.
Guia prático passo a passo: decomposição e composição, descrição de exclusão mútua, tabela de arbitragem, exemplos de conflitos

- Quando será demolido:Os limites de autorização são diferentes (FAQ de leitura apenas vs. tickets editáveis); os custos em caso de falha são diferentes (consultar a documentação vs. enviar um e-mail); e os contextos de ativação quase não se sobrepõem. Após a separação, cada um fica independente
evals/. - Quando se unem:Na mesma área, partilhando uma grande quantidade de
referência/; Após a separação, verificaram-se acionamentos errados mútuos em mais de cerca de 20% das amostras; na perceção do utilizador, trata-se de «uma única capacidade do assistente». Antes da unificação, é necessário juntar os conjuntos de avaliação e, em seguida, eliminar os diretórios. - Escrever descrição de mutação:Cada Skill deve incluir 1 a 2 frases de limites negativos. Por exemplo, a Skill «FAQ» deve indicar: «Não cria nem altera pedidos de assistência; para pedidos de assistência, utilize a Skill “ticket-ops”»; a Skill «ticket-ops» deve indicar: «Não responde ao texto original das políticas do produto; para políticas, utilize a Skill “shop-faq”». Tanto as frases de capacidade positiva como as de limites negativos devem ser detetadas durante a avaliação.
- Preencher o formulário de arbitragem:Partindo da tabela HTML acima, substituam os nomes das competências pelo nome das competências da vossa empresa e insiram-na em
skills/ARBITRAGEM.md(O nome do ficheiro pode ser definido livremente); Ao alterar a descrição de um PR, é necessário indicar se tal alteração afeta a prioridade. - Exemplos de conflitos:Para cada par de competências sobrepostas, pelo menos 5 expressões «duplas», sendo que se espera que sejam únicas
expect_skill. Executar o script da lição 6; só é permitido juntar quando os dois estiverem verdes.
| Tipos de conflito | Arbitragem por defeito | Expectativas em relação à avaliação |
|---|---|---|
| Segurança/Gravação no disco vs. Consulta apenas de leitura | Prioridade à leitura; para gravar no disco, é necessário indicar explicitamente o ficheiro ou efetuar uma segunda confirmação | Não é possível ativar a habilidade de gravação no disco sem ter sido nomeado |
| As duas leituras da «Skill» apresentam sobreposição semântica | Por ordem de prioridade de tarefas, conforme a tabela de arbitragem; caso contrário, solicitar ao utilizador que escolha | A habilidade «skill» deve ser única; não são permitidas duas instâncias verdadeiras. |
| O utilizador mencionou «skill» | Prioridade à chamada nominal, a menos que o sistema de controlo de acessos recuse a autorização | Frase de chamada: expect_skill=pessoa que faz a chamada |
| Empate e sem cartões | Esclarecer as dúvidas e não proceder à aplicação de efeitos secundários sem autorização | expect_trigger=false ou expect_skill vazio e registar em log |
# Exemplo de evals/conflict_pairs.jsonl
{"id":"C-01","utterance":"Onde está indicado o prazo para devoluções? Já agora, por favor, crie um ticket de acompanhamento para mim","expect_trigger":true,"expect_skill":"shop-faq","notes":"Responda primeiro sobre a política; para criar o ticket, é necessário indicar "ticket-ops""}
{"id":"C-02","utterance":"Utilize o "ticket-ops" para criar um pedido de acompanhamento para a encomenda 123","expect_trigger":true,"expect_skill":"ticket-ops","notes":"O utilizador mencionou o nome"}
{"id":"C-03","utterance":"Ajude-me a tratar da devolução","expect_trigger":false,"expect_skill":"","notes":"Empate: deve esclarecer se se trata de uma consulta sobre a política ou da criação de um ticket"}
Adicionar mais uma pergunta ao modelo de PR: «Devem ser atualizados a tabela de arbitragem e o ID do exemplo de conflito?» Não é permitido solicitar a fusão se estes campos ficarem em branco. Os comandos locais devem estar em conformidade com os comandos de CI.
Como escrever uma frase de exclusão para que seja considerada válida: tem de ser detetada pelo sistema de avaliação. Não basta escrever apenas «Por favor, escolha com cuidado». Deve ser redigida como um comportamento observável, por exemplo, «Se o utilizador solicitar a criação/alteração de um ticket, esta Skill não processará o pedido». Em seguida, deve-se utilizar uma frase de conflito para verificar que «ticket-ops» é, de facto, o resultado esperado.
No que diz respeito às decisões de fusão ou separação, convoquei uma reunião de quinze minutos com as partes envolvidas: o responsável pela segurança tem direito de veto sobre a fusão de discos; o responsável pelas operações tem direito de veto sobre separações sem sentido. As atas da reunião devem ser resumidas em três linhas para divulgação, para evitar que, posteriormente, se diga: «Pensava que tinham concordado com a separação».
Os exemplos de conflito devem provir de frases reais de utilizadores; é permitida uma ligeira reformulação para proteger a privacidade, mas não se trata de uma criação literária. As frases literárias servem para avaliar a sua imaginação, não para atuar como gatilhos.
O que se pode fazer esta noite:Selecione o par de Skills com maior sobreposição, escreva três exemplos de conflito e faça com que pelo menos um deles resulte num «sinal vermelho»; depois, utilize instruções mutuamente exclusivas ou uma tabela de arbitragem para corrigir a situação e obter um «sinal verde» — para confirmar que o sistema de controlo de acessos realmente considera o conjunto de conflitos.
A tabela de exemplos de arbitragem é apenas um ponto de partida; substituam-na pelos nomes específicos do vosso negócio: substituam «shop-faq» e «ticket-ops» pelos nomes reais das competências. Se a indicação na tabela de que «é necessário indicar explicitamente o disco» entrar em conflito com a funcionalidade do produto «encomenda com uma frase», o gestor de produto deve aprovar a alteração das expectativas, em vez de deixar que o modelo adivinhe.
Erros e falhas (pelo menos três)
- description Indicar apenas as competências positivas:Duas competências disputam a mesma frase com sinónimos. Resolução: impor uma frase de limite negativo; a avaliação de conflitos deve dar prioridade aos sinónimos.
- A tabela de arbitragem foi acordada apenas verbalmente na conversa:Quando um novo colaborador é integrado na terceira competência, não há dados de referência. Resolução: registar na base de dados; a verificação de conformidade (CI) confirma a existência do ficheiro.
- Exemplo de conflito: o «expect» está escrito como «A ou B»:Os testes apresentam sempre um falso verde. Solução: a expectativa deve ser única; em caso de empate, utilize `expect_trigger=false`.
- Juntou as «Skills», mas esqueceu-se de juntar as «evals»:O ID antigo já não é válido. Procedimento: a solicitação de pull (PR) de fusão deve incluir uma lista de avaliação da migração.
- A habilidade «Escrever no Disco» continua a ser ativada em caso de empate:A prioridade de segurança não foi incluída no hook. Resolução: bloqueio rígido na camada do hook; na avaliação, foi adicionada a regra «não é permitido gravar no disco sem autorização», o que resulta numa falha irremediável.
O que se pode fazer esta noite:Vou propositadamente incluir uma frase genérica do tipo «ajuda-me a tratar da devolução», para ver se a rede atual ou o «ganpao» ativam a habilidade de gravação; se isso acontecer, vou primeiro adicionar um bloqueio rígido e depois alterar o texto.
Existe ainda outro tipo de falha silenciosa: quando duas Skills de leitura apenas «concordam» simultaneamente, o assistente gera uma resposta mista, e o utilizador pensa que esta provém de uma política oficial, quando, na verdade, metade provém de uma referência desatualizada. A tabela de arbitragem deve, por predefinição, optar por «fonte única» neste caso, em vez de «ler um pouco de cada». Nas avaliações, deve-se esperar um nome de Skill único para este tipo de frases.
Se o vosso ambiente de execução não conseguir, temporariamente, ler o ficheiro da tabela de arbitragem, incluam, pelo menos, a prioridade nas instruções de exclusão mútua de cada descrição de Skill e, nos ganchos, criem uma lista negra codificada de forma rígida para as classes de gravação em disco. A arbitragem baseada em ficheiros é o estado ideal; o bloqueio rígido é o estado mínimo. Sem esse estado mínimo, não devem implementar a terceira Skill.
Exercício
- Elabore uma lista das competências do armazém, assinale pelo menos um par de competências que se sobreponham e decida se devem ser separadas ou combinadas (escreva 5 linhas a justificar a sua decisão).
- Adicionar blocos de controlo de acesso a ambas as partes e enviar o diff da descrição.
- Inserir na tabela de arbitragem + pelo menos 5 registos
pares_de_conflitoExemplo: executar atéSKILL_EVAL_OK. - Adicionar, a partir dos registos reais, uma entrada sobre «menção de nomes de utilizadores» e outra sobre «empate que deve ser esclarecido».
Critérios de conclusão: apenas os colegas podem ver skills/README Com a tabela de arbitragem, dá para saber quem ganha em caso de conflito, sem precisar de te enviar uma mensagem privada.
Depois de concluir o exercício, verifique se o CI da Lição 6: Conjunto de Conflitos já foi incluído no mesmo trabalho. Se for necessário executar manualmente um segundo script, isso significa que a narrativa do controlo de acessos ainda está fragmentada; primeiro, junte os comandos e, só depois, considere a Lição 7 concluída.
Antevisão da próxima aula
Antevisão da Lição 8: Integrar a arbitragem de múltiplas Skills com o rastreio/feedback de produção — como gerar exemplos de conflitos com um único clique a partir de registos de «duas opções» e como adicionar um período de observação às Skills do tipo «gravação em disco». Nesta lição, vamos primeiro garantir o bom funcionamento da separação e união offline e da tabela de arbitragem; sem sinais de conflito, a orquestração online limitar-se-á a uma situação de «disputa de palavras».
Antes da 8.ª aula, pode começar por criar manualmente um ciclo de fechamento mínimo: todas as sextas-feiras, copie do registo três casos suspeitos de dupla candidatura, redija-os como exemplos de conflito e execute a regressão na segunda-feira. O ciclo de fechamento pode ser rudimentar, mas é eficaz; quando a automatização estiver disponível, substitua a cópia manual, mas não fique à espera sem fazer nada.
Por favor, informe também os colegas da área de segurança: a combinação de várias competências altera a superfície de ataque — as frases do modelo de simulação que mencionam especificamente competências relacionadas com a gravação em disco devem ser incluídas nos exemplos de conflitos e segurança, em vez de aparecerem apenas nas conversas da equipa vermelha. A tabela de combinações e a tabela de segurança podem fazer referência cruzada ao mesmo ID.
Índice desta série
- Lição 1: Criar, em 30 minutos, a primeira «Claude Agent Skill» que se ativa automaticamente — https://school.myshirtai.com/archives/3378
- Lição 2: Adicionar uma referência ao Skill / O ciclo de verificação «escrever primeiro o documento de planeamento e depois executar» — https://school.myshirtai.com/archives/3462
- Lição 3: Skills com scripts e auditorias de segurança — https://school.myshirtai.com/archives/3521
- Lição 4: Descrição da iteração com casos reais de falha — https://school.myshirtai.com/archives/3661
- Lição 5: Integrar o Skill num repositório real de CI / diretório partilhado pela equipa — https://school.myshirtai.com/?p=3948
- Lição 6: Regressão de uma Skill utilizando um conjunto de avaliação — https://school.myshirtai.com/?p=4048
- Lição 7: Programação com múltiplas competências: decomposição e composição de limites e arbitragem de conflitos de acionamento (este artigo)


评论列表 (0条):
加载更多评论 Carregando...