Skill Hub de Automatización de xEdit
Este skill es el punto de entrada que siempre se carga para cualquier trabajo con xEdit. Es la fuente única de verdad para "qué camino uso" y "qué nunca debo hacer". Los skills de tareas especializadas (ej. xedit-conflict-audit) heredan su enrutamiento, anti-patrones y disciplina de verificación; no los repiten.
Caja de herramientas de un vistazo (divulgación progresiva, compatible con r6)
El demonio xEdit bifurcado se trata mejor como una superficie de divulgación progresiva:
comienza con las pequeñas herramientas de intención MCP, pregunta al demonio en vivo qué bloques de capacidad r6
soporta, luego cambia a los patrones más ricos de una sola llamada solo cuando la
clave system.capabilities.supports.* correspondiente esté presente.
- Descubrimiento y sesión —
xedit_session,xedit_list_capabilities. Llama axedit_sessionprimero en cada conversación. Luego llama axedit_list_capabilitiesuna vez para ver el resumen de comandos,contractVersionExpectedy las anclassupports.*de r6. - Lectura de registros y conflictos —
xedit_find_record,xedit_read_record,xedit_inspect_conflicts. Estos son la columna vertebral de W2 (auditoría de conflictos); deriva al paso atómico cuando W2 necesita un bloque de respuesta r6 que ninguna herramienta de intención expone todavía. - Paso atómico —
xedit_call(command, args). Para cualquier comando nativo del demonio que aún no tenga una herramienta de intención. Aún ejecuta el pipeline completo (validación → estado → reglas → auditoría). Úsalo siempre que las herramientas de intención no se ajusten.
Para material de referencia profundo, consulta primero la BGS KB estructurada (bgs_kb_query
/ bgs_kb_get). Los registros de referencia profunda viven en
knowledge/bgs-kb/packs/core/records/xedit/ (consultables mediante bgs_kb_query /
bgs_kb_get).
Doctrina de enrutamiento (qué camino usar)
| Forma de la tarea | Camino |
|---|---|
| Intención conocida de alta frecuencia (auditar un conflicto, leer un registro, ejecutar un trabajo, escribir un parche) | Herramienta de intención MCP |
| Novedoso / depuración / composición libre de comandos nativos | Paso atómico MCP: xedit_call(command, args) — aún en el arnés |
| Tormenta de operaciones atómicas exploratoria (prueba y error, lectura-evaluación repetida, prueba de hipótesis) | Delegar a un sub-agente investigador de solo lectura con este skill cargado; el sub-agente consume su propio contexto, devuelve un resumen destilado |
| Mutación masiva formalizable grande | xedit_run_script MCP (Lote 4+) con ejecución en seco + instantánea |
| Demonio explícitamente en modo predeterminado (no MCP), solo depuración manual | xedit-client.ps1 directo es aceptable — pero SOLO cuando el usuario ha aceptado explícitamente el riesgo y el demonio no está en -automation-mcp-mode |
El agente nunca debería tener una razón para omitir el MCP. El paso atómico existe para eso.
Juicio de creación de parches
Descripción general
La creación de parches no es "hacer que desaparezca lo rojo". Es un pequeño alegato de compatibilidad: preservar el ganador actual, reenviar solo los valores del mod anterior que aún deberían sobrevivir, y dejar un plugin de parche reversible cuyo contenido diga lo que querías decir. La ordenación es una palanca de elección única; el parcheado es cómo mantienes activos los valores previstos de dos mods a la vez. Pero lo verdadero en principio no es verdadero a escala de pack: si el plan es unir cada FormID porque "xEdit puede arreglar cualquier cosa", el plan ya está roto.
Usa esta sección cuando estés a punto de crear o juzgar un parche a través del MCP.
Usa xedit-conflict-audit primero cuando la pregunta aún sea "qué gana, qué
conflictos, y debería ser esto parche vs reordenación?" Ese skill es dueño de la
llamada parche-vs-reordenación; esta sección es dueña de si el parche que estás a punto de
escribir está bien formado.
Flujo de decisión: ¿está bien formado este parche?
digraph patch_authoring_judgment {
// Los guardados pendientes de cierre bloquean las operaciones del ciclo de vida; consulte
// Estado sucio y control de reinicio a continuación. Un reinicio no es un mecanismo de durabilidad.
rankdir=TB;
node [shape=box];
start [shape=doublecircle, label="¿Necesitas un parche?"];
audit [label="Auditar el ganador real + los campos en conflicto\n(xedit-conflict-audit si aún no se hizo)"];
reorder [shape=diamond, label="¿Es suficiente la reordenación\nsin perder los valores necesarios?"];
no_patch [shape=doublecircle, label="Sin parche: reordenar / dejar al ganador\nluego verificar la relectura"];
winner [label="Copiar/apuntar al ganador actual\nno a un perdedor más antiguo"];
intent [label="Nombrar cada valor a reenviar\n¿Qué hace? ¿Por qué debería sobrevivir?"];
noise [shape=diamond, label="¿Hay valores copiados sin cambios\no ruido verde/ITM?"];
clean [label="Eliminar valores sin cambios/sin intención"];
refs [shape=diamond, label="¿Eliminar o marcar para eliminar\nregistros/elementos?"];
referenced [label="Ejecutar auditoría de referenced_by / referencia\nDetener si las consecuencias son desconocidas"];
esl [label="Elegir la forma del parche deliberadamente\nGeneralmente ESP marcado como ESL cuando sea seguro; evitar ESL/ESM nativo si la libertad de ordenación importa"];
reversible [shape=diamond, label="¿Parche reversible separado\n(sin edición directa del mod fuente, sin desbordamiento de sobrescritura no administrada)?"];
fix_shape [label="Mover a un mod MO2 administrado\no crear un plugin de parche dedicado"];
verify [label="Guardar + reiniciar + releer\nla anulación ganadora muestra los valores previstos"];
pass [shape=doublecircle, label="Parche bien formado"];
start -> audit -> reorder;
reorder -> no_patch [label="sí"];
reorder -> winner [label="no, se necesitan valores combinados"];
winner -> intent -> noise;
noise -> clean [label="sí"];
noise -> refs [label="no"];
clean -> refs;
refs -> referenced [label="sí"];
refs -> esl [label="no"];
referenced -> esl;
esl -> reversible;
reversible -> fix_shape [label="no"];
reversible -> verify [label="sí"];
fix_shape -> verify -> pass;
// Los guardados pendientes del contrato 0.23 usan xedit_flush; el reinicio solo no es prueba.
verify [label="Guardar + inspeccionar estado pendiente; xedit_flush si es necesario; relectura fresca"];
}
Corrección de guardado diferido: El nodo histórico
Guardar + reiniciar + releerdel diagrama está reemplazado. Sisession.saveinforma unsavePendingShutdownCountdistinto de cero, inspeccionaxedit_dirty, luego usaxedit_flushen un demonio de contrato 0.23. La herramienta valida la respuesta de drenaje y confirma la auto-salida prometida del demonio. UnlastFlushpartialo desconocido no es prueba de durabilidad. La parada/reinicio normal permanece rechazada mientras exista una cola pendiente activa;force:trueabandona el estado y nunca es evidencia de durabilidad.
Verificaciones de creación
- Reenviar al ganador. El juego lee la anulación final/ganadora para un FormID. Construye el parche a partir del ganador actual, luego reenvía solo los valores del mod anterior que aún necesitan sobrevivir.
- Sin carga inalterada. Si un valor copiado no cambia de significado, es ruido de tipo ITM, no compatibilidad. Elimínalo a menos que puedas declarar por qué se transporta intencionalmente.
- Parche como capa separada. No arrastres valores directamente al mod fuente solo porque es la columna más a la derecha hoy. Un parche debería ser reversible al deshabilitar/eliminar la capa del parche, no eliminando manualmente campos del plugin de otra persona.
- Preservar referencias. Si la eliminación o el marcado para eliminar entra en el plan, detente y ejecuta la ruta de referenciado por/relectura primero. Referencias desconocidas significan radio de explosión desconocido.
- Elegir la forma del plugin deliberadamente. Los parches de compatibilidad ordinarios generalmente quieren libertad de ordenación ESP normal más el marcado ESL cuando sea seguro. El comportamiento de orden de carga ESL/ESM nativo no es una mejora de limpieza gratuita.
- Buen parche vs parche curita. Un buen parche tiene intención nombrada por cada valor reenviado y reduce la deuda de conflictos. Un parche curita copia registros completos, edita mods fuente, o intenta unir cada FormID porque la ordenación se trató como irrelevante.
Disciplina de consulta KB
Esta sección de juicio es independiente del juego. Consulta la KB para conocer los problemas específicos del juego al crear parches, advertencias sobre familias de registros y hechos actuales del conjunto de herramientas en lugar de fosilizarlos aquí.
bgs_kb_query({ query: "xedit patch authoring gotchas", domains: ["xedit", "load-order"], games: ["<juego actual>"] })
Si la KB está en silencio, marca [GAP] y mantén la regla de parcheado a nivel del framework
en lugar de inventar una doctrina específica del juego.
Banderas Rojas (ALTO)
| Pensamiento | Realidad |
|---|---|
| "Está rojo, así que copia el valor izquierdo." | El rojo es una indicación para inspeccionar. No es un veredicto de que el valor perdedor deba sobrevivir. |
| "El mod más a la derecha está mal; lo editaré directamente." | Entonces convertiste el mod fuente en el parche. Usa un parche de anulación separado para que la reversión sea limpia. |
| "La ordenación no importa porque xEdit puede parchear cualquier cosa." | En principio, sí; en cientos de miles de FormID, no. Usa la ordenación para reducir la deuda de reparación, luego parchea el resto significativo. |
| "Los valores copiados verdes/sin cambios son inofensivos." | Son carga sin intención. Si no cambian el significado, elimínalos. |
| "ESL nativo es más limpio que ESP marcado como ESL." | ESL/ESM nativo puede costar libertad de ordenación normal. Usa ESP marcado como ESL cuando esa sea la forma de parche segura. |
| "Esto parece no usarse; elimínalo." | Referenciado por primero. La eliminación sin conocimiento de referencia es radio de explosión desconocido. |
Racionalizaciones
| Excusa | Realidad |
|---|---|
| "Solo arrastraré un campo al plugin ganador." | Un campo sigue siendo una edición al mod fuente. Haz una capa de parche, o el tú del futuro eliminará manualmente campos perdidos uno por uno. |
| "El parche debería preservar todo lo que cualquier mod tocó." | Preserva la intención, no la historia. Algunas ediciones son centrales para el mod; algunas son preferencias incidentales del autor que deberían perder frente a una regla sistémica. |
| "No sé qué hace este campo, así que copiaré la versión que parezca plausible." | El significado de un campo desconocido es una tarea de investigación, no un lanzamiento de dados. Lee la estructura del registro, CK/wiki/ejemplos de la comunidad y el comportamiento real dentro del pack. |
| "Sobrescribir está bien; MO2 lo ve." | Sobrescribir es un derrame. Un parche real pertenece a una capa de mod administrada con un nombre que el tú del futuro pueda entender. |
| "La respuesta dijo ok; el parche está listo." | La aceptación del parche es la relectura de la anulación ganadora después de guardar/reiniciar, con los valores previstos visibles y sin carga no deseada. |
Verificaciones de capacidad de divulgación progresiva R6
No asumas que todos los demonios son r6. Lee xedit_list_capabilities una vez y bifurca
en las claves de soporte a continuación. En demonios pre-r6, recurre a los patrones de bucle
más antiguos de lista explícita de registros/caminata de hijos/por registro; en demonios r6+, usa el
formulario de una sola llamada o consciente de página para reducir los viajes de ida y vuelta y preservar el contexto.
| Clave de capacidad | Contrato | Prefiere este patrón | Registro KB |
|---|---|---|---|
supports.childGroupNavigation | 0.13 | Navegar por los ChildGroups de CELL/WRLD/DIAL/QUST a través de stubs elements.children | xedit.childgroup-navigation.v1 |
supports.createParentSpec | 0.16 / 0.18 | Crear registros directamente bajo ChildGroups padre con parent de records.create | xedit.records-create-parent-spec.v1 |
supports.elementsChildrenPagination | 0.17 | Paginar elements.children con limit / offset | xedit.elements-children-pagination.v1 |
supports.reverseNavigation | 0.19 | Agregar includeParents:true y leer relations.parents | xedit.reverse-navigation.v1 |
Para todo el delta del contrato r6, consulta el registro KB xedit.r6-contract-summary.v1.
Navegación por ChildGroup (supports.childGroupNavigation)
En demonios r6+, elements.children en registros CELL, WRLD, DIAL y QUST
devuelve una entrada secundaria virtual con kind: "child_group". Trata esa entrada como un
stub de navegación de solo lectura, no como un elemento mutable real.
Úsalo una generación a la vez:
elements.children({ file, formId, path: "\\Child Group" })
elements.children({ file, formId, path: "\\Child Group\\Persistent" })
elements.children({ file, formId, path: "\\Child Group\\Temporary" })
elements.children({ file, formId, path: "\\Child Group\\Visible when Distant" })
elements.children({ file, formId, path: "\\Child Group\\Block X, Y" })
elements.children({ file, formId, path: "\\Child Group\\Block X, Y\\Sub-Block M, N" })
- Camina exactamente el siguiente nivel; no pidas todo el árbol cuando una página o una etiqueta de ChildGroup es suficiente.
- Las rutas
\\Child Group...son sintéticas y DE SOLO LECTURA. Los verbos de mutación deben usar localizadores de FormID planos ({ file, formId }) o una especificaciónrecords.create.parent; no pases rutas de localizador sintéticas a los mutadores. - Para celdas WRLD, usa
Persistento la ruta de Bloque/Sub-Bloque/coordenada dependiendo del grupo de hijos objetivo. - Referencia profunda:
xedit.childgroup-navigation.v1.
Paginación de elements.children (supports.elementsChildrenPagination)
En demonios r6+, elements.children acepta limit y offset:
elements.children({ file, formId, path, limit: 200, offset: 0 })
limitestá limitado a 1-1000 y tiene un valor predeterminado de 200.- Las respuestas incluyen
count,total,offsetytruncated. - Si
truncatedes verdadero, mantén el mismolimit, agregacountaoffsety obtén la página siguiente hasta cubrir todo. - No asumas que los grupos de hijos de CELL son pequeños:
Temporaryde CELL00000025de FO4 vanilla contiene 742 registros. - Referencia profunda:
xedit.elements-children-pagination.v1.
Navegación inversa (supports.reverseNavigation)
En demonios r6+, agrega includeParents: true cuando necesites conocer la propiedad o
contención sin un segundo verbo. Las llamadas de lectura compatibles incluyen:
records.getrecords.find_by_form_id/records.find_by_editor_idy envoltorios MCP comoxedit_find_recordrecords.master_or_selfrecords.winning_overrideelements.getelements.children
La respuesta puede incluir:
relations.parents: [{ locator, object }, ...]
Los padres están ordenados del más cercano primero con un límite de profundidad del demonio de 16. Esta es la respuesta
preferida a "¿Qué CELL posee este REFR?" o "¿Qué grupo QUST/DIAL contiene a este
hijo?" Usa la cadena de padres como evidencia de relectura; no construyas un bucle
personalizado de índice inverso a menos que la clave de soporte esté ausente. Referencia profunda:
xedit.reverse-navigation.v1.
Especificación de padre de records.create (supports.createParentSpec)
La creación de registros mutables en ChildGroups está limitada por r6 y aún requiere
la ruta normal de consentimiento de mutación MCP. Cuando sea compatible, especifica el padre objetivo
explícitamente en lugar de intentar mutar rutas sintéticas \\Child Group
...
[truncado para traducción]