第3章 規則與技能——不用搬
必讀 想跟著這個階段學下去,一定要讀這一章。一句話總結:Antigravity 把資料夾裡的
AGENTS.md當作始終開啟的規則來讀,並自己挑選.agents/skills裡的技能。在 Codex 階段做好的檔案原樣就能用。 用同一份筆記,一次把AGENTS.md拿走,一次放回去,各整理一遍,以此來確認這一點。
先來弄清兩個詞。
- 規則檔案是寫下 AI 每次在這個資料夾裡幹活時都要遵守的約定的檔案。
- 技能是把常做的事情的步驟寫下來的一組指令。
更詳細的說明在 Claude Code 第 6、7 章裡(選讀)。
本章的執行結果,是本指南用終端程式 agy 親自跑出來的。應用和 CLI 用的是同一個智慧體(第1章),所以在應用裡照著做也可以。[1]
Antigravity 會找的地方
Antigravity 會在固定的資料夾裡查詢規則和技能。[2]
| 什麼 | 這個資料夾(專案) | 我的所有資料夾 |
|---|---|---|
| 規則 | AGENTS.md·GEMINI.md·.agents/rules/ | ~/.gemini/AGENTS.md 等 |
| 技能 | .agents/skills/名稱/SKILL.md | ~/.gemini/config/skills/ |
來源:Antigravity 官方文件(只摘錄了一部分)[2:1][3][4]
名稱和位置都和 Codex 階段做好的檔案一樣。 就是規則檔案 AGENTS.md 和技能資料夾 .agents/skills。所以整理工具資料夾什麼都不用搬,直接開啟就行。
CLAUDE.md 不在規則檔案列表裡。[5] 如果有只在 Claude Code 裡用過的規則,也請寫進 AGENTS.md(和 Codex 第3章的理由相同)。
AGENTS.md 不用在檔案最前面另加設定行,直接寫就行。而且整個內容始終是開啟的(always_on)。[6] 修改過的規則和技能,從下一條訊息起立刻生效。[7]
理解檢查
Antigravity 把哪個名字當作這個資料夾的規則檔案來讀,哪項是對的?
用同一份筆記來測試
AGENTS.md 裡有 Codex 第3章加進去的規則。就是"在整理好的檔案最下面設一節「與原件核對」"。這條規則只在 AGENTS.md 裡有,所以看結果裡有沒有這一節,就能知道 AGENTS.md 有沒有被讀取。
用同一份筆記、同一個請求運行了兩次。條件相同,才能知道差別是不是 AGENTS.md 造成的。[8]
把 inbox/meeting-2026-10-27-weekly.txt 這份筆記整理成會議紀要,儲存成 notes/ 資料夾裡的新檔案。| 執行 | 「與原件核對」一節 |
|---|---|
把 AGENTS.md 拿到資料夾外面時 | 沒有 |
把 AGENTS.md 放回去之後 | 有 |
來源:本指南的實操結果(2026-11-01,各 1 次)
結果:沒有 AGENTS.md 時 · 有 AGENTS.md 時
看執行記錄,差別會更明顯。
- 沒有
AGENTS.md時:智慧體自己去找並打開了AGENTS.md、CLAUDE.md、GEMINI.md。 - 有
AGENTS.md時:沒有另外開啟那個檔案,卻遵守了新規則。看起來是因為它作為始終開啟的規則,一開始就被放進去了。
CLAUDE.md 兩次都是自己開啟讀了。 它並沒有作為規則檔案被自動放進去。這似乎意味著,只要資料夾裡有,就可以當作參考資料來讀。
不過,這個結果是各做一次得到的。而且這臺電腦上還有個人規則檔案(~/.gemini/GEMINI.md),也一起放進了執行裡。所以無法分辨讀取 CLAUDE.md 的行為是不是受它的影響。請把它看作這次實操中看到的樣子,而不是確定的規律。
還有一個日期是錯的。在有 AGENTS.md 時生成的會議紀要裡,熱紅酒成本調查的期限,寫成了 10/30(週五),而不是 10/31(週五)(筆記裡是"週五前")。即使遵守了規則那一節,日期也可能出錯。 不要因為有「與原件核對」這一節就放心,要親自核對。
詳細說明(點選展開)
- 同一份筆記,結果裡還有一處差別。Codex 把筆記裡的星期按 2026 年的日曆改了,而 Antigravity 直接用了筆記裡寫的星期(
10/27(月))。練習筆記裡的星期是為了故事編出來的,和真實日曆對不上。每個工具的這類判斷都不一樣,所以日期請始終和原件對照。
理解檢查
這份指南是怎麼測試 AGENTS.md 有沒有被讀取的,哪項是對的?
技能由它自己挑選
智慧體每次都會看技能名稱和說明(description)的列表,如果有適合這件事的技能,就讀那個技能的完整指令。[9] 所以不需要逐一告訴它要用技能;一定要它用的話,說出名稱就行。[10]
在上面的兩次執行中,我們沒有提到技能,第一個動作卻是讀取 .agents/skills/meeting-notes/SKILL.md。 它認出了 Codex 第5章裡搬過來的技能。
自己呼叫時,在應用輸入框裡輸入 /技能名稱。[11] 這和 Codex 的 $名稱 不同,和 Claude Code 的 /名稱 相同。
/weekly-review本指南在終端裡說出名稱——"用 weekly-review 技能整理這周的回顧"——來執行。智慧體讀取了 .agents/skills/weekly-review/SKILL.md,用 3 份回顧筆記做出了每週回顧。
結果:用技能做出的每週回顧
要和原始筆記對照的 8 個事實,全都在裡面。12 個贊、6,000 韓元的錯誤、4 個方案、合計 11 個、Instagram 3 次、熱紅酒 1,800 韓元、燈泡、寫文案花了 2 小時。同一個技能,Codex 做出的回顧裡漏了 3 個(Codex 第5章)。這是同樣的指令,各個工具的結果也可能不同的例子。
結果裡有好幾處 (備忘錄裡沒有) 的標記。這不是說事實錯了,而是說模板要求的"為什麼做得好"或"什麼時候做",在筆記裡沒有。除了錯的和漏的,也請看看這樣的標記貼得對不對。
理解檢查
在 Antigravity 應用裡直接呼叫 weekly-review 技能,方法是什麼?
條件規則和留下學到的東西
規則變多之後,可以按檔案拆到 .agents/rules/ 資料夾裡。這些檔案必須在最前面的設定行裡寫明什麼時候開啟(trigger)。不寫或寫錯的話,會悄悄地被丟棄。[12]
值連拼寫都必須準確。比如,始終開啟的值是用小寫字母和下劃線寫的 always_on。像 alwaysOn 這樣連著寫,它就認不出來,會丟掉。[12:1][6:1] 像整理工具這樣規則只有幾行,一個 AGENTS.md 就夠了。
規則用於"始終要遵守的事",技能用於"分多個步驟完成的工作"。[13] 比如,"日期寫成 10/27(週一) 的樣子"是規則,"把 3 份回顧筆記彙總,做出每週回顧"是技能。
想把對話中糾正過的內容留成規則或技能,就在輸入框裡輸入 /learn。智慧體會提出要修改的內容,只有我批准之後才會寫檔案。[14]
比如,假設你在對話中糾正過它:「日期寫成 10/27(週一) 的樣子」。之後輸入 /learn,智慧體就會提議把這一點留成規則。要等我讀過並批准,才會寫進檔案。
理解檢查
在 .agents/rules/ 資料夾裡建立規則檔案時,必須遵守什麼?
親手試一試
- 把整理工具資料夾作為 Antigravity 專案開啟(第2章)。什麼都不用搬。
- 讓它整理會議筆記,看看結果最下面有沒有「與原件核對」一節。
- 想更確定的話,把
AGENTS.md暫時挪到別處,用同一個請求再做一次並比較。結束後放回去。 - 用
/weekly-review做每週回顧,對照原件數一數錯的和漏的。
連續任務:第4章會把 Antigravity 的許可權預設和撤銷,與 Claude Code、Codex 做比較。
小結
- Antigravity 讀取
AGENTS.md、GEMINI.md和.agents/skills。在 Codex 裡做的檔案原樣可用。 - 用同一份筆記測試的結果:沒有
AGENTS.md是 0 → 有的時候是 1(「與原件核對」一節)。 - 技能不用說,它自己會挑選。自己呼叫時用
/技能名稱。 .agents/rules/裡的檔案一定要寫trigger。對話中學到的內容,用/learn經批准後留下來。
術語整理
| 術語 | 中文名稱 | 一句話解釋 |
|---|---|---|
| always_on | 始終開啟 | 始終處於開啟狀態的規則 |
| trigger | 觸發條件 | 決定規則什麼時候開啟的值 |
/learn | 學習命令 | 提議把對話中學到的內容留成規則、技能的命令 |
這一章讀完了嗎?
學習記錄只儲存在這個瀏覽器中。整體進度可以在 全部目錄中檢視。
下一章:第4章. 許可權與撤銷
參考資料(14 則)
本章依據 2026 年 11 月 1 日確認過的 Antigravity 官方文件,以及本指南用 Antigravity CLI
agy1.4.12 執行的結果寫成。本指南是在練習用的另一個 AI 工具裡呼叫並執行agy的。官方 FAQ 對個人方案不支援這樣的用法(第7章),所以你照著做的時候,請直接在應用或終端裡執行。 ↩︎Antigravity 官方文件,「Customization discovery」. "Workspace: the
.agents/folder in your project, plusAGENTS.mdandGEMINI.mdfiles." / "| Rules |rules/*.md,AGENTS.md,GEMINI.md|" / "| Skills |skills/<name>/SKILL.md|" antigravity.google (確認日期 2026-11-01) ↩︎Antigravity 官方文件,「Rules」. "Standalone global files (no frontmatter needed, always active):
~/.gemini/AGENTS.md,~/.gemini/GEMINI.md,~/.gemini/config/AGENTS.md, or~/.gemini/config/GEMINI.md" antigravity.google (確認日期 2026-11-01) ↩︎Antigravity 官方文件,「Customization discovery」. "To use a personal skill in both the Antigravity App and the Antigravity CLI, put it in
~/.gemini/config/skills/." antigravity.google (確認日期 2026-11-01) ↩︎Antigravity 官方文件,「Rules」. "You can place an
AGENTS.mdorGEMINI.mdfile—or a.agents/rules/directory—in your workspace folder and in any parent folder up to the repository root." antigravity.google (確認日期 2026-11-01) ↩︎Antigravity 官方文件,「Rules」. "
AGENTS.mdandGEMINI.mddo not use frontmatter. Antigravity treats its entire content as plain Markdown and keeps it continuously active (always_on)." antigravity.google (確認日期 2026-11-01) ↩︎Antigravity 官方文件,「Customization discovery」. "Antigravity rereads your rules and skills before each turn, so a new or edited file applies to your next message without a restart." antigravity.google (確認日期 2026-11-01) ↩︎
在 Codex 階段的審查中,有人指出"前後用不同的筆記,就不是嚴格的比較"。所以這次用同一份筆記運行了兩次。 ↩︎
Antigravity 官方文件,「Agent skills」. "On every turn, the agent sees a list of available skills with their names and descriptions. If a skill looks relevant to your task, the agent reads the full instructions and follows them." antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Agent skills」. "You don’t need to explicitly tell the agent to use a skill—it decides based on context. However, you can mention a skill by name if you want to ensure it’s used." antigravity.google (確認日期 2026-11-01) ↩︎
Antigravity 官方文件,「Agent skills」. "Manual slash command: Type
/<skill-name>in the message box to explicitly invoke a skill." antigravity.google (確認日期 2026-11-01) ↩︎Antigravity 官方文件,「Rules」. "Every
.mdfile insiderules/must start with YAML frontmatter declaring a validtrigger." / "If a file in.agents/rules/*.mdomits frontmatter or specifies an unrecognizedtriggervalue (such as camelCasealwaysOnormodelDecision), Antigravity silently discards the rule." antigravity.google (確認日期 2026-11-01) ↩︎Antigravity 官方文件,「Rules」. "Rule vs. Skill: Write a rule for constraints and invariants (for example, “Always use
zodfor validation” or “Never importinternal/across packages”). Write a skill for multi-step workflows (for example, “How to run database migrations”)." antigravity.google (確認日期 2026-11-01) ↩︎Antigravity 官方文件,「Slash commands overview」. "The agent proposes changes in a
learning_proposal.mdartifact and writes files only after you approve." antigravity.google (確認日期 2026-11-01) ↩︎