程式碼規範
lefthook.yml已使用正確的pnpm typecheck，涵蓋 workspace、三個應用設定和測試工具。CI 獨立執行 lint、型別檢查、單元測試覆蓋率及建置。
Lint 工具鏈
| 工具 | 用途 | 設定套件 |
|---|---|---|
| ESLint | JS/TS/Vue 規範 | @vh5/eslint-config |
| Oxfmt | 程式碼格式化 | @vh5/oxfmt-config |
| Stylelint | CSS/SCSS 規範 | @vh5/stylelint-config |
| OXLint | 快速 Lint 檢查 | @vh5/oxlint-config |
| Commitlint | 提交訊息規範 | @vh5/commitlint-config |
Git 提交規範
使用 czg 進行規範化提交：
bash
pnpm exec czg提交格式：type(scope): message
Git 鉤子（lefthook）
本專案使用 lefthook 管理 Git 鉤子。每次 git commit 時，pre-commit 鉤子會自動執行（串行執行，避免低配機器記憶體 / CPU 瞬時飆升）：
- oxlint —— 對暫存檔案執行
oxlint --fix --type-aware - oxfmt —— 格式化暫存檔案
- eslint —— 對暫存檔案執行
eslint --fix - stylelint —— 對暫存 Vue / CSS / SCSS 檔案執行
stylelint --fix - typecheck —— 全量 TypeScript 型別檢查（
pnpm typecheck）
所有 lint 任務都會自動修復並重新暫存變更。commit-msg 鉤子執行 commitlint，強制校驗上述提交資訊格式。合併（merge）之後，post-merge 鉤子會自動執行 pnpm install。
由於鉤子會自動執行，正常提交即可，無須手動先跑 lint（當然也可使用 pnpm lint / pnpm format 在本地自查）。
AI 助手本機檔案
.gitignore 排除常見 AI 助手的本機記憶、歷史、工作階段與憑證（含 .workbuddy/memory/）。共享指令、規則及技能仍可提交，如 AGENTS.md、.cursor/rules/、.claude/skills/ 和 .codex/skills/，不會刪除個人資料。新增其他工具時只忽略具體本機產物，並用 git check-ignore --no-index 驗證；回歸測試亦確認共享規則不被誤忽略。