القائمة
手動中途同步 .spec/ 目錄當前進度到 Notion（含 deploy.sql），按需使用、不在常規流程、任務尚未結案。當使用者提到 /plan-sync、「中途同步 spec 進度」、「同步 spec 進度到 Notion」時觸發此 Skill。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف 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。
| 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}，並在回報中標「狀態為推測」