3章. ルールとスキル — 移さなくてもいい
必須 この段階を進めるなら、必ず読んでください。一言まとめ: Antigravityは、フォルダの
AGENTS.mdを常にオンのルールとして読み、.agents/skillsのスキルを自分で選びます。Codexの段階で作ったファイルが そのまま 通用します。 同じメモで、AGENTS.mdをどけたまま1回、戻してからもう1回整理させて、これを確かめます。
まず、2つの言葉を確認しておきましょう。
- ルールファイル は、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 が読まれたかがわかります。
同じメモ、同じ依頼 で2回実行しました。条件が同じでないと、違いが 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 は、どちらの回も 自分で開いて読みました。 ルールファイルとして自動的に入ったわけではありません。フォルダにあれば参考資料として読める、という意味だと思われます。
ただし、この結果は それぞれ1回ずつ試したもの です。また、このパソコンには個人のルールファイル(~/.gemini/GEMINI.md)もあり、実行に一緒に入っていました。そのため、CLAUDE.md を読んだ動きがその影響かどうかは見分けられません。確かなルールというより、この実習で見えた様子として読んでください。
間違った日付もひとつありました。AGENTS.md があるときに作った議事録では、ヴァンショーの原価調査の期限が 10/31(金) ではなく 10/30(金) と書かれていました(メモは「金曜まで」)。ルールの節を守っていても、日付は間違えることがあります。「원본과 대조할 것」(元のメモと照らし合わせること)の節があるからと安心せず、自分で照らし合わせてください。
詳しく(クリックして開く)
- 同じメモなのに、結果にもうひとつ違いがありました。Codexはメモの曜日を2026年のカレンダーに合わせて直しましたが、Antigravityはメモに書かれた曜日(
10/27(月))をそのまま使いました。練習用メモの曜日は話のために作ったもので、実際のカレンダーとは合いません。ツールによってこうした判断が違うので、日付は常に元のメモと照らし合わせてください。
理解度チェック
このガイドが AGENTS.md が読まれるかを試した方法として正しいものはどれでしょうか?
スキルは自分で選ぶ
エージェントは毎回、スキルの名前と説明(description)の一覧を見て、仕事に合うスキルがあれば、そのスキルの全体の指示を読みます。[9] だから、スキルを使うよう毎回言う必要はなく、必ず使わせたいときは名前を言えばOKです。[10]
上の2回の実行では、スキルの話をしていないのに、最初の動作が .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個、インスタ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の段階のレビューで、「前と後で別のメモを使うと、厳密な比較にならない」という指摘を受けました。そこで今回は、同じメモで2回実行しました。 ↩︎
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) ↩︎