alfredzhang98/research-obsidian-skill

ai-wiki — archivar contenido en la base de conocimiento (ligero, por defecto)

Convierte un "escribe esto" en una nota correctamente nombrada y enlazada dentro de la carpeta gestionada por IA.

Este comando no crea temas. Produce una sola nota y requiere al menos un [[wikilink]] a una nota existente. Para colocar una nota bajo un centro temático con enlaces recíprocos, usa /ai-wiki-full.

Por qué los temas están desactivados por defecto: cuando cada artículo tiene su propio centro, el centro no organiza nada — solo le da al artículo un nombre más largo. Un tema es una dirección de investigación, no el tema de un artículo. La prueba está en references/note-specs.md bajo "Qué califica como tema".

Dónde va la salida

Todo lo que esta skill archiva termina en la carpeta gestionada por IA.

Zona	Cómo tratarla
Carpeta gestionada por IA (<AI_WIKI>/**)	crear / editar / mover / renombrar / eliminar — libertad total
Las propias carpetas de notas del usuario	leer y buscar libremente; ediciones aditivas bien; preguntar antes de eliminar, renombrar, mover o sobrescribir
.claude/rules/, CLAUDE.md	configuración estática — editar solo cuando el usuario pida cambiar el comportamiento de Claude; actualizar updated:. La única excepción dinámica es .claude/rules/active.md
.obsidian/, .trash/	accesible pero no tocar — editar la configuración de Obsidian puede romper la bóveda

Nada está bloqueado en la capa de permisos, por lo que la restricción anterior es criterio. Una bóveda generalmente no es un repositorio git; una sobrescritura incorrecta de una nota escrita a mano solo se puede recuperar del historial de versiones de sincronización de archivos.

Leer desde esas zonas y archivar un resumen en la carpeta gestionada por IA es exactamente para lo que sirve esta skill.

Archivos de referencia — lee el que necesites, no los cuatro

Archivo	Léelo cuando
references/vault-guide.md	decidas qué carpeta — tabla de enrutamiento, frases de ejemplo del usuario, el modelo de etiquetas/wikilinks
references/note-specs.md	escribas una nota de artículo, nota de aprendizaje o plan de tema — nombres de archivo, frontmatter, especificaciones de secciones, reglas de redacción
references/figures-diagrams.md	la nota necesite figuras — comando de extracción, formato de incrustación, reglas de mermaid
references/tools.md	elijas qué skill o CLI maneja la entrada, además de los flujos de trabajo completos

El archivado rutinario (una carpeta obvia, sin figuras) no necesita ninguno de ellos — el procedimiento a continuación es suficiente.

Procedimiento

1. Clasificar — elige exactamente una carpeta de destino de la tabla de enrutamiento en references/vault-guide.md. Un contenido, una carpeta; cualquier cosa transversal se maneja con tags: y [[wikilinks]], nunca una copia duplicada.
   • Los impactos no confirmados, exploratorios o por lotes van a Inbox/, no a una carpeta real.
   • Verdaderamente ambiguo entre dos carpetas: pregunta, no adivines ni dupliques.
2. Nombrar — según references/note-specs.md (minúsculas con guiones):
   • artículo → Research/papers/<apellido-primer-autor>-<año>-<slug-de-2-3-palabras-clave>.md (este comando no crea tema, por lo que la nota va a la raíz de papers/; /ai-wiki-full la coloca en papers/<slug-del-tema>/)
   • aprendizaje → Research/learning/<slug-del-tema>-<AAAAMMDD>.md
3. Verificar primero si existe una nota — Glob a la carpeta de destino antes de escribir (para artículos usa Research/papers/**/*.md; nota las subcarpetas por tema). Actualizar la nota correcta es mejor que crear una casi duplicada; si ya existe una, combínala y dilo.
4. Rellenar — Lee el esqueleto correspondiente en Templates/ (paper-note.md / learning-note.md) y rellénalo en el lugar; nunca reconstruyas la estructura de memoria. La guía de secciones está en references/note-specs.md, no en los prompts {{...}} del esqueleto.
   • Los bloques > [!callout] son el sistema de énfasis — mantenlos, no añadas nuevos tipos.
   • La tarjeta rápida en la parte superior se escribe al final: comprime la nota terminada. Si sus seis líneas no se pueden rellenar, la nota de abajo no está completa.
   • S0 "Qué hace este artículo, en lenguaje sencillo" es obligatorio: 3-5 frases para alguien que conoce los conceptos básicos del campo pero no ha leído este artículo. Orden: la situación que enfrentan, lo que construyeron, por qué funciona, lo que obtuvieron. Si no puedes escribir esta sección, no has entendido el artículo — detente y relee en lugar de continuar.
   • Una nota de artículo responde, en orden: S0 lenguaje sencillo → S1 antecedentes → S2 qué no podía hacer el trabajo previo → S3-S4 método y matemáticas → S5 lo que se ejecutó → S6 lo que se obtuvo → S7 limitaciones y trabajo futuro de los autores → S8 mi análisis y oportunidades de investigación.
   • S2 y S8 son la razón de ser de la nota — ninguna puede rellenarse con prosa genérica. Las matemáticas de S4 deben ser reconstruibles a partir de la nota, no solo reconocibles.
   • Cada oportunidad de S8 lleva las cuatro líneas (oportunidad → por qué aún no resuelta → primer experimento → bajo qué tema se archiva). "Ninguna oportunidad que valga la pena — <por qué>" es válido; una inventada no.
   • Redacción profesional: sin etiquetas metafóricas ("el corte de este artículo", "el veredicto", "el número más fuerte"). Consulta la tabla de redacción en references/note-specs.md. Cada juicio debe basarse en evidencia específica.
   • Lee el artículo antes de escribir. Nunca rellenes una sección desde el resumen; si el texto PDF de una sección no está disponible, escribe {{no disponible en la fuente}} en lugar de relleno plausible.
5. Figuras — según references/figures-diagrams.md: figuras de artículo a través de la skill paper-figures en _attachments/paper-figures/<slug-del-artículo>/ (el árbol de archivos adjuntos permanece plano, nunca duplicado en carpetas de tema), incrustadas en la sección donde cada figura hace el trabajo.
   • El prefijo de incrustación depende de la profundidad de la nota: ../../_attachments/... en la raíz de papers/, ../../../_attachments/... dentro de papers/<slug-del-tema>/. Esto es lo único que falla silenciosamente cuando una nota se mueve — verifica una imagen.
   • Los diagramas creados usan un bloque de código mermaid. El arte ASCII está prohibido.
6. Enlazar (obligatorio, al menos uno) — la nota debe llevar al menos un [[wikilink]] a una nota existente: un centro en Research/topics/, otra nota de artículo, o una nota de aprendizaje.
   • Glob primero Research/topics/ y Research/papers/, elige el objetivo más cercano y expresa la relación en una oración en lugar de colocar un enlace suelto.
   • Este comando no crea temas. Si realmente no hay nada a lo que enlazar, márcalo en .claude/rules/active.md indicando que esto abre una nueva área e informa al usuario que /ai-wiki-full es el comando que construye un centro.
   • Cuando la nota encaja en un tema existente, añade el enlace directo a la lista S6 de ese tema — los enlaces recíprocos son lo que hace que el grafo se agrupe.
7. Registrar — si esto abre una nueva dirección o es trabajo en curso, añade una línea de referencia a .claude/rules/active.md y actualiza su updated:. No dupliques el estado allí. active.md es el único archivo de reglas que este flujo de trabajo toca sin una solicitud explícita de cambiar la configuración.

Autoverificación antes de terminar

• Cada ruta escrita está dentro de la carpeta gestionada por IA
• El nombre del archivo coincide con la especificación para su tipo de nota; una nota de artículo está en la raíz de papers/ (este comando no crea tema)
• El prefijo de incrustación coincide con la profundidad de la nota, y al menos una imagen fue verificada
• Frontmatter completo (tags: presente y específico, no solo research/)
• Al menos un [[wikilink]] a una nota existente, con la relación indicada
• Construido desde el archivo de plantilla real, el orden de las secciones y los callouts intactos
• Resumen S0 en lenguaje sencillo completado, sin jerga técnica
• Tarjeta rápida escrita al final; las seis líneas son declaraciones concretas y se sostiene por sí sola
• Sin {{placeholder}} dejado en la nota entregada
• Sin etiquetas metafóricas
• Figuras incrustadas en línea, no al final
• Nota de artículo: S2 nombra métodos previos reales y su fallo específico; S7 separa declarado por el autor / mío / su trabajo futuro; la conclusión de S8 cita evidencia y cada oportunidad tiene las cuatro líneas
• Nota de aprendizaje: S1 es la pregunta del usuario textual; S5 tiene un ejemplo numérico real
• Se informó al usuario la(s) ruta(s) exacta(s) escrita(s)

Relacionado

Para crear o encontrar un centro temático con enlaces recíprocos, usa /ai-wiki-full. Elección de herramienta según el tipo de entrada: references/tools.md. Reglas de zona completas: .claude/rules/permissions.md.