star-erp/.agents/rules/skill-triggers.md

trigger

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

---

強制觸發場景

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

🔴 新增功能或頁面時

必須同時讀取：

1. permission-management — 設定權限
2. ui-consistency — 遵循 UI 規範
3. activity-logging — 若涉及 Model CRUD，需加上操作紀錄

🔴 新增或修改 Model 時

必須讀取：

1. activity-logging — tapActivity 實作
2. cross-module-communication — 確認是否涉及跨模組引用

🔴 Git 操作時

必須讀取：

1. git-workflows — 分支命名與 commit 格式

---

注意事項

Important

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