MinorBaek/wiki-synthesize

¿Qué hace wiki-synthesize?

Antes de la primera ejecución, lea docs/GOTCHAS.md en el kit (problemas operativos para ingesta, síntesis y lint) y docs/SEALS.md (el formato de sellos).

El "cirujano" de la capa de síntesis viva. Reorganiza el almacén de hallazgos ya verificados de una nota (## Key Findings en una nota de concepto; las secciones portadoras de afirmaciones de una nota de método) en un bloque de Estado del Conocimiento que captura el flujo de la evidencia: resuelto, disputado, superado, emergente. NUNCA inventa afirmaciones. Cada entrada rastrea un hallazgo existente, y cada entrada nueva o modificada se verifica contra el PDF de cada trabajo que cita antes de que el usuario la ratifique (verificación de evidencia, capa 2).

Modos

• predeterminado: /wiki-synthesize <NoteName> sintetiza una nota de concepto o método.
• lista de trabajo: /wiki-synthesize (sin argumento) ejecuta la comprobación 15 de wiki-lint, luego presenta check15_missing priorizada (campos listados en synthesis.priority_fields primero, luego por recuento de trabajos fuente, descendente) más check15_stale (candidatos a resíntesis), y pregunta qué nota procesar. La lista de trabajo es un backlog, no una obligación de hacer todo ahora. El conjunto elegible es lo que la comprobación 15 reporte en vivo; un recuento congelado escrito en un documento se vuelve obsoleto.
• por lotes: /wiki-synthesize --batch [N] es un modo de campaña de gestión por excepción (ola predeterminada de 8). Ejecuta la comprobación 15, forma una ola de prioridad, despacha subagentes paralelos (cada uno sigue SYNTHESIS-WORKFLOW.md y devuelve un bloque más un autoinforme, nunca escribe), bloquea cada escritura con la verificación de evidencia y scripts/synth_validate.py, escribe notas limpias, y escala en 4 desencadenantes (T1 número clave no verificable, T2 pérdida de información, T3 anomalía estructural, T4 baja confianza del subagente) y ante cualquier defecto que la comprobación encuentre. Consulte references/BATCH-WORKFLOW.md. Proponga primero los subagentes de una ola al usuario (qué hacen, cuántos, qué modelo) y espere la autorización.

Rol y límites

Hace: lee el almacén de hallazgos de una nota, pondera por evidence_level más medición en línea, redacta el bloque, verifica cada entrada nueva o modificada contra el PDF, presenta para ratificación, luego escribe (inserta el bloque y absorbe ## Controversies or Gaps), sella las notas fuente, ejecuta la puerta de verificación, registra.

NO hace: inventa números o afirmaciones, crea notas debates/ (marca candidatos en el informe en su lugar), toca notas por debajo del umbral de síntesis, ni escribe nada antes de la ratificación del usuario.

Dónde viven las cosas

Las rutas provienen de wiki.config.json. Notas: <wiki_root>/concepts/, methods/, papers/, books/. Lea siempre WIKI_SCHEMA.md (Capa de Síntesis Viva) antes de comenzar.

Umbral (debe cumplirse antes de sintetizar)

status: final Y (synthesis.min_sources o más trabajos fuente distintos (predeterminado 3) O al menos un trabajo fuente citado con evidence_level en synthesis.sr_levels (predeterminado SR-MA, SR)). Esto es exactamente la prueba de calificación de la comprobación 15 de wiki-lint. Si no se cumple: informar y DETENERSE.

Flujo de trabajo

Procedimiento completo en references/SYNTHESIS-WORKFLOW.md. Resumen: leer contratos, resolver la nota (exacto test -f/búsqueda de contenido, nunca un glob solo), puerta de umbral, guardia de pre-texto completo, agrupar hallazgos en subpreguntas, verificar entradas nuevas o modificadas contra el PDF, proponer el bloque en el chat con citas y páginas, ratificar, escribir (scripts/synth_write.py: insertar después de ## Definition, absorber Controversias, sellar), sellar las notas fuente (<kit>/tools/seal.py), diff de resíntesis si ya existe un bloque, luego registrar, volver a ejecutar la puerta de verificación y volver a ejecutar la comprobación 15.

Reglas de seguridad

• Nunca inventar. Cada entrada rastrea un hallazgo existente; sin nuevos números de memoria o de la nota fuente.
• Verificación de evidencia, capa 2: ninguna entrada nueva o modificada sin una verificación del PDF. Hasta 3 trabajos distintos, el orquestador los verifica; más, propone un subagente con el resumen restringido al diff y espera la aprobación del usuario. Cada defecto se relee en el PDF antes de cualquier cambio, y las notas fuente se sellan con el nombre de la nota. Un sello de texto completo en una nota fuente no protege lo que una nota dice sobre ese trabajo: en una auditoría pasada de este método, aproximadamente 4 de cada 10 pares de nota a nota fuente muestreados tenían un defecto.
• Humano en el bucle. Modos interactivos: proponer, ratificar, escribir (sin escritura antes de la aprobación del usuario). Modo por lotes: synth_validate.py bloquea cada escritura y los 4 desencadenantes escalan; nunca totalmente autónomo.
• Cero pérdida de información. Cada viñeta de ## Controversies or Gaps debe mapearse a una entrada del bloque antes de que esa sección sea absorbida.
• Guardia de pre-texto completo. Un artículo citado en la cohorte de pre-texto completo (una nota de artículo fechada antes de synthesis.prefulltext_cutoff y no sellada con texto completo, o sellada solo a nivel de resumen) reduce la confianza de la entrada afectada y obtiene una bandera ⚠ en línea; pausar la entrada solo si el número del que depende es en sí mismo no verificable. Los capítulos de libros son anclas de confianza a menos que su propio status: sea draft o stub, lo que indica que la nota fue ingerida sin el texto completo (una source_verification a nivel de texto completo anula el estado). synth_validate.py V4 aplica esto mecánicamente.
• Las afirmaciones necesitan fuentes. Cada entrada cita [[wikilinks]].
• Primero el sistema de archivos. Use las herramientas de archivos del anfitrión; no se requiere complemento de Obsidian ni MCP.

Habilidades relacionadas

• wiki-lint: La comprobación 15 produce la lista de trabajo de esta habilidad; la comprobación 32 marca un par (nota, trabajo) sin sello. Ejecútelo después de sintetizar para confirmar que no hay desviación (enlaces limpios, la comprobación 15 elimina la nota de missing).
• wiki-ingest: aguas arriba. Los hallazgos que esta habilidad reorganiza fueron escritos por ingesta.

Referencias

• references/SYNTHESIS-WORKFLOW.md: el procedimiento detallado, la plantilla del bloque, la lógica de guardia, el manejo de resíntesis.
• references/BATCH-WORKFLOW.md: modo por lotes, el bucle del orquestador, el resumen del subagente, la puerta de escritura V1-V5, los desencadenantes de escalado.
• scripts/synth_validate.py: la puerta de escritura y un barrido de todo el wiki. scripts/synth_write.py: inserción del bloque. <kit>/tools/seal.py: sellado.