Lição 8: Incorporar o padrão Task/Subagente numa Skill: limites de paralelismo e isolamento de contexto
Objetivo desta aula: irás conseguir... Tarefa / Subagente (subagent) Defina o padrão nas convenções da Skill — quais passos podem ser executados em paralelo, como isolar os contextos e como combinar os resultados — em vez de dizer verbalmente na conversa «criar algumas subtarefas». Na aula anterior, já realizou várias operações de divisão e fusão de Skills, bem como a resolução de conflitos:https://school.myshirtai.com/?p=4191. Esta lição, para além da arbitragem, abordaNo interior de uma única SkillA concorrência e o isolamento de contexto, integrados nos pontos-chave da orquestração atual do Claude Code Task/subagente. Não se trata de escrever mais um artigo sobre «cuidados a ter com a concorrência», mas sim da tabela de limites, da lista de isolamento e dos exemplos de falhas que posso enviar esta noite.
Introdução
Por favor, conclua primeiro a Lição 7, «Programação Multi-Skill: Desmembramento e combinação de limites e arbitragem de conflitos de acionamento»:https://school.myshirtai.com/?p=4191. Deve ter, pelo menos, à mão: a competência alvo a carregar, os pontos de avaliação das aulas 6 e 7 e a tabela de arbitragem. Se ainda lhe faltar alguma base anterior, por favor, recupere: Aula 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; Lição 6 https://school.myshirtai.com/?p=4048.
Lista de materiais: com direitos de escrita ou a possibilidade de enviar PR; capaz de utilizar o Skill referência/ Adicionar uma secção intitulada «Limites do paralelismo» ao README; na avaliação, podem ser incluídos exemplos de «interferência entre subtarefas». Na ausência de registos reais de falhas de paralelismo, utilize um exemplo simulado em que «duas subtarefas escrevem no mesmo ficheiro»; não invente histórias para embelezar a realidade.

Caixa do Tempo: Esta noite, só tenho noventa minutosUm De acordo com as regras relativas a «Skill» e «Task»/subagentes, não se deve tornar todo o armazém paralelo de uma só vez.
Conceito: Antes de a Tarefa/subagente ser inserida na Habilidade, é necessário definir primeiro os limites do paralelismo

A lição 7 garante que, em caso de conflito entre várias habilidades, seja possível arbitrar. A lição 8 complementa o seguinte:Depois de uma determinada Skill ser chamada, internamente ainda é possível que sejam criados cegamente vários subagentes para disputar o contexto, os ficheiros e a quota de ferramentas. Vamos começar por responder a quatro perguntas: que passos podem ser executados em paralelo? Quais são os caminhos que os subagentes consideram, por predefinição, como sendo de leitura apenas? Quem se encarrega de consolidar os resultados? Uma falha leva à anulação das tarefas irmãs?
- A paralelização é uma decisão de custos:Tempo do relógio de parede da província vs. queimar quota/disputar bloqueios; por predefinição, começa com um nível de paralelismo baixo.
- Isolamento de contexto – registar na Skill:Cada tarefa deve incluir apenas o resumo necessário; é proibido copiar integralmente o mesmo parágrafo da conversa N vezes.
- Lista de efeitos secundários:Gravação em disco, envio pela rede e alteração do estado de partilha são, por predefinição, em modo serial ou bloqueado; apenas a pesquisa em modo de leitura é em paralelo.
- Avaliação de aceitação:Pelo menos 3 exemplos do tipo «os resultados após a execução em paralelo devem ser consistentes/devem ser isolados».
Os produtos do tipo Claude Code utilizam a «tarefa/subagente» como primitiva de orquestração; já o Skill encarrega-se de definir «quando utilizar e como limitar» sob a forma de convenções que possam ser acionadas e submetidas a testes de regressão. O conceito fica por aqui; passemos agora à prática.
O que se pode fazer esta noite:Abra o ficheiro SKILL.md da Skill em questão, identifique os passos que pretende executar em paralelo e os passos secundários que têm de ser executados em sequência, e organize-os num rascunho com duas colunas.
Guia prático passo a passo: declaração, contexto de isolamento, limite de paralelismo, ganchos de aceitação

- Declarar a tabela de limites paralelos:existir
reference/parallel.md(O nome do ficheiro pode ser definido livremente) Indique os passos, se é possível executá-los em paralelo, o número máximo de tarefas simultâneas e os recursos partilhados. Este quadro deve ser analisado obrigatoriamente no PR. - Lista de isolamento de contexto:Cada subtarefa permite determinados campos de entrada (caminho de destino, resumo de leitura única, campos proibidos). É proibido inserir chaves secretas ou o registo completo da conversa nas subtarefas.
- Acordo de fusão:A tarefa pai é a responsável pela compilação das regras; a quem se deve dar prioridade em caso de conflito de campos; se a falha é do tipo «fail-fast».
- Ganchos e análises:Durante a execução, imprima o «número de subtarefas a serem iniciadas»; a avaliação garante que esse número não exceda o limite máximo e que as etapas de gravação no disco não sejam executadas em paralelo.
| Tipo de passo | Por predefinição | Expectativas em relação à avaliação |
|---|---|---|
| Pesquisa de leitura apenas / Resumo | Permite a execução em paralelo, com um limite máximo de 3 | Número de subtarefas ≤ limite máximo |
| Escrever no mesmo ficheiro / Alterar a configuração | Serial | Não é permitido escrever em simultâneo no mesmo caminho |
| Efeitos secundários da Internet | Fila serial ou explícita | Não é permitido enviar em paralelo sem indicação de nomes |
| Contexto incluído | Resumo mínimo | A entrada da subtarefa não inclui o campo da chave |
# Exemplo de evals/subagent_isolation.jsonl
{"id":"S-01","utterance":"Resumir em paralelo os README dos três módulos na pasta src/","expect_parallel":true,"max_workers":3,"expect_write":false}
{"id":"S-02","utterance":"Alterar simultaneamente duas chaves do mesmo ficheiro config.yaml","expect_parallel":false,"notes":"Em caso de conflito de escrita, deve ser processado em série ou rejeitado"}
{"id":"S-03","utterance":"Iniciar uma subtarefa, mas sem incluir o ficheiro .env","expect_leak":false,"forbidden_keys":["API_KEY","TOKEN"]}

O que se pode fazer esta noite:Executar pelo menos uma vez o exemplo da classe S-02 até obter um sinal vermelho e, em seguida, corrigir até obter um sinal verde utilizando a tabela de limites — para confirmar que o sistema de controlo de acessos reconhece a convenção paralela.
Erros e falhas (pelo menos três)

- Na descrição da habilidade, indique apenas «permite criar subproxy», sem especificar um limite máximo:O limite e o bloqueio foram ultrapassados. Resolução: aplicar o `max_workers` e realizar uma avaliação.
- Cópia do contexto completo da subtarefa:Interferência e fuga de informação. Resolução: lista de isolamento + exemplo de «forbidden_keys».
- Os passos de gravação no disco são executados em paralelo:Ficheiro danificado ou condição de corrida implícita. Tratamento: os efeitos secundários são, por predefinição, executados em série; os ganchos são bloqueados de forma rígida.
- Inconsistência com a tabela de arbitragem da lição 7:Após a ativação de uma habilidade principal, outra habilidade é acionada internamente. Tratamento: as tarefas secundárias não podem contornar a arbitragem; consulte os exemplos de conflitos.
- Erro silencioso de perda durante a fusão:Uma subtarefa continua a ser considerada bem-sucedida mesmo depois de ficar em vermelho. Solução: utilizar o mecanismo «fail-fast» ou definir explicitamente o estado «partial».
O que se pode fazer esta noite:Incluir propositadamente uma frase do tipo «alterar simultaneamente o mesmo ficheiro de configuração», para verificar se o GanPao escreve em paralelo; se for o caso, implementar primeiro um bloqueio rígido.
Exercício
- Escolha uma Skill e envie
reference/parallel.mdTabela de limites. - Adicione pelo menos 3 exemplos de isolamento/paralelismo com subagentes e execute-os até ficarem verdes.
- Adicionar uma frase à descrição do ficheiro SKILL.md: quando utilizar tarefas/subagentes e quando não o fazer.
- Uma ligação cruzada com a tabela de arbitragem da Lição 7 (mesmo ID de falha ou âncora do documento).
Critérios de conclusão: os colegas devem consultar apenas o ficheiro parallel.md e as avaliações, e ser capazes de indicar qual é a concorrência máxima e se a gravação no disco pode ser executada em paralelo, sem necessidade de te contactarem em privado.
Antevisão da próxima aula
Antevisão da próxima aula: Integrar os limites de paralelismo das tarefas/subagentes com o trace de produção — como gerar exemplos de isolamento com um único clique a partir dos registos de «interferência entre subtarefas» e como definir períodos de observação e limites de orçamento para Skills de elevada concorrência. Nesta aula, vamos primeiro estabilizar a tabela de limites offline e os testes de avaliação; sem sinais de alerta de paralelismo, as interações em produção limitar-se-ão a interferências silenciosas.
Í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 combinação de limites e arbitragem de conflitos de acionamento — https://school.myshirtai.com/?p=4191
- Lição 8: Incorporar o padrão Task/Sub-agente numa Skill: limites de paralelismo e isolamento de contexto (este artigo)


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