設定 Agent 專案：資料夾範圍、權限與擴充能力
核心問題：打開 Antigravity 之後，Agent 到底能碰到我電腦上的哪些東西？
裝好、登入之後，下一個決定是「Agent 的工作範圍在哪裡」。Antigravity（以及其他代理式開發工具）都以你指定的專案資料夾作為 Agent 的操作邊界：Agent 能讀寫、執行終端機指令的範圍就是這個資料夾，不是你整台電腦。設定專案時的資料夾選擇與權限確認，是整個代理式開發流程裡最容易被跳過、卻最該花時間想清楚的一步。Skills／MCP 屬於目前主流 Agent 工具圈共通的擴充機制概念說明，Antigravity 實際支援的細節與名稱請以官方最新文件為準。
學習成果：能安全地建立一個範圍明確的 Agent 專案，並理解 Skills、MCP 這兩種擴充能力的用途邊界。
核心概念
專案資料夾＝Agent 的工作邊界
建立專案時，你指定一個資料夾（可以是既有專案，也可以是全新空白資料夾）。Agent 之後的讀檔、寫檔、執行指令都被限制在這個範圍內，不會觸及資料夾外的檔案。
說人話：像把 Agent 請進一個房間工作，而不是把整棟房子的鑰匙都給它——它只能動房間裡的東西。
權限確認：同意前先看清楚範圍
Antigravity 在執行檔案寫入或終端機指令前通常會提示確認。看到權限提示時，先確認「這是我預期的資料夾」再放行，尤其是第一次幫一個新專案設定時。
Skills：把重複性任務包裝成可重用流程
Skills 是目前 Agent 工具圈用來包裝「標準作業流程」的方式——把一套經驗證的步驟（例如本手冊用來掃描介面對比度、觸控尺寸的檢查流程）寫成 Agent 可以呼叫的技能包，之後同類任務不必每次重新說明規則。
MCP：讓 Agent 接上外部工具與資料
MCP（Model Context Protocol）是一個開放協議，讓 Agent 能連接外部工具與資料來源（例如 GitHub、資料庫、雲端文件），不必為每個工具各自寫一套串接程式。教育場景常見的想像：連上學校共用的試算表或雲端硬碟資料夾。
說人話：沒有 MCP 時，Agent 只認得你貼給它的文字；接上 MCP 之後，它可以自己去查詢、讀取特定系統裡的資料。
為什麼資料夾範圍值得花時間想
代理式工具的自主性越高，範圍設定的重要性越高：
- Agent 在範圍內可以刪除、覆寫既有檔案，不是唯讀操作
- 把範圍縮小到單一乾淨資料夾，出錯時影響也被限制在同一個範圍
- 含真實學生資料、成績、聯絡資訊的資料夾，不建議直接作為 Agent 專案範圍
- 不確定就先在一個全新空白資料夾練習，熟悉後再考慮接上既有專案
Skills 與 MCP 的教育應用想像
兩者都是「不用重新發明輪子」的機制，教育場景可以這樣理解：
- Skills：把「產出座位表」「批次改格式」這類固定流程包裝起來，之後直接呼叫，不用每次重講一遍規則
- MCP：把 Agent 接上學校共用的雲端硬碟或試算表，讓它能直接查資料而不是每次手動貼上
- 兩者都需要事先設定與授權，不是打開就自動擁有——第一次使用建議在測試資料上驗證行為是否符合預期
操作步驟
- 1
選擇專案來源
開啟 Antigravity 後選「開啟資料夾」：可以指向既有的程式專案，或建立一個全新的空白資料夾。
- 2
確認資料夾範圍乾淨
不要直接指向整個使用者家目錄或含真實學生資料的資料夾；教學專案建議另建乾淨的工作資料夾。
- 3
回應權限提示
第一次讀寫檔案或執行終端機指令時會出現確認提示，看清楚是對哪個資料夾操作後再同意。
- 4
視需求加入 Skills／MCP
若任務需要標準化流程或外部資料串接，在設定裡查看是否有對應的 Skills 或 MCP 連接器可用；不需要的任務可以完全略過這一步。
常見誤解
誤解：打開 Antigravity 之後，Agent 就能存取電腦上所有檔案。
實際：Agent 只能操作你明確指定的專案資料夾範圍；範圍外的檔案需要另外開啟新專案或手動提供。
誤解：裝了 Skills 或接了 MCP，Agent 就會自動變得更聰明。
實際：兩者只是「連接管道」——決定 Agent 表現好壞的仍是任務描述與驗收條件是否寫清楚。