Menú
bug-workflow 首次設定引導 —— 自動偵測 Notion 資料庫、建立設定檔、設定專案對應。當使用者提到 /bug-setup、「設定 bug workflow」、「初始化 bug workflow」時觸發此 Skill。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional 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 | bug-setup |
| description | bug-workflow 首次設定引導 —— 自動偵測 Notion 資料庫、建立設定檔、設定專案對應。當使用者提到 /bug-setup、「設定 bug workflow」、「初始化 bug workflow」時觸發此 Skill。 |
互動式引導使用者完成 Bug Workflow Plugin 的初始設定，產出設定檔供其他 Skill 使用。
notion-search、notion-fetch 等工具）設定檔路徑規則：
~/.claude-company/bug-workflow-config.md~/.claude/bug-workflow-config.md~/.claude-company/ 目錄存在 → 使用 ~/.claude-company/bug-workflow-config.md~/.claude/bug-workflow-config.md使用 notion-search 搜尋 Workspace 中是否已有「CREW 工作區」頁面。
情境 A：找到現有工作區頁面
直接使用，記錄 workspace_page_id。
情境 B：未找到工作區頁面
詢問使用者一次：
請選擇 CREW 工作區的位置：
1. 建立在 Workspace 頂層（推薦）
2. 選擇現有頁面作為 parent
使用 notion-create-pages 建立「🚀 CREW 工作區」頁面（先建空頁面），icon 設為「🚀」，記錄 workspace_page_id。
此步驟讓使用者只需選擇一次位置，後續所有新建資料庫都自動放在此頁面下。
使用 notion-search 搜尋 Workspace 中包含「任務追蹤」的資料庫。
情境 A：找到現有資料庫
用 notion-fetch 取得該資料庫的 data-source URL（collection://...），擷取 Data Source ID。
驗證欄位是否齊全（任務名稱、狀態、任務類型、優先順序、環境、根因分類、修復分支、專案資料庫）：
notion-update-data-source）不移動既有資料庫，僅記錄 Data Source ID。
情境 B：找不到任務追蹤工具
詢問使用者：
未找到「任務追蹤工具」資料庫，請選擇：
1. 建立新的「任務追蹤工具」（推薦，含標準欄位 + 4 個看板 View）
2. 指定一個現有資料庫
3. 跳過（無法使用 Bug Workflow）
若選擇建立：
workspace_page_id，不再個別詢問位置）references/db-templates.md（相對 SKILL.md 為 ../../references/）「B. 任務追蹤工具」模版notion-create-database 建立（不含 Relation 欄位，Relation 在『補齊 Relation 欄位』一節統一補齊）notion-update-data-source 設定 is_inline: true（否則資料庫會以子頁面模式顯示）notion-create-view 依序建立 4 個 Views：所有任務（table）、依狀態（board）、我的任務（table）、核對清單（list）搜尋包含「bug」、「處理方式」的資料庫。
情境 A：找到現有資料庫
同樣擷取 Data Source ID 並驗證欄位。不移動既有資料庫。
情境 B：找不到 Bug 知識庫
詢問使用者：
未找到「Bug 知識庫」資料庫，請選擇：
1. 建立新的「Bug 知識庫」（推薦，含標準欄位）
2. 指定一個現有資料庫作為知識庫
3. 跳過知識庫（/bug-close 結案時不同步知識庫）
若選擇建立：
workspace_page_id，不再個別詢問位置）references/db-templates.md（相對 SKILL.md 為 ../../references/）「C. Bug 知識庫」模版notion-create-database 建立（不含 Relation 欄位）notion-update-data-source 設定 is_inline: true（否則資料庫會以子頁面模式顯示）使用 notion-search 搜尋包含「專案」的資料庫。
情境 A：找到現有資料庫
用 notion-fetch 取得資料庫結構，驗證並補齊欄位。
完整欄位清單、型態與 Select/Multi-Select 選項參照 plugin 根目錄 references/db-templates.md（相對 SKILL.md 為 ../../references/）「A. 專案資料庫」Schema（權威來源）。以此對照時的必要性分級：
notion-update-data-source）不移動既有資料庫。
情境 B：找不到專案資料庫
詢問使用者：
未找到專案資料庫，請選擇：
1. 建立新的「專案資料庫」（推薦，含標準欄位）
2. 指定一個現有資料庫
3. 跳過（無法自動關聯專案，需手動操作）
若選擇建立：
workspace_page_id，不再個別詢問位置）references/db-templates.md（相對 SKILL.md 為 ../../references/）「A. 專案資料庫」模版notion-create-database 建立資料庫，名稱為「專案資料庫」，包含該模版 Schema 所有欄位notion-update-data-source 設定 is_inline: true（否則資料庫會以子頁面模式顯示）notion-create-view 建立 2 個 Views：預設 Table View（Name 降序 + 狀態篩選）、List View若本次有新建任何資料庫，需在所有資料庫建立完成後補上跨庫 Relation。
參照 plugin 根目錄 references/db-templates.md（相對 SKILL.md 為 ../../references/）「第二輪：補上 Relation 欄位」，使用 notion-update-data-source 執行：
ADD COLUMN "專案資料庫" RELATION({專案DS_ID})
ADD COLUMN "專案資料庫" RELATION({專案DS_ID})
ADD COLUMN "任務追蹤工具" RELATION({任務DS_ID}, DUAL)
ADD COLUMN "bug處理方式" RELATION({BugDS_ID}, DUAL)
注意：僅對本次新建的資料庫補 Relation。若資料庫是既有的且已有 Relation 欄位，跳過該步驟。 若某個資料庫被跳過（使用者選擇「跳過」），則不建立與該資料庫的 Relation。
ADD COLUMN "相關任務" RELATION({任務DS_ID}, DUAL)
DUAL 自動產生反向欄位「被關聯任務」。建立後用
notion-fetch確認反向欄位名稱正確，若 Notion 自動命名不符預期，使用 RENAME COLUMN 修正為「被關聯任務」。 此欄位用於 Bug ↔ Feature / Bug ↔ Bug 的任務間關聯，供/bug-start自動關聯來源 Feature 使用。
所有資料庫建立完成後，更新工作區頁面內容，將所有資料庫以 inline linked view 嵌入。
參照 plugin 根目錄 references/db-templates.md（相對 SKILL.md 為 ../../references/）「E. CREW 工作區頁面」模板，使用 notion-update-page 的 replace_content 寫入：
<database data-source-url="collection://{任務DS_ID}" inline="true" icon="✅">任務追蹤工具</database>
<database data-source-url="collection://{BugKB_DS_ID}" inline="true" icon="🐛">Bug 知識庫</database>
<database data-source-url="collection://{專案DS_ID}" inline="true" icon="📂">專案資料庫</database>
注意：
{任務DS_ID}、{BugKB_DS_ID}、{專案DS_ID} 替換為實際的 Data Source IDdata-source-url 建立 linked view取得 Git 遠端 URL 並解析為識別碼：
# Git remote URL（自動偵測）
git remote get-url origin 2>/dev/null || echo ""
# 分支名稱
git branch --show-current 2>/dev/null || echo ""
# 當前工作目錄（備用，非 Git repo 時使用）
pwd
Git Repo 識別碼解析規則：
git remote get-url originintumit（公司 GitLab）→ {group}/{repo}（如 ORG01P2401/PushAPIService）{host}/{group}/{repo}（如 github.com/org/repo）.git 後綴，支援 HTTPS / SSH 格式搜尋專案資料庫中的所有專案，檢查是否已有對應的專案條目。
情境 A：專案資料庫中已有匹配的專案（Git Repo 欄位精確匹配識別碼）
偵測到 Git Repo：ORG01P2401/sample-app
已匹配到 Notion 專案：範例機關-ORG01P2401
是否更新專案資訊？[Y/n]
若選擇更新 → 進入專案資訊填寫流程（僅更新空白欄位）。
情境 B：專案資料庫中有專案但未匹配
偵測到 Git Repo：ORG01P2401/sample-app
請選擇要對應的 Notion 專案（或輸入 0 建立新專案）：
0. 建立新專案
1. 專案 A（Git Repo：未設定）
2. 專案 B（Git Repo：ORG01P2401/PushAPIService）
3. 專案 C（Git Repo：未設定）
選擇現有專案 → 將識別碼寫入「Git Repo」欄位，並進入專案資訊填寫流程。 選擇建立新專案 → 進入情境 C。
情境 C：建立新專案條目
使用 notion-create-pages 在專案資料庫建立新條目，引導填寫：
建立新專案，請填寫以下資訊：
專案名稱：（必填）
Git Repo：ORG01P2401/sample-app（已自動偵測，Enter 確認或修改）
狀態：進行中（預設）
其餘欄位（SIT 主機／UAT 主機／正式環境主機／部署方式／說明）為通用欄位引導，參照 plugin 根目錄 references/project-page-templates.md（相對 SKILL.md 為 ../../references/）「建立新專案條目－通用欄位引導」一節。
自動偵測的欄位：
git remote get-url origin 解析為識別碼選用欄位允許留空，使用者可稍後在 Notion 頁面直接編輯。
以 plugin 根目錄 references/config.template.md（相對 SKILL.md 為 ../../references/）為模板，填入偵測到的 ID 與對應資訊，寫入使用者在『決定設定檔位置並檢查是否已存在』一節選擇的路徑。
新增欄位：在設定檔中填入「CREW 工作區」區段：
## CREW 工作區
| 項目 | 值 |
|------|-----|
| 工作區頁面 ID | `{workspace_page_id}` |
| 工作區頁面 URL | `https://www.notion.so/{workspace_page_id}` |
向使用者顯示：
Bug Workflow 設定完成！
已偵測到的資料庫：
✅ 任務追蹤工具：1d8a401b-...
✅ Bug 知識庫：bd132aa4-...
✅ 專案資料庫：f67699b6-...
🚀 CREW 工作區：https://www.notion.so/{workspace_page_id}
已設定的專案對應：
• 範例機關-ORG01P2401 → ORG01P2401/sample-app
設定檔位置：~/.claude-company/bug-workflow-config.md
現在可以使用：
/bug-start <問題簡述> — 建立 Bug 條目
/bug-update <內容> — 更新調查資訊
/bug-close — 結案並同步知識庫
/bug-investigate <關鍵字> — 假說驅動調查（含比對 Bug 知識庫過往解法）
/bug-update reopen <Bug> — 重新開啟已結案 Bug
notion-fetch 驗證欄位結構（至少含「任務名稱」Title + 「狀態」Status），才能確認是正確的目標資料庫。notion-create-database 不支援直接建立 Relation 欄位，必須先建好所有資料庫（記錄 Data Source ID），再用 notion-update-data-source 的 ADD COLUMN ... RELATION 語法補上。忘記這點會導致建庫失敗。notion-fetch 取得的 data-source-url 是 collection:// 開頭的 UUID，不是 database ID（database ID 是頁面 URL 中的那串）。兩者不可混用。RELATION({DS_ID}, DUAL) 是從「當前資料庫」指向「目標資料庫」建立雙向關聯。如果方向搞反（在專案資料庫建 DUAL 指向任務追蹤工具），雙向欄位名稱會不如預期。notion-create-database 預設 inline=false（子頁面模式），資料庫會以連結形式顯示，使用者需要點進去才看得到列表。每個資料庫建立後，必須立即使用 notion-update-data-source 設定 is_inline: true，才能在父頁面直接展開顯示列表。忘記這步會導致使用者體驗完全不符預期。claude plugin install notion）/bug-setup，選擇「更新專案對應」/bug-setup 即可重建