multi-ai-synclisted

# Multi AI Sync (Claude First) 以 `Claude` 為主來源，對齊到 `Codex`、`Gemini`、`Antigravity(.agent)`。 ## When NOT to Use - 反向同步（以 Codex/Gemini 為來源覆寫 Claude）→ 此技能僅支援 Claude-first - 單一平台內的檔案編輯或格式調整（不涉及跨平台對齊） - 只修改單個 command/skill 而非全局對齊 - `.claude` 主來源目錄不存在或結構不完整 ## 核心規則 1. `Claude` 有的功能項目都必須進入檢查矩陣。 2. 目標平台無對應能力：標記 `skip-incompatible`，不得硬套。 3. 目標平台有近似能力：依目標平台規範移植（優先 Context7，官方文件為最終裁決）。 4. 先出計畫供審核，核准後才生成與執行 tasks。 5. 最後必跑 `Post-Sync Validation Gate`（Smoke + 代表流程）。 ## 能力範圍 - `skills` - `commands/workflows` - `agents/config` - `hooks` - `multi-agents`（含 `agent-definitions`（`.claude/agents/`）與 `orchestration-rules`（`.claude/rules/`），需人工審核） ## 執行流程 ### Step 0: Preflight（必要） ```bash # 0-1. 確認主來源可讀（含 symlink） test -e .claude && test -e CLAUDE.md # 0-2. 檢查主要目標路徑可寫性（避免執行中途才失敗） test -w .gemini && test -w .agent # 0-3. Codex skills 路徑若不可寫，apply 會自動 fallback test -w .codex/skills || echo ".codex/skills not writable; will fallback" ``` 若 Preflight 失敗，先回報阻塞（原因/已嘗試/下一步），不要直接進 Step 1。 ### Step 1: 產生差異計畫（只讀） ```bash python3 -B .codex/skills/multi-ai-sync/scripts/multi_ai_sync.py plan --format markdown ``` 輸出會包含： - Coverage summary - Mapping matrix - Migration candidates (`adapted`) - Skip register (`skip-incompatible`) - 證據來源 URL 若要機器可讀格式： ```bash python3 -B .codex/skills/multi-ai-sync/scripts/multi_ai_sync.py plan --format json --output /tmp/multi-ai-sync-plan.json ``` ### Step 2: 審核後生成 OpenSpec tasks ```bash python3 -B .codex/skills/multi-ai-sync/scripts/multi_ai_sync.py openspec-ta