---
trigger: always_on
---

# 技能觸發規範 (Skill Trigger Rules)

本文件確保 AI 助手在對話中能**主動辨識**需要參照技能 (Skill) 的時機。
Skills 位於 `.agents/skills/`，採漸進式揭露以節省 Token。
**若對話內容命中以下任一觸發條件，必須先使用 `view_file` 讀取對應的 `SKILL.md` 後再進行作業。**

---

## 觸發對照表

| 觸發詞 / 情境 | 對應 Skill | 路徑 |
|---|---|---|
| 操作紀錄、Activity Log、日誌、`tapActivity`、`LogsActivity`、`saveQuietly`、`activity()`、`items_diff` | **操作紀錄實作規範** | `.agents/skills/activity-logging/SKILL.md` |
| 權限、permission、角色、role、`usePermission`、`<Can>`、`PermissionSeeder`、middleware protection | **權限管理與實作規範** | `.agents/skills/permission-management/SKILL.md` |
| 跨模組、Service Interface、`Contracts`、模組間通訊、`ServiceProvider` 綁定、禁止跨模組引用 | **跨模組調用與通訊規範** | `.agents/skills/cross-module-communication/SKILL.md` |
| 按鈕樣式、表格規範、圖標、分頁、Badge、Toast、表單、UI 統一、頁面佈局、`button-filled-*`、`button-outlined-*`、`lucide-react`、色彩系統 | **客戶端後台 UI 統一規範** | `.agents/skills/ui-consistency/SKILL.md` |
| Git 分支、commit、push、合併、部署、`feature/`、`hotfix/`、`develop`、`main` | **Git 分支管理與開發規範** | `.agents/skills/git-workflows/SKILL.md` |
| E2E、端到端測試、Playwright、`spec.ts`、功能驗證、自動化測試、回歸測試 | **E2E 端到端測試規範** | `.agents/skills/e2e-testing/SKILL.md` |
| 查詢、撈資料、Query、Controller、下拉選單、Eloquent、N+1、`->get()`、select、交易、Transaction、Bulk、分頁、索引 | **資料庫與 ORM 最佳實踐規範** | `/home/mama/.gemini/antigravity/global_skills/database-best-practices/SKILL.md` |

---

## 強制觸發場景

以下場景**無論對話中是否出現觸發詞**，都必須主動載入對應 Skill：

### 🔴 新增功能或頁面時
必須同時讀取：
1. **permission-management** — 設定權限
2. **ui-consistency** — 遵循 UI 規範
3. **activity-logging** — 若涉及 Model CRUD，需加上操作紀錄
4. **e2e-testing** — 確認是否需要新增對應的 E2E 測試

### 🔴 新增或修改 Model 時
必須讀取：
1. **activity-logging** — `tapActivity` 實作
2. **cross-module-communication** — 確認是否涉及跨模組引用

### 🔴 Git 操作時
必須讀取：
1. **git-workflows** — 分支命名與 commit 格式

### 🔴 新增或修改 API 與 Controller 撈取資料庫邏輯時
必須讀取：
1. **database-best-practices** — 確認查詢優化、交易安全、批量寫入與索引規範

---

## 注意事項

> [!IMPORTANT]
> 即使你「記得」Skill 的大致內容，仍必須重新讀取 `SKILL.md`。
> 因為 Skill 文件可能已經更新，且記憶中的內容可能不完整。