القائمة
交付前驗證紀律：依變更類型選擇最小充分驗證組合（unit / 目標 E2E / happy-path CI / make build）、Makefile 打包檢查、i18n 連動、GEMINI.md key_files 同步、誠實回報。當使用者提到「驗證、收尾、完成了嗎、可以交付嗎、送 PR 前、檢查一下」或任何實作即將收尾時觸發。
التثبيت باستخدام 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」時觸發。
清理已合併進 main 的本地與遠端 git 分支。本專案採 squash merge，PR 合併後特性分支可直接刪除。當使用者提到「清理分支、cleanup branches、刪除舊分支、清掉已合併分支、整理 branch」時觸發。
本專案 (Manifest V3 Chrome extension) 的 commit 規範與範例：subject 使用英文 Conventional Commits、body 使用繁中說明背景與原因。當使用者提到「commit、提交訊息、commit message、寫 commit、commit 規範」時觸發。
撰寫本專案的 PRD (產品需求文件)，位置為 /docs/specs/{type}/{ID-PREFIX}_{desc}/PRD_spec.md。當使用者提到「PRD、產品需求、需求文件、寫規格、新功能規劃、acceptance criteria」時觸發。分級 SDD 之 T2（完整流程）的 Phase 1，產出物提供給 sa skill 銜接；T1 輕量案件不需獨立 PRD。
| name | verification |
| description | 交付前驗證紀律：依變更類型選擇最小充分驗證組合（unit / 目標 E2E / happy-path CI / make build）、Makefile 打包檢查、i18n 連動、GEMINI.md key_files 同步、誠實回報。當使用者提到「驗證、收尾、完成了嗎、可以交付嗎、送 PR 前、檢查一下」或任何實作即將收尾時觸發。 |
「寫完 code」不等於「完成」。本 skill 定義宣稱完成前必須通過的驗證，以及對應變更類型的最小充分火力表——不多跑浪費時間，不少跑帶病交付。
npm run test:full 全套很貴），也不是一律不跑。| 變更類型 | 必跑 | 說明 |
|---|---|---|
| 純文件（docs/、*.md、spec） | 無自動化 | 人工檢查連結與檔案引用是否存在 |
modules/utils/、純函式、modules/sync/syncLogic | npm run test:unit | 單元測試最快，先跑 |
| UI / renderer / 互動邏輯 | 相關單一 E2E 檔 → npm run test:ci | 先跑最相關的一檔（快），過了再跑 happy-path 全套 |
manifest.json / Makefile / 新增檔案 | make + make release，並檢查 zip 內容 | 漏打包是本專案歷史事故，見下方檢查法 |
background.js / service worker 邏輯 | 相關 E2E + 手動情境思考「SW 終止後還對嗎」 | in-memory 狀態存活性 |
| 測試本身的修改 | 該測試檔連跑 3 次 | 排除 flaky 假陽性 |
# 常用指令
npm run test:unit # 單元測試（秒級）
npx jest usecase_tests/puppeteer_tests/<related>.test.js # 目標 E2E
npm run test:ci # happy-path 全套（CI 等價）
make && make release # 兩種 build 都要能過
DEV_SRC_FILES？prod 需要的話是否在 PROD_STATIC_FILES 或 esbuild 指令中？驗證法：unzip -l arc-sidebar-v*-dev.zip | grep <新檔名>。_locales/（14 語）要補 key；README / store description 層級的文案 → 觸發 update-multilingual-docs skill。key_files：新增模組或改變既有模組職責時同步更新描述（專案歷史約定）。驗證結果：
- npm run test:unit：✅ 42 passed
- npx jest .../happy_path_search.test.js：✅ 4 passed
- make && make release：✅ 產物包含新檔案 modules/foo.js
- 未跑：npm run test:full（變更不涉及其他動線；CI 會跑）
有失敗就照實列出失敗輸出與你的判斷（是本次變更造成、還是既有 flaky——flaky 判斷依據見 debugging skill）。