Automação xEdit — Skill Hub
Esta skill é o ponto de entrada sempre carregado para qualquer trabalho com xEdit. É a única fonte de verdade para "qual caminho usar" e "o que nunca devo fazer". Skills de tarefas especializadas (ex.: xedit-conflict-audit) herdam seu roteamento, antipadrões e disciplina de verificação; elas não os reafirmam.
Caixa de ferramentas em resumo (divulgação progressiva, ciente de r6)
O daemon xEdit fork é melhor tratado como uma superfície de divulgação progressiva:
comece com as pequenas ferramentas de intenção MCP, pergunte ao daemon ativo quais blocos de
capacidade r6 ele suporta, depois mude para os padrões de chamada única mais ricos apenas quando a
chave system.capabilities.supports.* correspondente estiver presente.
- Descoberta e sessão —
xedit_session,xedit_list_capabilities. Chamexedit_sessionprimeiro em cada conversa. Então chamexedit_list_capabilitiesuma vez para ver o resumo de comandos,contractVersionExpectede as âncorassupports.*do r6. - Leitura de registros e conflitos —
xedit_find_record,xedit_read_record,xedit_inspect_conflicts. Estas são a espinha dorsal da W2 (auditoria de conflitos); ramifique para passagem atômica quando a W2 precisar de um bloco de resposta r6 que nenhuma ferramenta de intenção ainda expõe. - Passagem atômica —
xedit_call(comando, args). Para qualquer comando nativo do daemon que ainda não possui uma ferramenta de intenção. Ainda executa o pipeline completo (validação → estado → regras → auditoria). Use-o sempre que as ferramentas de intenção não se adequarem.
Para material de referência aprofundado, consulte primeiro a KB BGS estruturada (bgs_kb_query
/ bgs_kb_get). Registros de referência aprofundada ficam em
knowledge/bgs-kb/packs/core/records/xedit/ (consultável via bgs_kb_query /
bgs_kb_get).
Doutrina de roteamento (qual caminho usar)
| Forma da tarefa | Caminho |
|---|---|
| Intenção conhecida de alta frequência (auditar um conflito, ler um registro, executar um trabalho, escrever um patch) | Ferramenta de intenção MCP |
| Novo / depuração / composição livre de comandos nativos | Passagem atômica MCP: xedit_call(comando, args) — ainda na estrutura |
| Tempestade atômica exploratória (tentativa e erro, leitura-avaliação repetida, teste de hipótese) | Delegar a um subagente investigador somente leitura com esta skill carregada; o subagente consome seu próprio contexto, retorna um resumo destilado |
| Mutação em massa formalizável grande | MCP xedit_run_script (Lote 4+) com simulação e instantâneo |
| Daemon explicitamente em modo padrão (não MCP), depuração manual apenas | xedit-client.ps1 direto é aceitável — mas SOMENTE quando o usuário aceitou explicitamente o risco e o daemon não está em -automation-mcp-mode |
O agente nunca deve ter motivo para contornar o MCP. A passagem atômica existe para isso.
Julgamento de criação de patches / Patch authoring judgment
Visão geral
Criação de patches não é "fazer o vermelho desaparecer." É um pequeno argumento de compatibilidade: preservar o vencedor atual, encaminhar apenas os valores upstream que ainda devem sobreviver, e deixar para trás um plugin de patch reversível cujo conteúdo diga o que você pretendia. Classificação é uma alavanca de escolha única; aplicar patch é como você mantém dois valores intencionados de mods ativos ao mesmo tempo. Mas verdadeiro em princípio não é verdadeiro em escala de pacote: se o plano é costurar cada FormID porque "xEdit pode consertar tudo", o plano já está quebrado.
Use esta seção quando estiver prestes a criar ou julgar um patch através do MCP.
Use xedit-conflict-audit primeiro quando a questão ainda for "o que vence, o que
conflita, e isso deve ser patch vs. reordenar?" Essa skill é dona da
chamada patch-vs-reordenar; esta seção é dona de saber se o patch que você está prestes a
escrever está bem formado.
Fluxo de decisão: este patch está bem formado?
digraph patch_authoring_judgment {
// Salvamentos pendentes bloqueiam operações de ciclo de vida; veja Estado sujo e
// controle de reinicialização abaixo. Uma reinicialização não é um mecanismo de durabilidade.
rankdir=TB;
node [shape=box];
start [shape=doublecircle, label="Precisa de um patch?"];
audit [label="Auditar vencedor real + campos de conflito\n(xedit-conflict-audit se ainda não feito)"];
reorder [shape=diamond, label="A reordenação é suficiente\nsem perder valores necessários?"];
no_patch [shape=doublecircle, label="Sem patch: reordenar / deixar vencedor\ndepois verificar leitura"];
winner [label="Copiar/mirar o vencedor atual,\nnão um perdedor mais antigo"];
intent [label="Nomear cada valor a encaminhar\nO que ele faz? Por que deve sobreviver?"];
noise [shape=diamond, label="Algum valor copiado inalterado\nou ruído tipo ITM/verde?"];
clean [label="Remover valores inalterados/sem intenção"];
refs [shape=diamond, label="Deletando ou marcando para deletar\nregistros/elementos?"];
referenced [label="Executar auditoria referenced_by / referência
Parar se consequências são desconhecidas"];
esl [label="Escolher forma do patch deliberadamente\nGeralmente ESP sinalizado como ESL quando seguro; evitar ESL/ESM nativo se liberdade de ordem importa"];
reversible [shape=diamond, label="Patch reversível separado\n(sem edição direta do mod de origem, sem derramamento de sobrescrita não gerenciada)?"];
fix_shape [label="Mover para mod MO2 gerenciado\nou criar plugin de patch dedicado"];
verify [label="Salvar + reiniciar + reler\nsobrescrita vencedora mostra valores pretendidos"];
pass [shape=doublecircle, label="Patch bem formado"];
start -> audit -> reorder;
reorder -> no_patch [label="sim"];
reorder -> winner [label="não, preciso de valores combinados"];
winner -> intent -> noise;
noise -> clean [label="sim"];
noise -> refs [label="não"];
clean -> refs;
refs -> referenced [label="sim"];
refs -> esl [label="não"];
referenced -> esl;
esl -> reversible;
reversible -> fix_shape [label="não"];
reversible -> verify [label="sim"];
fix_shape -> verify -> pass;
// Contrato 0.23 salvamentos pendentes usam xedit_flush; reinicialização sozinha não é prova.
verify [label="Salvar + inspecionar estado pendente; xedit_flush se necessário; releitura fresca"];
}
Correção de salvamento adiado: O nó histórico
Salvar + reiniciar + relerdo diagrama está substituído. Sesession.savereportar umsavePendingShutdownCountdiferente de zero, inspecionexedit_dirty, então usexedit_flushem um daemon de contrato 0.23. A ferramenta valida a resposta de drenagem e confirma a auto-saída prometida do daemon. UmpartialoulastFlushdesconhecido não é prova de durabilidade. A parada/reinicialização normal permanece recusada enquanto uma fila pendente ativa existir;force:trueabandona o estado e nunca é evidência de durabilidade.
Verificações de criação
- Encaminhe o vencedor. O jogo lê a sobrescrita final/vencedora para um FormID. Construa o patch a partir do vencedor atual, então encaminhe apenas os valores de mod mais antigos que ainda precisam sobreviver.
- Nenhuma carga inalterada. Se um valor copiado não muda de significado, é ruído estilo ITM, não compatibilidade. Remova-o a menos que você possa declarar por que está intencionalmente carregado.
- Patch como camada separada. Não arraste valores diretamente para o mod de origem só porque é a coluna mais à direita hoje. Um patch deve ser reversível desabilitando/removendo a camada do patch, não deletando campos manualmente do plugin de outra pessoa.
- Preserve referências. Se a exclusão ou marcação de exclusão entrar no plano, pare e execute o caminho referenciado-por/releitura primeiro. Referências desconhecidas significam raio de explosão desconhecido.
- Escolha a forma do plugin deliberadamente. Patches de compatibilidade comuns geralmente querem liberdade de ordenação ESP normal mais sinalização ESL quando seguro. O comportamento de ordem de carregamento ESL/ESM nativo não é uma atualização de limpeza gratuita.
- Bom patch vs. patch improvisado. Um bom patch tem intenção nomeada por valor encaminhado e reduz a dívida de conflitos. Um patch improvisado copia registros inteiros, edita mods de origem, ou tenta costurar cada FormID porque a ordenação foi tratada como irrelevante.
Disciplina de consulta KB
Esta seção de julgamento é independente de jogo. Consulte a KB para regras específicas de jogo sobre criação de patches, ressalvas de famílias de registros e fatos atuais da cadeia de ferramentas em vez de fossilizá-los aqui.
bgs_kb_query({ consulta: "regras de criação de patch xedit", dominios: ["xedit", "ordem-de-carregamento"], jogos: ["<jogo atual>"] })
Se a KB estiver silenciosa, marque [LACUNA] e mantenha a regra de criação de patch no nível da estrutura
em vez de inventar uma doutrina específica do jogo.
Bandeiras Vermelhas (PARE)
| Pensamento | Realidade |
|---|---|
| "Está vermelho, então copie o valor da esquerda." | Vermelho é um convite para inspecionar. Não é um veredito de que o valor perdedor deve sobreviver. |
| "O mod mais à direita está errado; vou editá-lo diretamente." | Então você fez do mod de origem o patch. Use um patch de sobrescrita separado para que a reversão seja limpa. |
| "Ordenação não importa porque xEdit pode corrigir qualquer coisa." | Em princípio, sim; em centenas de milhares de FormIDs, não. Use ordenação para reduzir a dívida de reparo, então aplique patch no restante significativo. |
| "Valores copiados inalterados/verdes são inofensivos." | Eles são carga sem intenção. Se eles não mudam o significado, remova-os. |
| "ESL nativo é mais limpo que ESP sinalizado como ESL." | ESL/ESM nativo pode custar liberdade de ordenação normal. Use ESP sinalizado como ESL quando essa for a forma segura do patch. |
| "Isso parece não utilizado; delete." | Referenciado-por primeiro. Exclusão sem conhecimento de referência é raio de explosão desconhecido. |
Racionalizações
| Desculpa | Realidade |
|---|---|
| "Vou apenas arrastar um campo para o plugin vencedor." | Um campo ainda é uma edição de mod de origem. Crie uma camada de patch, ou o você do futuro removerá campos soltos manualmente, um por um. |
| "O patch deve preservar tudo que qualquer mod tocou." | Preserve a intenção, não o histórico. Algumas edições são centrais para o mod; algumas são preferências incidentais do autor que devem perder para uma regra sistêmica. |
| "Não sei o que este campo faz, então vou copiar a versão que parece plausível." | Significado de campo desconhecido é uma tarefa de pesquisa, não um jogo de dados. Leia a estrutura do registro, CK/wiki/exemplos da comunidade e comportamento real no pacote. |
| "Sobrescrever é aceitável; MO2 vê." | Sobrescrever é derramamento. Um patch real pertence a uma camada de mod gerenciada com um nome que o você do futuro possa entender. |
| "A resposta disse ok; o patch está pronto." | Aceitação do patch é a releitura da sobrescrita vencedora após salvar/reiniciar, com os valores pretendidos visíveis e nenhuma carga não intencionada. |
Verificações de capacidade de divulgação progressiva R6
Não presuma que todo daemon é r6. Leia xedit_list_capabilities uma vez e ramifique
com base nas chaves de suporte abaixo. Em daemons pré-r6, volte para os padrões mais antigos de
lista-explícita-de-registros / caminhada-filho / loop-por-registro; em daemons r6+, use o
formulário de chamada única ou ciente de página para reduzir viagens de ida e volta e preservar contexto.
| Chave de capacidade | Contrato | Prefira este padrão | Registro KB |
|---|---|---|---|
supports.childGroupNavigation | 0.13 | Navegar em ChildGroups de CELL/WRLD/DIAL/QUST através de stubs elements.children | xedit.childgroup-navigation.v1 |
supports.createParentSpec | 0.16 / 0.18 | Criar registros diretamente sob ChildGroups pai com parent em records.create | xedit.records-create-parent-spec.v1 |
supports.elementsChildrenPagination | 0.17 | Paginar elements.children com limit / offset | xedit.elements-children-pagination.v1 |
supports.reverseNavigation | 0.19 | Adicionar includeParents:true e ler relations.parents | xedit.reverse-navigation.v1 |
Para todo o delta do contrato r6, consulte o registro KB xedit.r6-contract-summary.v1.
Navegação ChildGroup (supports.childGroupNavigation)
Em daemons r6+, elements.children em registros CELL, WRLD, DIAL e QUST
retorna uma entrada filha virtual com kind: "child_group". Trate essa entrada como um
stub de navegação somente leitura, não como um elemento mutável real.
Use-o uma geração de cada vez:
elements.children({ arquivo, formId, caminho: "\\Child Group" })
elements.children({ arquivo, formId, caminho: "\\Child Group\\Persistent" })
elements.children({ arquivo, formId, caminho: "\\Child Group\\Temporary" })
elements.children({ arquivo, formId, caminho: "\\Child Group\\Visible when Distant" })
elements.children({ arquivo, formId, caminho: "\\Child Group\\Block X, Y" })
elements.children({ arquivo, formId, caminho: "\\Child Group\\Block X, Y\\Sub-Block M, N" })
- Caminhe exatamente o próximo nível; não peça a árvore inteira quando uma página ou um rótulo ChildGroup for suficiente.
- Os caminhos
\\Child Group...são sintéticos e SOMENTE LEITURA. Verbos de mutação devem usar localizadores planos de FormID ({ arquivo, formId }) ou uma especificaçãorecords.create.parent; não passe caminhos de localizador sintéticos para mutadores. - Para células WRLD, use
Persistentou a rota Bloco/Sub-Block/coordenada dependendo do grupo filho alvo. - Referência aprofundada:
xedit.childgroup-navigation.v1.
Paginação elements.children (supports.elementsChildrenPagination)
Em daemons r6+, elements.children aceita limit e offset:
elements.children({ arquivo, formId, caminho, limite: 200, deslocamento: 0 })
limiteé limitado a 1-1000 e o padrão é 200.- Respostas incluem
count,total,offsetetruncated. - Se
truncatedfor verdadeiro, mantenha o mesmolimite, adicionecountaoffsete busque a próxima página até cobrir. - Não presuma que grupos filho CELL são pequenos: FO4 vanilla CELL
00000025Temporarycontém 742 registros. - Referência aprofundada:
xedit.elements-children-pagination.v1.
Navegação reversa (supports.reverseNavigation)
Em daemons r6+, adicione includeParents: true quando precisar saber propriedade ou
contêiner sem um segundo verbo. Chamadas de leitura suportadas incluem:
records.getrecords.find_by_form_id/records.find_by_editor_ide wrappers MCP comoxedit_find_recordrecords.master_or_selfrecords.winning_overrideelements.getelements.children
A resposta pode incluir:
relations.parents: [{ localizador, objeto }, ...]
Os pais são mais próximos primeiro com um limite de profundidade do daemon de 16. Esta é a resposta
preferida para "qual CELL é dona deste REFR?" ou "qual grupo QUST/DIAL contém este
filho?" Use a cadeia de pais como evidência de releitura; não construa um loop de índice reverso
personalizado a menos que a chave de suporte esteja ausente. Referência aprofundada:
xedit.reverse-navigation.v1.
Especificação pai de records.create (supports.createParentSpec)
A criação de registros mutantes em ChildGroups é bloqueada pelo r6 e ainda requer o
caminho normal de consentimento de mutação MCP. Quando suportado, escreva o pai alvo
explicitamente em vez de tentar mutar caminhos sintéticos \\Child Group
…
[truncado para tradução]