메뉴
本專案 (Manifest V3 Chrome extension) 的 commit 規範與範例：subject 使用英文 Conventional Commits、body 使用繁中說明背景與原因。當使用者提到「commit、提交訊息、commit message、寫 commit、commit 規範」時觸發。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
建立本專案的 Pull Request：雙語描述 (zh-TW/en)、gh CLI、.agent/skills/pull-request/scripts/check-pr.sh 預驗證、references/pr_template.md 與 checklist.md。當使用者提到「開 PR、建 PR、create PR、pull request、提交變更、發 PR、新建 PR」時觸發。
本專案 (MV3 Chrome extension) 的除錯紀律與 playbook：先重現再修、證據優先於模式匹配、單變因修改、跨 context 時序問題、service worker 終止、storage 問題、flaky E2E 分流。當使用者提到「除錯、debug、壞掉、不會動、修不好、查原因、root cause、flaky、時好時壞」時觸發。
維護本專案 AI agent harness（AGENTS.md / CLAUDE.md / GEMINI.md / .agent/{rules,skills,workflows} / docs/wiki）的 SOP：單一事實來源對照表、drift 稽核步驟、新增/刪除 skill 的判準、wiki 同步機制。當使用者提到「更新 harness、同步 AGENTS、文件過時、drift、稽核設定檔、整理 skills、維護 wiki」時觸發。
交付前驗證紀律：依變更類型選擇最小充分驗證組合（unit / 目標 E2E / happy-path CI / make build）、Makefile 打包檢查、i18n 連動、GEMINI.md key_files 同步、誠實回報。當使用者提到「驗證、收尾、完成了嗎、可以交付嗎、送 PR 前、檢查一下」或任何實作即將收尾時觸發。
清理已合併進 main 的本地與遠端 git 分支。本專案採 squash merge，PR 合併後特性分支可直接刪除。當使用者提到「清理分支、cleanup branches、刪除舊分支、清掉已合併分支、整理 branch」時觸發。
撰寫本專案的 PRD (產品需求文件)，位置為 /docs/specs/{type}/{ID-PREFIX}_{desc}/PRD_spec.md。當使用者提到「PRD、產品需求、需求文件、寫規格、新功能規劃、acceptance criteria」時觸發。分級 SDD 之 T2（完整流程）的 Phase 1，產出物提供給 sa skill 銜接；T1 輕量案件不需獨立 PRD。
| name | commit-message-helper |
| description | 本專案 (Manifest V3 Chrome extension) 的 commit 規範與範例：subject 使用英文 Conventional Commits、body 使用繁中說明背景與原因。當使用者提到「commit、提交訊息、commit message、寫 commit、commit 規範」時觸發。 |
When writing commit messages, follow these rules:
():
Good: refactor(sidepanel): modularize sidepanel.js into single-purpose modules
此次提交將原先龐大的 sidepanel.js 重構成多個職責單一的模組，旨在改善程式碼結構、可讀性，並簡化未來的開發流程。
核心邏輯現已拆分至 modules/ 目錄下的多個模組：
apiManager.js: 作為服務層，封裝了所有與 Chrome 擴充功能 API (chrome.*) 的互動。這將 API
呼叫集中管理，使其更易於維護和模擬測試。stateManager.js: 管理 UI 相關的狀態，例如書籤資料夾的展開狀態。這避免了污染全域作用域，並提供了清晰的狀態管理函式。uiManager.js: 處理所有 DOM 操作與畫面渲染。它接收資料並負責呈現，但本身不包含任何業務邏輯。dragDropManager.js: 包含所有與 SortableJS 函式庫相關的邏輯，管理分頁和書籤的拖放功能。searchManager.js: 封裝了由使用者在搜尋框中輸入觸發的搜尋與過濾邏輯。主要的 sidepanel.js 腳本現在作為一個高層級的協調者。其唯一職責是初始化所有模組，並協調它們之間的資料流與事件。
其他變更：
sidepanel.html 已更新，將 sidepanel.js 作為 type="module" 載入。Makefile 已更新，將新的 modules/ 目錄包含在最終的打包檔案中。GEMINI.md 已更新，以反映新的模組化架構。Bad: updated stuff
GEMINI.md 既有規範），body 繁中。subject 50 字內、imperative mood、不加句號。sidepanel、modules/ui、modules/utils、modules/api、background、manifest、i18n、tests、makefile、docs。key_files（如 sidepanel.js、modules/ui/elements.js）時，body 提醒一句「同步更新 GEMINI.md key_files 描述」。Closes #123 或 Refs #123。