f59efc6dc7
1. 移除非必要之 Log 備註：從來店禮使用記錄 (Logs) 的電腦版與行動版畫面中，徹底移除了無業務參考價值的技術備註 (Remark) 欄位，優化排版空間以符合極簡奢華風 UI 設計。 2. 補齊與對齊三語系檔案：補齊來店禮、通行碼與商品領取所缺少的多語系 Key，三個語系 JSON 檔 (zh_TW, en, ja) 的 Key 與行數已 100% 完美對齊 (共 2,255 行) 且完成升冪字母排序 (ksort)。 3. 簡化 Guest 票券大標題：簡化 Guest 端三種票券頁面 (通行碼、取貨碼、來店禮) 的大標題多語系拼接結構，改為單一乾淨的翻譯 Key 呼叫。 4. 口語化翻譯微調：將 Pickup Code 在語系檔中的中文翻譯由「領取碼」微調為更口語、直覺的「取貨碼」。 5. 優化 Guest 頁面欄位：將取貨碼頁面的「機台序號」替換為更具溫度的「機台名稱」；通行碼與來店禮頁面則徹底隱藏機台序號，優化用戶體驗。
2.7 KiB
2.7 KiB
| trigger |
|---|
| always_on |
技能觸發規範 (Skill Trigger Rules)
本文件確保 AI 助手在對話中能主動辨識需要參照技能 (Skill) 的時機。
Skills 位於 .agents/skills/，採漸進式揭露以節省 Token。
若對話內容命中以下任一觸發條件，必須先使用 view_file 讀取對應的 SKILL.md 後標記為 active 再進行作業。
觸發對照表
| 觸發詞 / 情境 | 對應 Skill | 路徑 |
|---|---|---|
| 機台通訊, IoT, 日誌上報, Log Ingestion, 異步隊列, Queue, Heartbeat, 心跳發報, MQTT, Topic, Broker, EMQX | IoT 通訊與高併發處理規範 / MQTT 通訊規範 | .agents/skills/iot-communication/SKILL.md .agents/skills/mqtt-communication-specs/SKILL.md |
| B010, B017, B600, B055, API 規格, 通訊協議, 狀態碼, 頁面碼, 範例, JSON | API 技術規格與通訊協議規範 | .agents/skills/api-technical-specs/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 |
| 多語系, 翻譯, 語系檔, lang, json, zh_TW, en, ja, I18n | 多語系管理與自動對齊規範 | .agents/skills/multilingual-specs/SKILL.md |
強制觸發場景
以下場景無論對話中是否出現觸發詞，都必須主動載入對應 Skill：
🔴 新增或修改頁面 (Views/Blade) 時
必須讀取：
- ui-minimal-luxury — 確保符合極簡奢華風視覺與互動規範
- rbac-rules — 確認 UI 區塊的權限顯示控制
🔴 新增機台通訊 API 端點時
必須讀取：
- iot-communication — 決定是否使用異步隊列流程
🔴 修改 Job 或 Service 邏輯時
必須讀取：
- iot-communication — 確保符合高併發處理架構
🔴 新增或修改 API 與 Controller 撈取資料庫邏輯時
必須讀取：
- database-best-practices — 確認查詢優化、交易安全、批量寫入與索引規範
- rbac-rules — 確保
company_id隔離邏輯正確套用
🔴 新增或修改語系 JSON 檔案（lang/*.json）或執行多語系任務時
必須讀取：
- multilingual-specs — 確保遵守三語系對齊、字母排序、斜線不逸出規範