ANTIGRAVITY 全端網頁開發實戰系列(階段 2 / 6)
STAGE 02 | RULES, MEMORY & SPECIFICATION

立規矩、建記憶與定規格:
專案鐵三角與自訂生態系

解決 AI「換個對話就失憶、每次風格都不一樣」的痛點。學會用 AGENTS.md、記憶交接檔、Skills 與 MCP 武裝你的 AI 工程師,並完成《今天學AI》全端規格書。

核心裝備
AGENTS.md / PROJECT.md / README.md
進階概念
Skills 技能手冊與 MCP 萬用插頭
授課教師
方正璽
PART 01 | 為什麼要調教 AI?

痛點現場:為什麼新開一個對話,AI 就失憶了?

The Amnesia Problem

在階段一我們做出了漂亮的《今天學AI》單頁原型。但當你按下左側 New Conversation 開啟新對話時,會立刻遇到三個問題:

PROBLEM 01

忘記你的身分與偏好

它忘了你是程式初學者,開始丟出一堆艱澀的英文術語,甚至直接用英文回答你。

PROBLEM 02

忘記《今天學AI》的品牌色

請它新增一個區塊,它又用回預設的紫藍漸層與圓角陰影,破壞原本沉穩的深墨藍風格。

PROBLEM 03

忘記上次做到哪裡

它不知道這個網站未來要接後端資料庫、也不知道下一個待辦任務是什麼,每次都要重新解釋半天。

本質原因:每一個新對話(Session),都像是一位「今天第一天來報到、完全沒看過前人紀錄的新實習生」。
階段二|立規矩、建記憶與定規格 02 / 16
PART 01 | 為什麼要調教 AI?

那為什麼不在「同一個對話」聊一輩子就好?

Context Window
WORKING MEMORY LIMIT

AI 的工作桌面(Context Window)是有限的

  • 想像 AI 面前有一張辦公桌,你們聊的每一句話、讀過的每一個檔案都會擺在桌上
  • 當對話超過幾十輪,桌面被塞爆,AI 就會開始漏看最前面的交代、回答變慢、甚至胡言亂語(幻覺)
  • 因此,專業開發者「每完成一個小階段,就會主動開新對話」保持 AI 頭腦清醒
THE SOLUTION

解法:把記憶與規矩「寫成檔案」留在專案裡

  • 不依賴對話紀錄,而是把重要資訊寫進專案資料夾的 Markdown(.md)文件
  • 新對話的 AI 一進門,先讀這幾份文件,3 秒鐘就能完全進入狀況
  • 就算未來換另一台電腦、或換另一個 AI 工具,也能無縫接手!
階段二|立規矩、建記憶與定規格 03 / 16
PART 01 | 自訂生態系全覽

武裝你的 AI 工程師:Antigravity 四大自訂機制

Customization System
機制名稱 生活化比喻 對應設定檔/位置 在《今天學AI》專案的用途
1. Rules(規則) 每天必背的「員工守則」 AGENTS.md 或 GEMINI.md 規定永遠用繁體中文、遵守墨藍品牌色、改檔前先報備(每次對話自動載入)
2. Memory(記憶) 下班前寫的「交接聯絡簿」 PROJECT.md + README.md 記錄網站規格、目前做到哪個階段、下一步待辦事項
3. Skills(技能) 書架上的「專業 SOP 手冊」 .agents/skills/<名>/SKILL.md 需要時才翻開的秘笈(例如:前端設計系統手冊、React 效能守則、簡報製作手冊)
4. MCP & Plugins 外接世界的「萬用 USB 插頭」 mcp_config.json / 外掛市集 幫 AI 接上外部服務(例如:操作雲端資料庫、連通 Vercel 自動部署)
階段二|立規矩、建記憶與定規格 04 / 16
PART 02 | THE GOLDEN TRIANGLE

專案鐵三角:
專業開發者的 AI 專案起手式

在動手寫任何一行正式的全端程式碼之前,我們先選對安全的資料夾位置,並建立三份決定專案成敗的靈魂文件。

PART 02 | 關鍵安全紅線

第一條鐵律:寫程式的專案,絕對不要放雲端同步資料夾!

Critical Warning
DANGER ZONE | 錯誤做法

把網站專案建在 Google Drive / OneDrive / iCloud

  • 進入階段三建立現代網站時,系統會產生一個叫 node_modules 的套件資料夾
  • 裡面動輒包含 3 萬~5 萬個極小的零碎檔案
  • 雲端硬碟會陷入瘋狂同步迴圈,導致電腦風扇狂轉、硬碟卡死、檔案權限鎖死報錯
SAFE ZONE | 正確做法

建在本機純淨路徑(如 C:\repos\)

  • 在 C 槽或使用者家目錄建立一個專門放程式的資料夾,例如:
    C:\repos\learn-ai-today
  • 那要怎麼雲端備份?階段六我們會用 GitHub 備份!GitHub 會聰明地只備份你寫的幾十個核心檔案,自動忽略那 5 萬個套件檔
階段二|立規矩、建記憶與定規格 06 / 16
PART 02 | 專案鐵三角

每個專案必備的三份靈魂文件:各司其職、互不混用

Golden Triangle
01 | AGENTS.md

員工守則(怎麼做事)

  • 系統自動讀取:Antigravity 每次對話必載入
  • 寫什麼:語言要求、溝通風格、品牌色票、不可違反的安全禁令
  • 更新頻率:很少改(立好規矩就固定)
02 | PROJECT.md

專案規格書(做什麼產品)

  • 產品藍圖:定義《今天學AI》的目標與受眾
  • 寫什麼:功能清單、前端頁面結構、後端資料表欄位、部署網址
  • 更新頻率:架構大改或上線時才更新
03 | README.md

交接聯絡簿(現在做到哪)

  • 跨對話記憶核心:給下一個 AI 對話看的交接單
  • 寫什麼:目前完成階段、下一步優先待辦(1, 2, 3)、卡住的問題
  • 更新頻率:每次結束工作(收工)必更新
階段二|立規矩、建記憶與定規格 07 / 16
PART 02 | 深入 AGENTS.md

AGENTS.md 放在哪裡?認識「專案層級 vs. 全域層級」

Rule Locations
LEVEL 01 | 專案層級(最推薦!直接請 AI 建立)

放在專案根目錄:<專案資料夾>\AGENTS.md

例如:C:\repos\learn-ai-today\AGENTS.md(或 GEMINI.md)

  • 預設沒有,要自己建:新資料夾裡不會有它,直接開口請 AI 幫你建即可
  • 自動載入與繼承:Antigravity 打開專案時會自動從目前資料夾往上層找,沿路找到的 AGENTS.md 都會自動生效!
LEVEL 02 | 全域層級(整台電腦所有專案通用)

放在個人設定區:~/.gemini/config/rules/

Windows 路徑:C:\Users\<帳號>\.gemini\config\rules\*.md

  • 為什麼預設找不到?剛裝好軟體時不會預先建立此資料夾與檔案
  • 怎麼建立?從左側邊欄 Customizations > Rules 點擊新增全域規則,或手動建一個 rules 資料夾放入 .md 檔
新手最省心做法:直接把規範寫在專案根目錄的 AGENTS.md 最直覺,未來推上 GitHub 時還能跟著專案一起備份!
階段二|立規矩、建記憶與定規格 08 / 16
PART 02 | 動手實作(1 / 2)

實作任務一:用一段話建立《今天學AI》專屬 AGENTS.md

Hands-on 01

請確保已在 C:\repos\learn-ai-today 開啟專案,點擊下方按鈕複製 Prompt 貼給 Antigravity:

PROMPT 01 | 建立《今天學AI》員工守則與開收工口令
「請幫我在專案根目錄建立一份 AGENTS.md,寫入以下專案規範:
1. 語言與協作:一律使用台灣繁體中文;解釋技術名詞請搭配『餐廳外場與廚房』比喻;改動超過 2 個檔案前先說明步驟。
2. 品牌視覺鐵律:主色深墨藍(#172e46)、強調色青綠(#216d73)、淺底(#f2f6f8);採 1px 細線方角與充足留白,禁止使用紫藍漸層。
3. 開工與收工口令:說『開工』時先讀 PROJECT.md 與 README.md 並回報下一步;說『收工』時自動把今日進度更新回 README.md。」
階段二|立規矩、建記憶與定規格 09 / 16
PART 02 | 記憶管理密技

如何讓 AI 越用越聰明?三個必學的記憶管理口令

Memory Commands
COMMAND 01 | 「開工」與「收工」

跨對話無縫交接

每次要關掉軟體或開新對話前,對 AI 說一聲「收工」,它就會把進度寫進 README.md。下次開新對話只要說「開工」,立刻接上進度!

COMMAND 02 | /compact

對話太長時的「記憶濃縮」

當同一個任務討論太久、覺得 AI 開始變慢時,輸入 /compact,AI 會自動把前面的長篇對話濃縮成精簡重點,釋放腦容量。

COMMAND 03 | /learn

把踩坑經驗變成永久記憶

當你糾正了 AI 某個錯誤(例如某個按鈕顏色總是配錯),輸入 /learn,請它把這次的教訓直接寫進規則檔,以後永遠不再犯!

階段二|立規矩、建記憶與定規格 10 / 16
PART 03 | SKILLS, MCP & PROJECT SPEC

認識 Skills 與 MCP,
並定立《今天學AI》全端規格書

搞懂「武功秘笈(Skills)」與「外接插頭(MCP / Plugins)」的差別,最後用 /plan 產出我們的網站施工藍圖。

PART 03 | 進階概念(1 / 2)

什麼是 Skills(技能)?為什麼不全部塞進 AGENTS.md?

Skills System
PROGRESSIVE DISCLOSURE

漸進式載入:平時只看書名,需要才翻開

  • 如果把「怎麼做簡報、怎麼寫 React、怎麼部署 Vercel」全部寫進 AGENTS.md,每次對話一開始就會塞爆 AI 的腦容量
  • Skills(技能)就像是放在書架上的專業 SOP 手冊(SKILL.md)
  • 平時 AI 只讀每一本手冊的「名稱與兩行簡介」,幾乎不佔記憶空間;當你說「幫我做前端網頁」時,它才自動抽下那本手冊來讀!
BUILT-IN & CUSTOM SKILLS

Antigravity 內建與自訂技能在哪裡?

  • 點開左側邊欄的 Skills & Customizations 即可查看所有已安裝技能
  • 內建技能範例:react-best-practices(前端最佳寫法)、deployments-cicd(部署專家)
  • 專案自訂技能位置:
    .agents/skills/<技能名稱>/SKILL.md(我們在階段三就會親手建一本!)
階段二|立規矩、建記憶與定規格 12 / 16
PART 03 | 進階概念(2 / 2)

什麼是 MCP 與 Plugins?幫 AI 接上外部世界的萬用插頭

MCP & Plugins
MCP | MODEL CONTEXT PROTOCOL

MCP=AI 界的「USB-C 萬用轉接頭」

  • 原本 AI 只能讀寫你電腦裡的檔案,看不到你的 Google 日曆、雲端資料庫或 Notion
  • MCP(模型上下文協定)是一套公開標準,只要在 mcp_config.json 接上某個服務的 MCP Server,AI 就立刻多出一組操作該服務的工具手腳!
PLUGINS | 一鍵安裝外掛包

Plugins=把「Skills + Rules + MCP」打包好的懶人卡

  • 新手不用自己手寫複雜的 mcp_config.json!
  • 在 Antigravity 的外掛市集(Plugins)裡,可以直接一鍵啟用 Vercel、Google Workspace、Figma 等官方外掛
  • 登入帳號授權後,AI 就能直接幫你查部署狀態、讀雲端文件!
階段二|立規矩、建記憶與定規格 13 / 16
PART 03 | 動手實作(2 / 2)

實作任務二:規劃《今天學AI》全端規格,補齊專案鐵三角

Hands-on 02

現在我們請 Antigravity 根據剛立好的 AGENTS.md,幫我們生出另外兩份核心文件(先不寫程式碼):

PROMPT 02 | 生成《今天學AI》的 PROJECT.md(規格書)與 README.md(交接檔)
「請先讀取 @AGENTS.md。我們現在處於『階段二:定立規格』,請先不要改程式碼,幫我在根目錄建立 PROJECT.md 與 README.md:
1. PROJECT.md:定義《今天學AI》為 AI 教師的知識分享與活動報名網站,包含前端四大區塊(英雄區、活動亮點、可分類篩選的 AI 教學文章區、線上報名表單)與後端報名資料庫欄位(姓名、Email、場次、職稱、提問、時間)及 /admin 教師查看名單後台。
2. README.md:記錄已完成階段一與階段二,並將下一步設為『階段三:打造高質感前端介面』。」
階段二|立規矩、建記憶與定規格 14 / 16
PART 03 | 成果驗收

現場見證奇蹟:開啟新對話,測試一聲「開工」!

Verification
STEP 01 | 檢查左側檔案樹

確認「專案鐵三角」已全數就位

learn-ai-today/ ├── AGENTS.md # 員工守則(自動生效) ├── PROJECT.md # 《今天學AI》全端規格書 ├── README.md # 跨對話進度交接聯絡簿 └── index.html # 階段一做出的單頁原型
STEP 02 | 開新對話測試記憶

點選 New Conversation,只輸入兩個字:

測試口令
開工

你會看到新對話的 AI 自動讀取三份文件,用繁體中文向你簡報《今天學AI》目前進度,並主動問你要不要開始做階段三!

階段二|立規矩、建記憶與定規格 15 / 16
WRAP UP & NEXT STAGE

階段二總結與下一階段預告

Summary
CHECK 01 | 安全選址

遠離雲端同步災難

學會將程式專案建在本機路徑(如 C:\repos\),避免套件檔塞爆雲端硬碟。

CHECK 02 | 專案鐵三角

規矩與記憶制度化

完成 AGENTS.md、PROJECT.md、README.md,打通「開工/收工」跨對話記憶。

CHECK 03 | 生態系概念

懂得分工 Skills 與 MCP

理解渐進式載入的技能手冊(Skills)與外接萬用插頭(MCP / Plugins)。

NEXT STAGE PREVIEW | 階段三預告

階段三:打造高質感前端 ── 用設計 Skill 擺脫「AI 公版廉價感」

規矩與藍圖都立好了!下一階段我們將親手建立一本品牌設計技能手冊(SKILL.md),並升級到正式的 Next.js 現代前端框架,把《今天學AI》的文章專欄與活動報名介面做得像專業設計公司的作品!