doc-sync-tool
Sincronize Documentação de Agentes de IA Automaticamente
Manter arquivos de configuração idênticos para múltiplos agentes de IA é tedioso e propenso a erros. Esta ferramenta mantém automaticamente os arquivos AGENTS.md, CLAUDE.md e GEMINI.md sincronizados em todo o seu projeto com monitoramento de arquivos em tempo real ou acionamento manual.
Baixar o ZIP da skill
Upload no Claude
Vá em Configurações → Capacidades → Skills → Upload skill
Ative e comece a usar
Testar
A utilizar "doc-sync-tool". Executar sincronização manual em um projeto com um arquivo CLAUDE.md existente
Resultado esperado:
- 🚀 开始扫描文档...
- 📂 扫描路径：/path/to/project
- 📋 目标文件：AGENTS.md, CLAUDE.md, GEMINI.md
- ✓ 找到 1 个目录包含目标文件
- 📁 处理目录：/path/to/project
- 📄 源文件：CLAUDE.md (2025-11-27 10:30:45)
- ✨ 创建：AGENTS.md
- ✨ 创建：GEMINI.md
- 🎉 成功同步 2 个文件
- ✅ 同步完成！处理目录：1 个，更新文件：2 个，耗时：0.23s
A utilizar "doc-sync-tool". Monitor de arquivos detecta uma alteração no CLAUDE.md
Resultado esperado:
- [10:35:20] 📝 检测到文件变化：/path/to/CLAUDE.md
- 📁 处理目录：/path/to
- 📄 源文件：CLAUDE.md
- ✅ 更新：AGENTS.md
- 🎉 成功同步 1 个文件
Auditoria de Segurança
Baixo RiscoStatic 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.
Problemas de Baixo Risco (1)
Fatores de risco
📁 Acesso ao sistema de arquivos (5)
⚙️ Comandos externos (5)
Pontuação de qualidade
O Que Você Pode Construir
Configuração de Novo Projeto
Ao iniciar um novo projeto, crie apenas um arquivo de configuração de agente (por exemplo, CLAUDE.md) e deixe a ferramenta gerar automaticamente arquivos AGENTS.md e GEMINI.md com conteúdo idêntico.
Sincronização Contínua de Documentação
Execute a ferramenta no modo watch durante o desenvolvimento para propagar automaticamente quaisquer alterações de configuração de agente para todos os outros arquivos de agente em tempo real.
Sincronização em Massa
Execute sincronização manual em múltiplos diretórios de projeto de uma vez para garantir que toda a documentação de agente permaneça consistente após atualizações importantes.
Tente Estes Prompts
Configure sincronização automática de documentação para meu projeto. Tenho um arquivo CLAUDE.md e preciso criar arquivos correspondentes AGENTS.md e GEMINI.md.
Execute o doc-sync-tool para sincronizar todos os arquivos de documentação de agente no diretório atual do projeto e mostre quais arquivos foram atualizados.
Inicie o monitor de arquivos em modo segundo plano usando PM2 para que meus docs de agente permaneçam sincronizados automaticamente. Mostre como verificar se está em execução.
Ajude-me a modificar a configuração do doc-sync-tool para excluir diretórios adicionais e alterar os nomes dos arquivos de destino para corresponder às convenções do meu projeto.
Melhores Práticas
- Execute a ferramenta no modo watch durante desenvolvimento ativo para manter todos os docs de agente sincronizados em tempo real
- Use PM2 para ambientes de produção para garantir que o monitor de arquivos sobreviva a reinicializações do sistema
- Faça commit de todos os três arquivos de documentação no controle de versão para backup completo e rastreamento de histórico
Evitar
- Não edite manualmente múltiplos arquivos de agente simultaneamente - deixe a ferramenta de sincronização lidar com a propagação
- Evite executar múltiplas instâncias de sincronização no mesmo diretório para prevenir condições de corrida
- Não exclua diretórios que realmente contêm documentação de agente que você quer sincronizada