name: mongo-atlas-backup-sync description: >- Backs up MongoDB Atlas MYMTW_CardInfo to local JSONL, restores from backup, syncs remote MongoDB to Atlas without duplicates, counts documents, and drops Atlas DB when confirmed. Use when the user mentions Atlas backup, MYMTW_CardInfo, mongo-sync, MongoDB restore, sync to Atlas, or count Atlas collections.
MongoDB Atlas 備份與同步（MYMTW_CardInfo）
專案內工具目錄：mongo-sync/（Node.js）。所有指令在 mongo-sync 目錄執行，並需 mongo-sync/.env（勿提交；已列於 mongo-sync/.gitignore）。
前置
cd mongo-sync && npm install- 複製
.env.example為.env，設定：ATLAS_URI：mongodb+srv://帳號:密碼@cluster/.../MYMTW_CardInfo（密碼含$須寫成%24）REMOTE_URI：僅在執行npm run sync時需要；若遠端需認證，格式為mongodb://帳號:密碼@主機:27017/MYMTW_CardInfo
指令對照
| 目的 | 指令 |
|---|---|
備份 Atlas 到本機 backup/<DB>_<時間>/ | npm run backup |
| 還原備份到 Atlas（upsert） | node restore-from-backup.js ./backup/<資料夾> [--dry-run] |
| 遠端 → Atlas 增量同步 | npm run sync |
| 統計各 collection 筆數 | npm run count |
| 刪除 Atlas 整個 database | node drop-atlas-data.js --confirm（危險） |
行為要點
- 備份：每 collection 一個
.jsonl（EJSON 每行一筆），含_backup_meta.json。 - 同步：進度寫在 Atlas 的
_sync_meta；無updatedAt時用_id時間；若 lastSync 落在未來會改存為現在（見sync-to-atlas.js）。 - 還原：會寫入
.env的ATLAS_URI所指的 DB；還原前務必--dry-run確認路徑。
詳細說明
完整步驟與環境變數見 mongo-sync/README.md。
Agent 注意
- 不要將真實密碼寫入 repo；僅使用
.env或使用者本機環境變數。 - 執行
drop或大量restore前應確認使用者意圖。 - Windows 路徑在說明給使用者時可用反斜線；本 skill 內路徑以專案相對路徑
mongo-sync/為準。