AULA 10 / 06.11.2026
Objetivo desta aula: irás conseguir... Número de versão, registo de alterações, matriz de compatibilidade e condições de reversão Incluído no repositório do Skill reference/lista-de-verificação-de-lançamento.md, em vez de dizer na conversa «envio esta noite». Na aula anterior, já escreveste sobre o contrato de coordenadas «computer-use» e os limites do «Harness»:https://school.myshirtai.com/?p=4478. Esta aula, para além do contrato, abordaPublicação e gestão——Quem alterou o quê, se é possível integrar, e como proceder em caso de falha. A estrutura consiste em uma formação (documentação + exercícios); como não foi executado localmente, mas sim através do CI / Skills API, não se apresentam resultados numéricos de execução na primeira pessoa.
Se não houver uma lista de lançamentos no armazém, o sistema online assumirá por defeito
mais recente: Qualquer pessoa pode substituir a Skill que o teu Agent está a utilizar.
Pré-requisitos e objetivos verificáveis
Por favor, conclua primeiro a Lição 9, «Incorporar o contrato de coordenadas de utilização do computador e os limites do Harness na Skill»:https://school.myshirtai.com/?p=4478. É necessário ter, pelo menos, à disposição: uma Skill de alvo que possa ser carregada,referência/ Permissões de escrita ou possibilidade de enviar um PR; hook de avaliação da Lição 6 (os exemplos de falha podem ser incluídos na regressão). Para reforçar os conceitos básicos anteriores, consulte: 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; Lição 6 https://school.myshirtai.com/?p=4048; Lição 7 https://school.myshirtai.com/?p=4191; Lição 8 https://school.myshirtai.com/?p=4331.
Esta noite, só tenho noventa minutos para...Um Skill: adicionar a lista de publicações, sem reestruturar todos os scripts ao mesmo tempo.
- Objetivo A:Enviar
reference/lista-de-verificação-de-lançamento.md(incluindo as quatro secções: versão, alterações, compatibilidade e reversão). - Objetivo B:Apresentar dois exemplos de falhas — omissão do campo de versão e omissão da condição de reversão — que podem ser identificados pelo mecanismo de avaliação da Lição 6.
- Objetivo C:Na lista, especifique se «a referência de produção está fixada a um ID de versão / se é proibido atualizar automaticamente para a versão mais recente». Caso não tenha sido testado localmente, basta indicar «Não foi executado em CI local» ao enviar a API.
Conceito: O que é que a lista de lançamentos deve definir de forma inalterável?
Na lição 9, certifique-se de que as coordenadas dos pontos estão corretas. A lição 10 aborda o seguinte: assim que uma Skill entra no diretório partilhado ou na API de Skills, a questão das versões em falta e das reversões passa a ser decidida por «quem a tiver carregado por último». Nos materiais públicos, as Agent Skills incluem SKILL.md pasta; quando se cria uma versão no lado da API, os uploads subsequentes têm de manter o mesmo immutable nome, as versões são identificadas por um ID único, podendo também ser referidas por meio de literais mais recente——É precisamente neste ponto que a produção requer uma decisão explícita.
Esta lista não é mais uma reflexão sobre o ficheiro README, mas sim uma lista de verificação antes da publicação. Sugiro que se inclua, pelo menos, quatro pontos:
- Versão:Etiquetas de armazém /
SKILL.mdCampo «Versão interna» / «ID da versão da API»: como é que estes três se correspondem? - Registo de alterações:Nesta alteração, foram modificados a descrição, o script ou o contrato; quais são as frases de ativação afetadas?
- Compatível com:Versão do Claude Code / API / Harness / contrato de coordenadas a que se baseia; se entra em conflito com a declaração «computer-use» da lição 9.
- Reverter:Quais são os sinais de falha, para que ID de versão ou tag do Git se deve reverter e quem tem autorização para executar esta ação.

Exercício: Escreva uma lista de publicações que possa ser colada
Criar um novo elemento na secção «Skill» reference/lista-de-verificação-de-lançamento.md. O modelo abaixo pode ser colado diretamente e os campos entre parênteses angulares podem ser alterados; o bloco de código destina-se apenas a exercícios de documentação, não tendo sido executado localmente em CI.
# Lista de verificação de lançamento —
## Versão
- etiqueta git:
- campo «versão» do ficheiro SKILL.md:
- skill_id da API / ID da versão (se carregado):
- pin de produção: ID da versão | mais recente (predefinição: ID do pin)
## Registo de alterações
- gatilhos / descrição:
- scripts / referência:
- alterações compatíveis? sim/não — migração:
## Compatibilidade
- Claude Code / interface da API:
- Harness / contrato de utilização do computador (lição 9):
- ID do conjunto de testes de avaliação (lição 6):
## Revertimento
- sinais de falha:
- reverter para:
- proprietário / prazo:
- interromper se:
Lista de materiais: permissão de escrita ou PR; capacidade de adicionar dois casos de uso de «restrição de publicação» ao conjunto de testes da lição 6; capacidade de incluir o resultado da verificação da lista na descrição do PR. Na ausência de incidentes reais em produção, utilizar exemplos simulados: alteração da descrição sem atualização da versão, com o ambiente de produção ainda a seguir a versão anterior. mais recente.

- Copiar o modelo para
reference/lista-de-verificação-de-lançamento.md, preencha o campo «Skill» com o caractere «真». - Definir o «pin de produção» por predefinição como um ID de versão específico ou uma etiqueta Git, proibindo a utilização apenas de «latest».
- Adicionar dois exemplos de respostas incorretas ao índice de avaliação da lição 6 (ver a secção seguinte).
- No texto do PR, assinalar a lista; na revisão, verificar apenas se os quatro campos estão em branco.
Exemplos de falhas e o gancho de avaliação da lição 6
A avaliação não é opcional. Na 6.ª aula, já foi ensinado como utilizar um conjunto de avaliações para a regressão; nesta aula, é necessário que a publicação do controlo de acesso também possa ser acionada pelo mesmo gancho. Preparem, pelo menos, duas entradas.Deve falharExemplo:
| Exemplo | O que falta? | Resultados esperados da avaliação |
|---|---|---|
| Versão com falhas | Sem etiqueta Git / Sem campo de versão / Sem pin | Luz vermelha no controlo de acesso, proibida a entrada |
| Revertida a falha | Existe um registo de alterações, mas não há sinais de falha / reversão para | Luz vermelha no controlo de acesso, proibida a entrada |
| Espaço de compatibilidade | Alterou «computer-use», mas não fez referência ao contrato da lição 9 | Aviso ou luz vermelha (a definir pela equipa) |

Insira o nome do ficheiro de exemplo na linha «eval suite id» da lista, por exemplo: evals/release-missing-version.md. Desta forma, o «hook» da lição 6 e o «control de acesso» da lição 10 partilham o mesmo conjunto de convenções de percursos, evitando que os dois conjuntos de diretórios fiquem desfasados.
Nota:Este artigo não inclui a criação de uma versão através da API Skills no computador local, nem a execução do CI do repositório. Os critérios de avaliação do exercício consistem na apresentação completa do «ficheiro de lista de verificação + dois exemplos de falha + marcação do PR»; não escreva no exercício de documentação que «já foi carregado em produção».
Antevisão da próxima aula
Antevisão da próxima aula (a confirmar): Lançamento gradual e lista branca do MCP — como incluir um ID de versão fixo no tráfego de lançamento gradual e como adicionar chamadas de ferramentas de alto risco à lista branca e definir um período de observação. Nesta aula, vamos primeiro garantir que a lista de lançamentos offline e os sinais de alerta nas avaliações funcionem de forma estável; sem condições de reversão, o lançamento gradual só irá ampliar o âmbito dos incidentes.
Í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/Subagente numa Skill: limites de paralelismo e isolamento de contexto — https://school.myshirtai.com/?p=4331
- Lição 9: Incorporar o contrato de coordenadas de utilização do computador e os limites do Harness na Skill — https://school.myshirtai.com/?p=4478
- Lição 10: Publicar a lista de lançamentos da Skill no repositório: versões, registo de alterações, compatibilidade e reversão (este artigo)
A nossa opinião:O valor da lista de lançamentos não reside no facto de ser «mais um Markdown», mas sim em obrigar-te a responder a questões relativas à versão, à compatibilidade e à reversão antes da integração. Fixar o ID da versão e incluir o exemplo de falha da lição 6 é mais fácil de verificar do que um simples aviso verbal do tipo «cuidado com a versão mais recente».
Links de referência
- Documentação do Claude Code: Alargar as capacidades do Claude com competências
- Visão geral das competências dos agentes (padrões abertos)
- GitHub: anthropics/skills
- Documentação da API do Claude: Versões das competências
- Lição 9: Contrato de coordenadas de utilização do computador e Harness
- Lição 6: Regressão de uma Skill utilizando um conjunto de avaliação


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