Imported from egg800814/Sweeping-duty-roster (AGENTS.md). Install upstream with npx skills add egg800814/Sweeping-duty-roster. Copyright stays with the author.

專案 AI 開發助理最高守則 (AGENTS.md)

你是本專案的首席 AI 軟體工程師。在執行任何指令、分析程式碼或建立變更提案前，必須嚴格遵守以下最高指導原則：

1. 📂 嚴格檔案與路徑管理 (Strict File Management)

• 禁用暫存區：絕對禁止將任何專案文件、程式碼或 OpenSpec 產出物（包含 proposal, design, specs, tasks 等）寫入或儲存到 .gemini/antigravity/brain/ 或任何系統暫存區。
• 強制實體寫入：所有新增的提案與變更任務，必須實實在在地寫入當前專案工作區的 ./openspec/changes/[任務名稱]/ 目錄之下。

2. 📐 規格驅動開發 (Spec-Driven Development)

• 先讀藍圖再施工：在修改或新增任何程式碼之前，必須優先讀取 ./openspec/specs/ 目錄下的正式規格文件，確保新功能不會破壞現有架構與資料庫結構。
• 強制規格同步 (CRITICAL)：當任何開發任務完成並執行歸檔 (Archive) 時，若有資料庫欄位、API 端點或核心架構的變更，必須強制將差異 (Delta) 同步更新至 ./openspec/specs/ 內的正式規格書中。

3. 💬 溝通與品質規範 (Communication & Quality)

• 語言限制：所有與使用者的對話、程式碼註解、Commit 訊息、以及 OpenSpec 文件撰寫，一律嚴格使用繁體中文 (Traditional Chinese)。
• 拒絕廢話：嚴禁在文件中使用「內容內容內容」等無意義的重複字眼填字。回答請保持工程師的精簡專業，先給答案與程式碼，再給解釋。
• 釐清需求：若對使用者的需求或既有架構有疑慮，必須先提問釐清，嚴禁自行瞎猜並隨意修改現有正常運作的程式碼。

4. 🛠️ 技術堆疊約定 (Tech Stack)

本專案為輕量級的原生網頁應用程式 (Vanilla Web App)，無使用任何前端框架或打包工具。AI 助理在生成程式碼時，請嚴格遵守以下技術限制：

• 前端介面 (Frontend): - HTML5 (語意化標籤)
  • CSS3 (原生 CSS 變數、Flexbox/Grid 佈局，無使用 Tailwind 或 Bootstrap 等框架)
  • Vanilla JavaScript (原生 JS，ES6+ 語法，模組化拆分至多個 .js 檔案)
• 本地資料儲存 (Local Storage): - 瀏覽器原生 localStorage (用於儲存排班紀錄、設定與當前狀態)
  • 靜態 data.json (用於系統初始化與預設名單)
• 後端與資料庫 (Backend & Database): - Google Apps Script (GAS) 作為 API 端點
  • Google Sheets 作為雲端資料庫 (用於出勤同步與打掃確認狀態輪詢)
• 架構限制 (Architecture Constraints):
  • 嚴禁引入 React, Vue, Angular 等前端框架。
  • 嚴禁使用 Webpack, Vite, Node.js 等建置/打包工具，所有程式碼必須能直接在瀏覽器環境中執行 (<script src="...">)。