doc-sync-tool
AI 에이전트 문서 자동 동기화
여러 AI 에이전트를 위한 동일한 구성 파일을 유지하는 것은 번거롭고 오류가 발생하기 쉽습니다. 이 도구는 실시간 파일 감시 또는 수동 트리거를 통해 전체 프로젝트에서 AGENTS.md, CLAUDE.md, GEMINI.md 파일을 자동으로 동기화합니다.
스킬 ZIP 다운로드
Claude에서 업로드
설정 → 기능 → 스킬 → 스킬 업로드로 이동
토글을 켜고 사용 시작
테스트해 보기
"doc-sync-tool" 사용 중입니다. 기존 CLAUDE.md 파일이 하나 있는 프로젝트에서 수동 동기화 실행
예상 결과:
- 🚀 문서 스캔 시작...
- 📂 스캔 경로：/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.23 초
"doc-sync-tool" 사용 중입니다. 파일 감시기가 CLAUDE.md 변경 감지
예상 결과:
- [10:35:20] 📝 파일 변경 감지：/path/to/CLAUDE.md
- 📁 디렉터리 처리：/path/to
- 📄 소스 파일：CLAUDE.md
- ✅ 업데이트：AGENTS.md
- 🎉 1 개 파일 성공적으로 동기화됨
보안 감사
낮은 위험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.
낮은 위험 문제 (1)
위험 요인
📁 파일 시스템 액세스 (5)
품질 점수
만들 수 있는 것
새 프로젝트 설정
새 프로젝트를 시작할 때 단일 에이전트 구성 파일 (예: CLAUDE.md) 을 생성하면 도구가 AGENTS.md 와 GEMINI.md 파일을 동일한 콘텐츠로 자동 생성합니다.
지속적인 문서 동기화
개발 중 감시 모드로 도구를 실행하여 모든 에이전트 구성 변경 사항을 다른 에이전트 파일에 실시간으로 전파합니다.
일괄 동기화
여러 프로젝트 디렉터리에서 수동 동기화를 실행하여 주요 업데이트 후 모든 에이전트 문서가 일관되게 유지되도록 합니다.
이 프롬프트를 사용해 보세요
내 프로젝트에 자동 문서 동기화를 설정합니다. CLAUDE.md 파일이 있고 일치하는 AGENTS.md 와 GEMINI.md 파일을 생성해야 합니다.
doc-sync-tool 을 실행하여 현재 프로젝트 디렉터리에서 모든 에이전트 문서 파일을 동기화하고 업데이트된 파일을 표시합니다.
PM2 를 사용하여 백그라운드 모드에서 파일 감시기를 시작하여 에이전트 문서가 자동으로 동기화되도록 합니다. 실행 중인지 확인하는 방법을 표시합니다.
doc-sync-tool 구성을 수정하여 추가 디렉터리를 제외하고 대상 파일 이름을 프로젝트 규칙과 일치하도록 변경하는 데 도움이 필요합니다.
모범 사례
- 적극적인 개발 중 감시 모드로 도구를 실행하여 모든 에이전트 문서를 실시간으로 동기화
- 프로덕션 환경에서 PM2 를 사용하여 시스템 재시작 후에도 파일 감시기가 지속되도록 보장
- 완전한 백업 및 기록 추적을 위해 세 가지 문서 파일을 모두 버전 관리에 커밋
피하기
- 동기화 도구가 전파를 처리하도록 해야 하므로 여러 에이전트 파일을 동시에 수동으로 편집하지 않음
- 경쟁 상태를 방지하기 위해 동일 디렉터리에서 여러 동기화 인스턴스 실행 금지
- 동기화하려는 실제 에이전트 문서가 포함된 디렉터리를 제외하지 않음