# Instrucciones para el agente: Documento de trabajo: notas compartidas con revisión humana Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa. - Dificultad: intermedio - Guía completa: https://lab.wisd.ai/hub/simple-markdown-editor --- ## Para el agente: cómo acompañar al usuario 1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo. 2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo). 3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe. 4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error. 5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación. 6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar. --- ## Pasos de configuración ### Prepara una prueba acotada Haz una copia de una nota y acuerda quién escribe en cada turno. Elige objetivo, preguntas abiertas y decisiones como secciones del documento. ### Configura Obsidian Skills Sigue [Obsidian Skills](/hub/obsidian-agent-skills), incluidos sus requisitos, configuración y comprobación actuales. Recarga el arnés y pide editar una copia de nota usando la skill de Markdown; abre el wikilink y comprueba el callout en Obsidian. ### Configura Human Review Sigue [Human Review](/hub/human-review-skill), incluidos sus requisitos, configuración y comprobación actuales. Comprueba una ronda sobre una copia Markdown: envía un comentario, reanuda el agente si hace falta y verifica el cambio en el archivo original revisado. ## Datos que pasan entre piezas Los archivos siguientes son entregables de este caso preparados por el agente; no implican exportadores ni sincronización automática. Pasa de Obsidian Skills a Human Review la ruta absoluta de la copia Markdown y conserva la referencia de su nota original; aplica los comentarios enviados a esa misma copia. Registra la versión aceptada y comprueba sus wikilinks en Obsidian; si falta la ruta o hay cambios concurrentes, detén la escritura y resuelve la versión antes de continuar. ## Monta el flujo ### Paso 1 Instala Obsidian Skills y pide al agente proponer una edición de la copia respetando propiedades y enlaces existentes. ### Paso 2 Instala Human Review y abre el archivo con su comando de revisión. Marca correcciones y pulsa Send; pide al agente aplicarlas a la misma copia Markdown que abriste para revisión. ### Paso 3 Abre la nota en Obsidian, comprueba los enlaces y acepta la versión. Antes de la siguiente ronda, haz que el agente relea el archivo para incorporar cualquier cambio manual. ## Comprobación Comprueba que un comentario enviado modifica el archivo correcto y que un wikilink sigue apuntando a la nota esperada. ## Si algo falla Si aparecen dos versiones, compara sus cambios antes de sobrescribir. Si el agente no recoge Send, envíale un mensaje para reanudar la revisión. La configuración se consulta en las guías del hub enlazadas. Esta composición es una propuesta de WISD; no se ha ejecutado como prueba integral. ## Prompt para tu agente Piezas del flujo: [Obsidian Skills](/hub/obsidian-agent-skills) · [Human Review](/hub/human-review-skill). ```text Lee y sigue las instrucciones publicadas de las piezas: Obsidian Skills: /hub/obsidian-agent-skills/instrucciones.md; Human Review: /hub/human-review-skill/instrucciones.md. Completa los requisitos, configuración y comprobación de cada pieza antes de usarla; comprueba su uso desde el cliente o arnés elegido, no solo su presencia en disco. Si falta un campo entre <>, una fuente obligatoria, acceso o una operación documentada, detén la etapa dependiente, informa qué falta y pídemelo; usa una alternativa manual solo cuando esté descrita y comprobada. No inventes datos ni des por superada una comprobación pendiente. Trabaja sobre en . Usa Obsidian Skills para proponer un plan conservando propiedades y wikilinks. Abre el Markdown con Human Review, recoge mis comentarios y aplícalos a esa misma copia, conservando la nota original sin cambios. Relee antes de cada ronda para incorporar ediciones manuales. Comprueba enlaces y cambios, y entrega la ruta de la nota revisada sin sobrescribir versiones en conflicto. Pasa de Obsidian Skills a Human Review la ruta absoluta de la copia Markdown y conserva la referencia de su nota original; aplica los comentarios enviados a esa misma copia. Registra la versión aceptada y comprueba sus wikilinks en Obsidian; si falta la ruta o hay cambios concurrentes, detén la escritura y resuelve la versión antes de continuar. ```