dhpk-cross-agent-synclisted

# Multi AI Sync (Claude First) 以 `Claude` 為 source of truth，對齊 `Codex`、`Antigravity (.agent)`、AGY native plugin 與 `Cursor`。 ## When NOT to Use - 反向同步，或以單一 target 覆寫 Claude。 - 單一平台內的檔案編輯或格式調整。 - 只修改一個 command/skill，而不是檢查跨平台對齊。 - `.claude` 或 `CLAUDE.md` 不存在、不可讀，或結構不完整。 - 只需檢查或修剪單一 harness（用 `dhpk-claude-health` 或 `dhpk-harness-revise`）。 ## Operating Contract 1. 把 Claude source 的每個 feature 放入 mapping matrix。 2. 無穩定等價能力使用 `skip-incompatible`，不可硬套。 3. 近似能力使用 `adapted`，保留 evidence 與人工審核界線。 4. 先產生 read-only plan；核准前不得建立 tasks 或 mutation。 5. apply 前必須 dry-run；完成後必須跑 validation gate。 6. Codex agent parity 使用 canonical `agent_sync.py` / `apply_sync.py` helpers 產生 reviewer-ready TOML 草稿、mirror Markdown、mirrored references 與 sync manifest；這些 artifact 仍受 dry-run/apply/validation safety gates 管制。 每個 mapping 必須有 `status`、`reason`、`evidence_urls`、`source_path`、 `target_path`。Status semantics 與 risk policy 見 References。 ## Workflow ### Step 0: Resolve runtime and preflight Resolve each configured harness directory with `@skills/dhpk-harness-revise/references/harness-directory-contract.md` before selecting source or target roots. 先讀 `references/runtime-entrypoints.md`，依 harness 設定 `SYNC_CLI`； entrypoint script 是 `multi_ai_sync.py`。若 working directory 不是 repository root，所有 subcommand 前加 `--root <repo-root>`。 檢查並回報：source 可讀；plan-only 的缺少 target root 可標記 `WARN`；apply 必須有可寫 target 或明確 fallback；無法安全判定的 target 標記 `BLOCKED`。 **完成條件：** 每項都有 `PASS`、`WARN` 或 `BLOCKED` 及 operation