コーディングエージェント¶
コードの読み書きやコマンドの実行を AI に任せる、コーディングエージェントについてのメモ。 ツールごとのページ:
機能¶
多くのコーディングエージェントに共通する機能について、一部を取り上げる。
- ルール: エージェントに守らせる指示。ファイルごとに「どの作業のときに読み込むか」を決められる。
- スキル: 特定の作業の手順書。
SKILL.mdの説明(description)で、使うべき場面が判断され、必要になったときに本文が読み込まれる。
製品によって読み込むパスが異なる。以下は、プロジェクトルートからの相対パスである。
| 種類 | Claude Code | Antigravity |
|---|---|---|
| ルール | .claude/rules/*.md(フロントマターの paths) |
.agents/rules/*.md(フロントマターの trigger) |
| スキル | .claude/skills/<name>/SKILL.md |
.agents/skills/<name>/SKILL.md |
詳細は、各ツールのページを参照。
複数のツールで共通のコンテンツを使う¶
同じリポジトリを、複数のツールで扱うときは、実体を1か所にまとめて、各ツールのディレクトリから参照する方法がある。
- スキル: どちらのツールも
SKILL.md(フロントマターのnameとdescription)なので、実体のディレクトリへのシンボリックリンクで足りる。スキルごとにリンクを作る。実体は、プロジェクト直下のskills/に置く例が、よく見られる。 - ルール: 共通のルールの、標準的な置き方は、2026-11-21 時点では把握できていない。フロントマターの書式がツールごとに違うので、シンボリックリンクにはできない。方法の1つは、各ツールのディレクトリ(
.claude/rules/、.agents/rules/)に、それぞれの書式のフロントマターと、実体への相対パスの参照だけを書いた実ファイルを置くこと。
このリポジトリの例¶
このリポジトリ(tech-notes)では、ルールとスキルの実体を、agent/ にまとめている。これは、このリポジトリ独自の置き方で、標準的なものではない。
agent/rules/ ルールの実体
agent/skills/ スキルの実体
.claude/rules/ Claude Code 用のルールファイル(フロントマターと、実体への参照)
.agents/rules/ Antigravity 用のルールファイル(同上)
.claude/skills/ agent/skills/ の各スキルへのシンボリックリンク
.agents/skills/ 同上
Note
実体の内容を変えたときに、ルールの実ファイルを直す必要はない。ただし、適用の範囲(どのファイルを扱うときに読み込むか)を変えるときは、両方のツールの実ファイルを直す。