ドキュメント同期ツール (Doc Sync Tool)

機能説明

このツールは、プロジェクト内の AI Agent 設定ドキュメントを自動的に同期し、Agents.md、claude.md、gemini.md の3つのファイルの内容が常に一致するようにします。

コア機能

1. 自動検出: 現在のディレクトリ内のすべてのフォルダを再帰的にスキャンし、これら3つのドキュメントを検索します。
2. スマート同期: いずれかのドキュメントが検出された場合、自動的に残りの2つを作成/更新します。
3. ファイル監視: ファイルの変更をリアルタイムで監視し、最新の内容を自動的に同期します。
4. 手動トリガー: コマンドラインからの手動同期実行をサポートしています。

使用シナリオ

• 複数の AI Agent 間で同じプロジェクト設定を共有する場合。
• 異なる AI の作業指示を自動的に一貫させる場合。
• 複数の同じドキュメントを手動で管理する手間を省く場合。

使用方法

依存関係のインストール

cd /Users/ben/Downloads/go\ to\ wild/auto-website-system/_skills/doc-sync-tool
pnpm install

手動同期（単回実行）

# プロジェクトのルートディレクトリで実行
node /Users/ben/Downloads/go\ to\ wild/auto-website-system/_skills/doc-sync-tool/sync.js

# または npm script を使用
pnpm run sync

自動監視（継続実行）

# ファイル監視サービスを起動
node /Users/ben/Downloads/go\ to\ wild/auto-website-system/_skills/doc-sync-tool/watch.js

# または npm script を使用
pnpm run watch

バックグラウンド実行（推奨）

# PM2 を使用してバックグラウンドで実行
pm2 start /Users/ben/Downloads/go\ to\ wild/auto-website-system/_skills/doc-sync-tool/watch.js --name doc-sync

# ステータスを確認
pm2 status

# サービスを停止
pm2 stop doc-sync

動作原理

1. スキャンフェーズ: 指定されたディレクトリを再帰的に走査し、Agents.md、claude.md、gemini.md ファイルを検索します。
2. グループ化フェーズ: 同じフォルダ内のこれら3つのファイルを1つのグループとしてまとめます。
3. 同期フェーズ:
   • あるグループに1つのファイルしかない場合、その内容をコピーして残りの2つを作成します。
   • あるグループに複数のファイルがある場合、最新に更新されたファイルをソースとして選択し、他のファイルに同期します。
4. 監視フェーズ (watch モード): ファイルの変更を継続的に監視し、同期をトリガーします。

設定オプション

sync.js で以下の設定を変更できます。

const CONFIG = {
  targetFiles: ['Agents.md', 'claude.md', 'gemini.md'],  // ターゲットファイルリスト
  scanPath: process.cwd(),                                // スキャンパス（デフォルトは現在のディレクトリ）
  excludeDirs: ['node_modules', '.git', '.next', 'dist'] // 除外ディレクトリ
};

注意事項

• ツールは node_modules、.git、.next、dist などのディレクトリを自動的にスキップします。
• 同期時には、ファイルの元の形式と内容が保持されます。
• ファイル変更の追跡に便利なため、Git リポジトリでの使用を推奨します。
• 監視モードは継続的に実行されるため、PM2 を使用してプロセスを管理することをお勧めします。

トラブルシューティング

権限の問題

chmod +x sync.js watch.js

Node.js バージョン要件

Node.js 14+ バージョンが必要です。

依存関係のインストール失敗

rm -rf node_modules package-lock.json
pnpm install