📦

doc-sync-tool

Name: doc-sync-tool
Author: ZhanlinCui

Riesgo bajo 📁 Acceso al sistema de archivos⚙️ Comandos externos

Sincronice Automáticamente la Documentación del Agente de IA

Mantener archivos de configuración idénticos para múltiples agentes de IA es tedioso y propenso a errores. Esta herramienta mantiene automáticamente los archivos AGENTS.md, CLAUDE.md y GEMINI.md sincronizados en todo su proyecto con monitoreo de archivos en tiempo real o activación manual.

Soporta: Claude Codex Code(CC)

📊 71 Adecuado

Descargar el ZIP de la skill

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

Activa y empieza a usar

Pruébalo

Usando "doc-sync-tool". Ejecutar sincronización manual en un proyecto con un archivo CLAUDE.md existente

Resultado esperado:

🚀 Iniciando escaneo de documentos...
📂 Escaneando ruta: /path/to/project
📋 Archivos objetivo: AGENTS.md, CLAUDE.md, GEMINI.md
✓ Se encontró 1 directorio con archivos objetivo
📁 Procesando directorio: /path/to/project
📄 Archivo fuente: CLAUDE.md (2025-11-27 10:30:45)
✨ Creando: AGENTS.md
✨ Creando: GEMINI.md
🎉 Sincronización exitosa de 2 archivos
✅ ¡Sincronización completada! Directorios procesados: 1, archivos actualizados: 2, tiempo: 0.23s

Usando "doc-sync-tool". El monitor de archivos detecta un cambio en CLAUDE.md

Resultado esperado:

[10:35:20] 📝 Cambio de archivo detectado: /path/to/CLAUDE.md
📁 Procesando directorio: /path/to
📄 Archivo fuente: CLAUDE.md
✅ Actualizando: AGENTS.md
🎉 Sincronización exitosa de 1 archivo

Auditoría de seguridad

Riesgo bajo

v1 • 2/24/2026

Static analysis flagged 254 external_commands patterns and 31 filesystem operations, but evaluation confirms these are false positives. The 'Ruby/shell backtick execution' findings are markdown documentation examples in EXAMPLES.md, INDEX.md, README.md, QUICKSTART.md, and SKILL.md - not executable code. The 'hex-encoded characters' and 'weak cryptographic algorithm' findings are ANSI terminal color codes (e.g., \x1b[32m for green). The tool performs legitimate file synchronization using Node.js fs module with proper path handling via path.join() and path.dirname(). One minor concern: rename-quick.js uses child_process.execSync with hardcoded 'find' commands, which is acceptable but should be noted.

Archivos escaneados

1,754

Líneas analizadas

hallazgos

Auditorías totales

Problemas de riesgo bajo (1)

rename-quick.js:14 rename-quick.js:33

Shell Command Execution in Helper Script

The rename-quick.js helper script uses child_process.execSync to run 'find' commands for file discovery. While the arguments are hardcoded and not user-controllable, this represents a minor security consideration for a helper utility.

Factores de riesgo

📁 Acceso al sistema de archivos (5)

sync.js:31 sync.js:79-101 watch.js:63 rename-quick.js:24 rename-quick.js:43

⚙️ Comandos externos (5)

rename-quick.js:14 rename-quick.js:33 run-sync.sh:6 run-watch.sh:6 test.sh:8-9

Auditado por: claude

Puntuación de calidad

Arquitectura

100

Mantenibilidad

Contenido

Comunidad

Seguridad

Cumplimiento de la especificación

Lo que puedes crear

Configuración de Nuevo Proyecto

Al comenzar un nuevo proyecto, cree solo un archivo de configuración de agente (p. ej., CLAUDE.md) y deje que la herramienta genere automáticamente AGENTS.md y GEMINI.md con contenido idéntico.

Sincronización Continua de Documentación

Ejecute la herramienta en modo de monitoreo durante el desarrollo para propagar automáticamente cualquier cambio de configuración del agente a todos los demás archivos de agente en tiempo real.

Sincronización Masiva

Ejecute sincronización manual en múltiples directorios de proyecto a la vez para asegurar que toda la documentación del agente permanezca consistente después de actualizaciones importantes.

Prueba estos prompts

Configuración Básica

Configure sincronización automática de documentación para mi proyecto. Tengo un archivo CLAUDE.md y necesito crear archivos coincidentes AGENTS.md y GEMINI.md.

Ejecución de Sincronización Manual

Ejecute doc-sync-tool para sincronizar todos los archivos de documentación del agente en el directorio actual del proyecto y muéstreme qué archivos fueron actualizados.

Monitoreo en Segundo Plano

Inicie el monitor de archivos en modo segundo plano usando PM2 para que mis documentos del agente permanezcan sincronizados automáticamente. Muéstreme cómo verificar que está funcionando.

Personalización de Configuración

Ayúdeme a modificar la configuración de doc-sync-tool para excluir directorios adicionales y cambiar los nombres de archivos objetivo para que coincidan con las convenciones de mi proyecto.

Mejores prácticas

Ejecute la herramienta en modo de monitoreo durante el desarrollo activo para mantener todos los documentos del agente sincronizados en tiempo real
Use PM2 para entornos de producción para asegurar que el monitor de archivos sobreviva a reinicios del sistema
Confirme los tres archivos de documentación al control de versiones para respaldo completo y seguimiento del historial

Evitar

No edite manualmente múltiples archivos de agente simultáneamente - deje que la herramienta de sincronización maneje la propagación
Evite ejecutar múltiples instancias de sincronización en el mismo directorio para prevenir condiciones de carrera
No excluya directorios que realmente contengan documentación del agente que desea sincronizar

Preguntas frecuentes

¿Qué archivos sincroniza esta herramienta?

La herramienta sincroniza tres archivos: AGENTS.md (o Agents.md), CLAUDE.md (o claude.md), y GEMINI.md (o gemini.md). Coincide archivos sin distinguir mayúsculas/minúsculas dentro del mismo directorio.

¿Cómo decide la herramienta qué archivo es la fuente?

La herramienta usa el tiempo de modificación (mtime) para determinar la fuente. El archivo modificado más recientemente se convierte en la fuente, y su contenido se copia a los otros archivos.

¿Puedo personalizar qué archivos se sincronizan?

Sí. Edite el arreglo targetFiles en sync.js para cambiar qué nombres de archivo se sincronizan. El predeterminado es ['AGENTS.md', 'CLAUDE.md', 'GEMINI.md'].

¿El modo de monitoreo consume muchos recursos del sistema?

No. El modo de monitoreo usa el monitoreo recursivo nativo fs.watch de Node.js. Consume menos de 50MB de memoria y CPU casi cero cuando está inactivo.

¿Cómo detengo el monitor de archivos?

Presione Ctrl+C en la terminal para detener. Si está ejecutando vía PM2, use 'pm2 stop doc-sync' o 'pm2 delete doc-sync' para detener y eliminar el servicio.

¿Qué sucede si dos archivos se modifican al mismo tiempo?

La herramienta incluye debounce para manejar cambios rápidos. Usará whichever archivo tenga la marca de tiempo de modificación más reciente después de que se complete el período de debounce.