star-cloud/.agents/rules/skill-trigger.md

trigger

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 隔離邏輯正確套用