Habilidad de Actualización de Wiki
Actualiza las secciones de prosa escritas a mano de las páginas wiki para reflejar el estado actual de la base de código. Los bloques de métricas/datos generados son gestionados por el orquestador y nunca deben ser tocados.
Cuándo Invocar
- El usuario escribe
/update-wiki— actualiza todas las páginas con prosa - El usuario escribe
/update-wiki Architecture— actualiza solowiki/Architecture.md - El usuario dice "refrescar prosa de wiki", "actualizar narrativa de onboarding", "reescribir documentos de arquitectura"
- Después de una refactorización significativa que cambie la narrativa del diseño del sistema
Qué Hace Esta Habilidad (Paso a Paso)
-
Determinar el alcance. Si se proporcionó un argumento con el nombre de la página (ej.
Architecture), resuélvelo awiki/{PageName}.md. De lo contrario, encola todas las páginas con prosa listadas a continuación. -
Para cada página objetivo: a. Lee el archivo de la página wiki. b. Identifica cada bloque
<!-- claude:prose -->...<!-- claude:prose:end -->. c. Lee los archivos fuente relevantes listados en el registro de páginas a continuación para construir contexto. d. Reescribe el contenido entre los marcadores para que refleje con precisión la base de código actual — mantén la misma estructura general (títulos, orden de párrafos) a menos que sea factualmente incorrecta. e. Escribe el contenido actualizado de vuelta al archivo, preservando exactamente los marcadores. -
Nunca tocar bloques generados. Cualquier contenido dentro de
<!-- generated:start -->...<!-- generated:end -->debe dejarse byte por byte idéntico. Estos bloques son mantenidos por el script orquestador de la wiki. -
El Registro de Decisiones de Arquitectura es totalmente propiedad de Claude.
wiki/Architecture-Decision-Log.mdno tiene bloquesgeneratedni marcadoresclaude:prose. Claude mantiene el archivo completo. Al actualizar, añade nuevas entradas ADL para cualquier decisión arquitectónica tomada desde la última entrada registrada. No modifiques las entradas existentes. -
Indicación de commit. Después de que todas las páginas estén actualizadas, recuerda al usuario:
"Prosa de wiki actualizada. Ejecuta
/commitpara guardar los cambios y luego haz push al remoto de la wiki."
Páginas con Prosa y Sus Archivos Fuente
wiki/Architecture.md
Propósito del bloque de prosa: Narrativa del diseño del sistema — explica las responsabilidades de los módulos, el flujo de datos y cómo encajan el sitio estático y el agente de chat Lambda.
Archivos fuente relevantes a leer:
WebContent/js/main.jsWebContent/js/filter.jsWebContent/js/carousel.jsWebContent/js/utils.jslambda/lambda_function.pyindex.html(para contexto de estructura de página)projects.html(para contexto de estructura de página)
wiki/Lambda-Chat-Agent.md
Propósito del bloque de prosa: Justificación del diseño del agente — explica la arquitectura Lambda, carga de la base de conocimiento, construcción de prompts y manejo de respuestas.
Archivos fuente relevantes a leer:
lambda/lambda_function.pylambda/context/(todos los archivos.mdsi existen)
wiki/Contributing.md
Propósito del bloque de prosa: Narrativa de incorporación — explica el flujo de trabajo de desarrollo, la filosofía de pruebas y las convenciones del proyecto para nuevos contribuyentes.
Archivos fuente relevantes a leer:
CLAUDE.mdMakefilepackage.jsonpyproject.toml.github/workflows/ci-cd.yml
wiki/Architecture-Decision-Log.md
Manejo especial: Sin marcadores claude:prose. Claude es propietario de todo el archivo. Añade nuevas entradas ADL; nunca modifiques las existentes.
Archivos fuente relevantes a leer:
- Revisar el registro de git reciente para cambios arquitectónicos significativos
CLAUDE.mdpara decisiones actuales sobre herramientaslambda/lambda_function.pypara decisiones de backend
Reglas de Preservación de Marcadores
<!-- claude:prose -->
[Claude reescribe este contenido]
<!-- claude:prose:end -->
<!-- generated:start -->
[NUNCA TOCAR — datos gestionados por el orquestador]
<!-- generated:end -->
- Los marcadores de apertura y cierre deben aparecer en sus propias líneas, sin cambios.
- No añadas líneas en blanco adicionales inmediatamente dentro de los marcadores.
- No anides marcadores.
Advertencia
NUNCA modifiques los bloques <!-- generated:start --> ... <!-- generated:end -->.
Estos bloques contienen métricas y tablas generadas automáticamente por el orquestador de la wiki. Modificarlos provocará que la próxima ejecución del orquestador produzca un conflicto de fusión o sobrescriba silenciosamente tus cambios.