sky121113
3ce88ed342
- 機台日誌：對齊 Luxury UI 規範，實作整合式佈局與分頁組件。 - 多語系：完成機台日誌繁、英、日三語系翻譯與動態處理。 - UI 規範：更新 SKILL.md 定義「標準列表 Bible」。 - 後端：完善 TenantScoped 隔離邏輯，修復儀表板死循環與 User Model 缺失。 - IoT：擴展機台、會員 Model 並建立交易、商品、狀態等核心表結構。 - 基礎設施：設置台北時區與 Docker 環境變數同步。
45 lines
2.1 KiB
Markdown
45 lines
2.1 KiB
Markdown
---
|
||
trigger: always_on
|
||
---
|
||
|
||
# 技能觸發規範 (Skill Trigger Rules)
|
||
|
||
本文件確保 AI 助手在對話中能**主動辨識**需要參照技能 (Skill) 的時機。
|
||
Skills 位於 `.agents/skills/`，採漸進式揭露以節省 Token。
|
||
**若對話內容命中以下任一觸發條件，必須先使用 `view_file` 讀取對應的 `SKILL.md` 後標記為 active 再進行作業。**
|
||
|
||
---
|
||
|
||
## 觸發對照表
|
||
|
||
| 觸發詞 / 情境 | 對應 Skill | 路徑 |
|
||
|---|---|---|
|
||
| 機台通訊, IoT, 日誌上報, Log Ingestion, 異步隊列, Queue, Heartbeat, 心跳發報 | **IoT 通訊與高併發處理規範** | `.agents/skills/iot-communication/SKILL.md` |
|
||
| 介面, UI, 佈局, CSS, Tailwind, 奢華, 深色模式, Light Mode, Dark Mode, Blade, 樣式, 間距, 陰影, 動畫 | **極簡奢華風 UI 實作規範** | `.agents/skills/ui-minimal-luxury/SKILL.md` |
|
||
| 查詢、撈資料、Query、Controller、下拉選單、Eloquent、N+1、`->get()`、select、交易、Transaction、Bulk、分頁、索引 | **資料庫與 ORM 最佳實踐規範** | `/home/mama/.gemini/antigravity/global_skills/database-best-practices/SKILL.md` |
|
||
| RBAC, 權限, 角色, 租戶, Tenant, Company, Access Control, 多租戶, 權限控管 | **多租戶與權限架構實作規範** | `.agents/rules/rbac-rules.md` |
|
||
|
||
---
|
||
|
||
## 強制觸發場景
|
||
|
||
以下場景**無論對話中是否出現觸發詞**，都必須主動載入對應 Skill：
|
||
|
||
### 🔴 新增或修改頁面 (Views/Blade) 時
|
||
必須讀取：
|
||
1. **ui-minimal-luxury** — 確保符合極簡奢華風視覺與互動規範
|
||
2. **rbac-rules** — 確認 UI 區塊的權限顯示控制
|
||
|
||
### 🔴 新增機台通訊 API 端點時
|
||
必須讀取：
|
||
1. **iot-communication** — 決定是否使用異步隊列流程
|
||
|
||
### 🔴 修改 Job 或 Service 邏輯時
|
||
必須讀取：
|
||
1. **iot-communication** — 確保符合高併發處理架構
|
||
|
||
### 🔴 新增或修改 API 與 Controller 撈取資料庫邏輯時
|
||
必須讀取：
|
||
1. **database-best-practices** — 確認查詢優化、交易安全、批量寫入與索引規範
|
||
2. **rbac-rules** — 確保 `company_id` 隔離邏輯正確套用
|