Menu
手動中途同步 .spec/ 目錄當前進度到 Notion（含 deploy.sql），按需使用、不在常規流程、任務尚未結案。當使用者提到 /plan-sync、「中途同步 spec 進度」、「同步 spec 進度到 Notion」時觸發此 Skill。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
| name | plan-sync |
| description | 手動中途同步 .spec/ 目錄當前進度到 Notion（含 deploy.sql），按需使用、不在常規流程、任務尚未結案。當使用者提到 /plan-sync、「中途同步 spec 進度」、「同步 spec 進度到 Notion」時觸發此 Skill。 |
將 .spec/{slug}/ 目錄的當前進度同步到 Notion。用於需要在結案前查看 Notion 頁面、或與團隊成員分享進度的場景。不在常規流程中，按需使用。
同步範圍只有兩個檔：
plan.md（唯一文件）與deploy.sql（唯一 SQL 事實來源）。state.json是本地流程狀態，不同步 Notion（Notion 只鏡射一個「開發階段」字串）。
v1 舊任務：
.spec/{slug}/plan.md不存在 → 這是 v1 結構，依../../references/legacy-v1.md的相容模式執行，並在開頭提示一次。 過渡期限定，到期本段連同該檔一併刪除。
依 plugin 根目錄 references/config-resolver.md（相對 SKILL.md 為 ../../references/）的漸進式載入邏輯讀取設定。本 Skill 需要：
config.md（Notion IDs）projects/{repo-id}.md（專案對應）前置檢查：參照 plugin 根目錄
references/prerequisites.md（相對 SKILL.md 為../../references/）執行完整前置檢查（CLAUDE.md + 設定目錄 + 專案註冊）。
/plan-sync # 同步當前任務的 plan.md + deploy.sql
/plan-sync plan # 只同步 plan.md
/plan-sync sql # 只同步 deploy.sql
依 plugin 根目錄 references/plan-common.md（相對 SKILL.md 為 ../../references/）的「定位活躍任務」。
type 從 .spec/{slug}/plan.md 的 frontmatter 讀；Notion 頁面 ID 從 .spec/{slug}/state.json 的
notion.page_id 唯讀取得（crew-state.py list 的 JSON 不含此欄位，別去那裡找）。
若 notion.page_id 為空（例如 /plan-start 時 Notion 建立失敗）：
詢問使用者是否要補建 Notion 條目
若是，執行與 /plan-start 的「建立 Notion 條目」步驟相同的建立邏輯
建立後把頁面 ID 交給單一寫者寫回（🔴 不要手改 state.json）：
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/crew-state.py" set --slug {slug} --notion-page-id {page_id}
掃描 .spec/{slug}/ 目錄。可同步的只有兩個檔：
可同步的產物：
✅ plan.md → 📋 需求描述 ＋ 📐 技術規格 ＋ 📝 開發日誌
✅ deploy.sql → 🗄️ 資料庫設計 → 遷移 SQL
同步所有？[Y/n] 或輸入要同步的項目（plan / sql）
deploy.sql 不存在（DB_REQUIRED=false）→ 該列顯示 ❌ 並跳過，不是錯誤。
若使用者指定了子命令（如 /plan-sync plan），只同步指定項目。
4-1. Fetch 現有頁面（1 次 notion-fetch）
取得頁面現有內容，避免覆蓋其他區塊。
4-2. 更新內容（1 次 notion-update-page content）
將選定的產物寫入對應 Notion 區塊（區塊標題以 plugin 根目錄 references/notion-page-template.md，相對 SKILL.md 為 ../../references/，的 8 區塊模板為準）：
| 本地來源 | Notion 區塊 |
|---|---|
plan.md「目標與範圍」＋「驗收條件」 | 📋 需求描述 |
plan.md「決策紀錄」＋「已知取捨與風險」＋「指路」 | 📐 技術規格 |
plan.md「檢查報告摘要」 | 📝 開發日誌 |
deploy.sql 全文 | 🗄️ 資料庫設計 → 遷移 SQL |
@code: / @sql: 錨點照原文寫入，🔴 不要把錨點指到的程式碼展開貼進 Notion。/plan-close 初始化）。4-3. 更新 Properties（1 次 notion-update-page properties）
「開發階段」屬性取自 .spec/{slug}/state.json 的 phase（唯讀；階段的唯一權威是 state.json，不是 plan.md）。
寫完後把鏡射結果記回狀態檔，讓下次同步知道 Notion 上目前顯示什麼：
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/crew-state.py" set \
--slug {slug} --mirrored-status "{寫進 Notion 的開發階段字串}" --synced-now
同步完成！
📊 Notion 頁面：{URL}
📄 已同步：plan.md（{已同步的章節}）、deploy.sql（{M} 個部署步驟）
📂 開發階段：{state.json 的 phase}
📊 Notion API 呼叫：{N} 次
提示：此為中途同步，結案時請使用 /plan-close 做完整同步。
sync 組——本 skill 是「未結案的中途同步」；結案批次同步用 /plan-close；單一 bug 頁更新用 /bug-update。
plan-sync 只更新 Notion 任務頁面的內容和 Properties，知識庫同步是 plan-close 的工作。回傳結果中需明確提示「知識庫將在結案時同步」。notion.page_id 為空時的模板選擇：補建 Notion 條目時，需從 plan.md frontmatter 的 type 欄位（feature / bug）判斷套用哪個模板。若 frontmatter 解析失敗讀不到 type，應詢問使用者而非預設。/plan-sync 會被本地覆蓋。plan.md 才是事實來源，要改內容請改 plan.md（用 Edit 對錨點，不整檔改寫）。/plan-close 也把 plan.md ＋ deploy.sql 同步到同一組 Notion 區塊。改本節的對應表時要同步確認 plan-close 的版本，否則同一份 plan.md 會在中途同步與結案同步落到不同區塊。notion.page_id 為空：引導補建 Notion 條目/plan 產出規劃內容state.json 缺失或壞掉：跑 crew-state.py rebuild --slug {slug}，並在回報中標「狀態為推測」Basé sur la classification professionnelle SOC
CREW 環境健診 —— 一次性檢查 CREW 所有必要與選配依賴（Node/Git/Notion MCP/Agent Teams/瀏覽器 MCP/config/專案註冊/CLAUDE.md），列出綠黃紅燈與修法。當使用者提到 /crew-doctor、「CREW 環境健診」、「CREW 為什麼不能用」時觸發此 Skill。
瀏覽與探索已有的 .spec/ 規劃文件 —— 深度閱讀、跨任務比較、模式搜尋。當使用者提到 /plan-browse、「瀏覽 .spec 規劃」、「看之前的規劃設計」時觸發此 Skill。
從 .spec/{slug}/plan.md 以 Agent Teams leader-delegate 模式產生程式碼，含退出驗證與錨點有效性檢查，Leader 只協調不寫 code。當使用者提到 /plan-build、「從 spec 產生程式碼」、「plan-build 產碼」時觸發此 Skill。
結案前先跑文件漂移硬關卡（FAIL 擋、WARN 需明示放行），通過後蓋章 verified_at_commit、提交 Git、批次同步 plan.md 與 deploy.sql 到 Notion。當使用者提到 /plan-close、「feature 結案」、「同步 spec 到 Notion 並結案」時觸發此 Skill。
智慧推薦 CREW 當前任務下一步 —— 呼叫 crew-state.py 讀 state.json 算出下一個 /plan-* 指令並轉成人話。當使用者提到 /plan-next、「CREW 下一步指令」、「這個 spec 接下來做什麼」時觸發此 Skill。
CREW 規劃 —— spec / db / arch 三個 pass 把決策與驗收條件寫進 .spec/{slug}/plan.md，DB 設計另產 deploy.sql（零 Notion 呼叫）。當使用者提到 /plan、「CREW 完整規劃」、「一次跑完 spec/db/arch」時觸發此 Skill。
