ai-context について
AI コーディングアシスタント向けに、リポジトリ文書の作成と保守方法を示すガイドです。常時読み込む簡潔な情報と、タスクごとに参照する詳細なスキルを分けます。
主な機能
- 01AGENTS.md と CLAUDE.md の指針
- 02オンデマンドのスキル構成
- 03パッケージ・フォルダー別の情報
- 04文書の保守ルール
活用シーン
- 01コーディングアシスタント用のリポジトリ情報の整備
- 02タスク別スキルの作成や改訂
- 03Agent 文書の簡潔さと最新状態の維持
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/ai-contextを入力して読み込まれたか確認します。
詳細
AI コンテキストドキュメント
AI コーディングエージェントが参照する構造化ドキュメントの作成方法と保守方法について説明します。
ファイル階層
AGENTS.md # Root context — always loaded by agents
CLAUDE.md # Required for Claude Code (loads AGENTS.md)
.github/skills/<topic>/SKILL.md # On-demand detailed context
packages/<name>/AGENTS.md # Package-specific context
<any-folder>/AGENTS.md # Folder-specific context
ルートファイル
AGENTS.md
すべての対話で常に読み込まれます。トークンを節約するために最小限に保ってください。
含める必要があるもの:
- プロジェクトの一行説明
- 必須コマンド（実行、テスト、ビルド）
- リポジトリ構造の概要（トップレベルのディレクトリのみ）
- 各
SKILL.mdにリンクするスキル索引テーブル - 一般的なタスクの主要なエントリポイント
含めてはいけないもの:
- 詳細な説明（スキルに記述してください）
- 一行を超えるコード例
- スキルからの内容の重複
CLAUDE.md
Claude Code は AGENTS.md をネイティブに読み込まないため、このファイルが必要です。Claude Code を同じコンテキストシステムに橋渡しします。内容:
Read [AGENTS.md](AGENTS.md) before starting any task.
## Skills
Load these for detailed context on specific topics:
| Skill | When to use |
|-------|-------------|
| [<name>](.github/skills/<name>/SKILL.md) | <description> |
AGENTS.md のスキルテーブルと同期を保ってください。
スキル
スキルの作成
.github/skills/<topic>/SKILL.mdを作成しますnameとdescriptionを含む YAML フロントマターを追加しますAGENTS.mdとCLAUDE.mdの両方のスキルテーブルにエントリを追加します
SKILL.md の形式
---
name: <topic>
description: <when an agent should load this — be specific about triggers>
---
# <Title>
<One-line summary.>
## <Sections organized by task>
記述ガイドライン
- フロントマターの
description: トリガーとして記述します — どのタスクや質問がエージェントにこのスキルを読み込ませるべきかを示します - 簡潔に: 文章よりもテーブルを、説明よりもコードスニペットを使用します
- 具体的に: ファイルパス、コマンド名、関数シグネチャ — 曖昧な説明ではなく
- 重複しない: 情報が別のスキルに存在する場合は、繰り返さずに参照します
- 実行可能な構造: アーキテクチャではなく、エージェントが何をする必要があるかで整理します
パッケージとフォルダのコンテキスト
パッケージやフォルダ内に AGENTS.md を追加するのは、次の場合です:
- ディレクトリにエージェントが繰り返し間違える自明でない規約がある場合
- ルートドキュメントでカバーされていないローカルコマンド、パターン、注意点がある場合
これらのファイルは非常に短く保ってください — 数行のコンテキストで十分なことがよくあります。
更新のタイミング
| トリガー | アクション |
|---|---|
| エージェントが特定のトピックについて繰り返し質問する | 新しいスキルを作成する |
| ドキュメントがあるのにエージェントが間違える | 関連するスキルを改良する |
| 独自のパターンを持つ新しいパッケージ/ディレクトリ | ローカルの AGENTS.md を追加する |
| アーキテクチャやツールが変更される | 影響を受けるスキルを更新する |
| スキルが大きくなりすぎる | 複数のスキルに分割する |
| スキルテーブルが変更される | AGENTS.md と CLAUDE.md の両方を更新する |
原則
- トークン予算: ルートファイルは小さく保ち、詳細はスキルに記述します
- オンデマンド読み込み: スキルはタスクに関連する場合にのみ読み込まれます
- 生きたドキュメント: パターンが変わったら更新します — 古いドキュメントは何もないより悪いです
- クロスプラットフォーム:
AGENTS.md+.github/skills/が共有の規約です。CLAUDE.mdはAGENTS.mdをネイティブに読み込まない Claude Code を橋渡しします
コメント
Markdown 対応