From feature-workflow
Manually syncs .spec/ task files like spec.md, db.md, arch.md to corresponding Notion page blocks, updating content and status properties for feature/bug tasks. For mid-project reviews; use /plan-sync.
npx claudepluginhub mark22013333/crew --plugin feature-workflowThis skill uses the workspace's default tool permissions.
將 `.spec/{slug}/` 目錄的當前進度同步到 Notion。用於需要在結案前查看 Notion 頁面、或與團隊成員分享進度的場景。**不在常規流程中**,按需使用。
Sync tracking documents based on current conversation results. Updates subtask, progress, findings, task_plan, project CLAUDE.md. Use when finishing a task or reaching a milestone.
Transforms Notion spec pages into implementation plans and tasks with acceptance criteria, effort estimates, and progress tracking using Notion databases.
Mandates invoking relevant skills via tools before any response in coding sessions. Covers access, priorities, and adaptations for Claude Code, Copilot CLI, Gemini CLI.
Share bugs, ideas, or general feedback.
將 .spec/{slug}/ 目錄的當前進度同步到 Notion。用於需要在結案前查看 Notion 頁面、或與團隊成員分享進度的場景。不在常規流程中,按需使用。
依 references/config-resolver.md 的漸進式載入邏輯讀取設定。本 Skill 需要:
config.md(Notion IDs)projects/{repo-id}.md(專案對應)前置檢查:參照 bug-workflow plugin 的
references/prerequisites.md執行完整前置檢查(CLAUDE.md + 設定目錄 + 專案註冊)。
/plan-sync # 同步當前任務的所有文件
/plan-sync spec # 只同步 spec.md
/plan-sync db # 只同步 db.md + db.sql
/plan-sync arch # 只同步 arch.md
與 /plan 相同邏輯。讀取 .spec/{slug}/README.md 取得 type 和 notion_page_id。
若 notion_page_id 為空(例如 /plan-start 時 Notion 建立失敗):
/plan-start 步驟 5 相同的建立邏輯notion_page_id 和 notion_url掃描 .spec/{slug}/ 目錄,列出可同步的檔案:
可同步的文件:
✅ spec.md → 📐 技術規格
✅ db.md → 🗄️ 資料庫設計
❌ arch.md → 🏗️ 架構設計(不存在)
✅ review.md → 📋 程式碼審查
同步所有?[Y/n] 或輸入要同步的項目(如 spec db)
若使用者指定了子命令(如 /plan-sync spec),只同步指定項目。
4-1. Fetch 現有頁面(1 次 notion-fetch)
取得頁面現有內容,避免覆蓋其他區塊。
4-2. 更新內容(1 次 notion-update-page content)
將選定的本地文件內容寫入對應 Notion 區塊。
Feature 類型的對應:
| 本地檔案 | Notion 區塊 |
|---|---|
| spec.md | 📐 技術規格 |
| db.md | 🗄️ 資料庫設計 |
| arch.md | 🏗️ 架構設計 |
| files.md | 📁 程式碼清單 |
| review.md | 在「📝 開發日誌」前插入「📋 程式碼審查」 |
| log.md | 📝 開發日誌(附加) |
Bug 類型的對應:
| 本地檔案 | Notion 區塊 |
|---|---|
| investigation.md | 🔍 調查過程 |
| root-cause.md | 🧠 根因分析 |
| fix.md | ✅ 修復方案 |
| log.md | 📝 經驗教訓(附加) |
4-3. 更新 Properties(1 次 notion-update-page properties)
根據 README.md 的 status 更新:
| status | 開發階段 |
|---|---|
| 需求分析 | 需求分析 |
| 規格設計 | 規格設計 |
| DB 設計 | DB 設計 |
| 架構設計 | 架構設計 |
| 開發中 | 開發中 |
| 程式碼審查 | 程式碼審查 |
同步完成!
📊 Notion 頁面:{URL}
📄 已同步:spec.md, db.md
📊 Notion API 呼叫:{N} 次
提示:此為中途同步,結案時請使用 /plan-close 做完整同步。
plan-sync 只更新 Notion 任務頁面的內容和 Properties,知識庫同步是 plan-close 的工作。回傳結果中需明確提示「知識庫將在結案時同步」。README.md 的 type 欄位(feature / bug)判斷套用哪個模板。若 frontmatter 解析失敗讀不到 type,應詢問使用者而非預設。/plan 產出文件