第一堂課：安裝與設定
最近常收到許多剛踏入數位教學的夥伴詢問：「想試試看強大的 AntiGravity，但到底該怎麼跨出第一步？」
別擔心！從下載安裝到建立第一個專案，幫大家把路都鋪好了，跟著幾個簡單步驟，你也能輕鬆駕馭這個數位利器！
🛠️ 第一步：安裝（官網下載與安裝）
- 前往官網：造訪 AntiGravity 的官方網站下載頁面。
- 選擇對應版本：系統通常會自動偵測您的作業系統。
- 一鍵安裝：下載完成後，點擊安裝檔，幾秒鐘就能輕鬆搞定！
🚀 第二步：建立專案與精準下達指令
- 建立你的專案工作區：直接建立一個空白資料夾，將 AntiGravity 指向這個資料夾。沒有多餘的設定檔，你電腦裡的資料夾就是它的工作台。
- 如何寫出好指令：不要把它當搜尋引擎，請把它當作你的「專案實習生」。給定具體情境與身分，明確指定輸出結果。
第二堂課：介紹 Agent
聊天機器人 vs. AI 代理人，你用對了嗎？
我們同樣在對話框裡輸入指令，背後的運作邏輯卻完全不同。
🔍 一張圖看懂：顧問 vs. 代理人 的大不同
- 一般生成式 AI：你輸入需求，它吐出文字。如果想調整排版，必須不斷複製貼上，重新下一行一行的指令，無法直接修改電腦裡的檔案。
- AntiGravity 代理人：它理解「整體專案目標」。當你跟它對話調整內容時，它一邊跟你討論，一邊在右側直接調整好、自動排序，最後在
outputDir之中自動生成乾淨的檔案。它做的是「一條龍的專案優化」！
💡 奕鈞老師的新手啟航小提示：不要只把它當成「聊天」的對象，要把自己當成「專案負責人（PM）」。
第三堂課：生成題目
丟入「題庫.docx」，AI 代理人秒幫你逆向工程產出全新試題！
🛠️ 三步驟玩轉「題庫檔案逆向衍生工作流」
- 1️⃣ 將「題庫.docx」放入專案資料夾：告訴代理人：「請讀取專案目錄下的題庫.docx，分析所有題目的命題概念與難易度結構。」
- 2️⃣ 限制範圍，要求「概念遷移」生新題：代理人理解舊題目骨架後，指令：「請針對相同命題概念，尋找全新素材，設計難易度相同但內容全新的選擇題。」
- 3️⃣ 產出前的「一鍵防呆」與美化：告訴代理人：「請將產出的新試題建立 word 檔案，包含標題、班級姓名填寫區，並存入 outputDir。」
這套方法非常適合「錯題延伸練習」或「單元概念複習卷」，它就像看過你所有題庫的專業助教！
第四堂課：全域與專案設定
打造專屬代理人，只要透過 AGENTS.md 純文字檔，就能設定代理人的行為原則！
- 🌐 全域設定（Global）：適用於你的整台電腦。
路徑：C:\Users\user\.gemini\config\AGENTS.md - 📁 專案設定（Project）：只在當前的資料夾內生效。
路徑：在專案內建立.agents資料夾與AGENTS.md。
🚀 推薦新手寫入的 3 個實用規則（代理人就會嚴格遵守）：
- 統一檔案歸檔：「所有新產出的檔案請統一存放在 output 資料夾中。」
- 語言與語氣規範：「使用繁體中文，扮演親切有耐心的專業助教，避免過度艱澀的術語。」
- UI/UX 設計規範：「網頁設計必須優先採用響應式設計（RWD），符合現代化友善標準。」
第五堂課：生成互動網頁
零程式碼開發 —— 一鍵生成「互動式網頁教材」
不用學任何程式碼，只要用白話文，就能讓代理人直接做一個「可以點擊互動」的網頁小工具給學生用。
步驟一：下達你的「產品需求」
把代理人當成你的專屬工程師：「你是一位資深的前端工程師。請幫我做一個『英文單字翻轉卡片』的互動網頁，畫面有現代感，點擊有翻轉動畫...請將程式碼寫在同一個檔案內，存到 output 資料夾。」
步驟二：見證魔法與驗收
代理人就會開始自動撰寫程式碼。打開 output 資料夾的 HTML 檔，立刻就能使用！
💡 奕鈞老師的私房小訣竅：不滿意不要自己改程式碼！直接在對話框繼續許願（例如要求深色模式、調快速度）。剩下的苦工全交給代理人！
第六堂課：Skill 技能打包
建立專屬 Skill：把又長又複雜的指令，打包成一個「技能檔」。以後只要喊出技能名稱，代理人就會自動載入你設定好的所有條件！
步驟一：建立你的第一個 Skill 技能包
輸入提示詞：「建立一個skill。當我提到『密室逃脫網頁』，需要包含以下要素：視覺為暗黑懸疑風格、三個解謎關卡、10分鐘倒數計時。」
步驟二：優雅地無腦呼叫技能
技能建好後，只要輕鬆敲下一行字：「請幫我做一個以『古代金字塔』為主題的密室逃脫遊戲。」Agent會自己去讀取 SKILL.md 裡的設定，一次幫你寫出完整邏輯的遊戲。這就是自動化的極致！
第七堂課：必備 Skill
這份清單推薦給所有需要處理大量文件、講義與考卷的老師。安裝這些基礎技能後，您的 AI 代理人將具備「打破檔案格式限制」的強大能力！
- 1️⃣ read_microsoft_docs (微軟文件讀取)：讓 AI 具備「閱讀」Word、PPT、Excel 檔案的能力，自動解析重新排版。
- 2️⃣ markitdown (轉為純文字餵給 AI)：將複雜排版的文件，萃取為乾淨的 Markdown，大幅提升 AI 解題與出題的精準度。
- 3️⃣ PyMuPDF (結構化萃取)：精準定位與解析 PDF 檔案內的文字座標與圖片位置。
- 4️⃣ pdf_ocr (PDF 掃描圖檔辨識)：將圖片版掃描 PDF，轉換為可以反白複製文字的數位 PDF，讓舊考卷文字復活。
- 5️⃣ pdf_extract_images (PDF 抽圖轉檔)：指定 PDF 特定頁面，高畫質抽出為圖片檔，免去手動截圖。
👉 安裝方式：將網址複製貼給代理人，輸入「請幫我安裝這幾個 skills。」
