메뉴
AIコーディングエージェント向けの指示書「AGENTS.md」を作成するスキル。プロジェクトにAIエージェントが作業するための文脈と指示を集約するファイルを作成したい場合に使用します。「AGENTS.mdを作成」「AIエージェント用の指示書を作る」「エージェント向けREADMEを作成」などのリクエストでトリガーします。OpenAI Codex、Claude Code、GitHub Copilot、Cursorなど、複数のAIエージェントで共通利用できるオープンな標準フォーマットです。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | agents-md-creator |
| description | AIコーディングエージェント向けの指示書「AGENTS.md」を作成するスキル。プロジェクトにAIエージェントが作業するための文脈と指示を集約するファイルを作成したい場合に使用します。「AGENTS.mdを作成」「AIエージェント用の指示書を作る」「エージェント向けREADMEを作成」などのリクエストでトリガーします。OpenAI Codex、Claude Code、GitHub Copilot、Cursorなど、複数のAIエージェントで共通利用できるオープンな標準フォーマットです。 |
このスキルは、AI コーディングエージェント向けの指示書「AGENTS.md」の作成をサポートします。
AGENTS.md は、AI エージェント専用の「エージェント用 README」として機能するファイルです。人間向けの README.md とは別に、AI がプロジェクトを理解し、適切にコードを書いたりテストしたりするために必要な文脈と指示を集約します。
AGENTS.md を作成する前に、以下の情報を収集：
プロジェクトの性質に応じて、以下から必要なセクションを選択：
| セクション | 説明 | 優先度 |
|---|---|---|
| プロジェクト概要 | 目的と全体像 | 高 |
| セットアップ・ビルドコマンド | 依存関係のインストール、開発サーバー起動 | 高 |
| テスト手順 | テスト実行方法、フォーカス方法 | 高 |
| コードスタイル・規約 | 言語設定、フォーマット規則、関数パターン | 中 |
| PR・コミット規定 | PR タイトル形式、コミット前チェック | 中 |
| 環境固有のチップス | ディレクトリ構造、パッケージ管理のコツ | 低 |
| セキュリティ上の注意 | セキュリティ考慮事項 | 必要時 |
# AGENTS.md
## プロジェクト概要
[プロジェクトの目的と全体像を簡潔に記述]
## セットアップ
[依存関係のインストール方法]
[開発サーバーの起動方法]
## ビルド
[ビルドコマンドと手順]
## テスト
[テストの実行方法]
[特定のテストへのフォーカス方法]
## コードスタイル
[使用する言語設定]
[フォーマット規則]
[命名規則]
## PR・コミット規定
[PR タイトルの形式]
[コミット前に行うべきチェック]
## ディレクトリ構造
[重要なディレクトリの説明]
## 注意事項
[セキュリティ上の注意]
[その他の重要な考慮事項]
AGENTS.md を配置具体的なコマンドを記載: AI が直接実行できる形式で
✓ pnpm install && pnpm dev
✗ 依存関係をインストールしてください
新しいチームメイトに伝えるべきこと: 暗黙知を明文化する
人間用ドキュメントとの分離: ビルド手順の詳細など、人間には冗長な情報は AGENTS.md へ
# AGENTS.md
## プロジェクト概要
[プロジェクトの説明]
## セットアップ
pnpm install
## 開発サーバー
pnpm dev
## ビルド
pnpm build
## テスト
pnpm test
# 特定のテストを実行
pnpm test -- --grep "test name"
## コードスタイル
- TypeScript strict mode 使用
- セミコロンなし
- シングルクォート使用
- インデント: 2 スペース
## リント
pnpm lint
pnpm lint:fix
## PR 規定
- タイトル形式: `[type]: description`
- コミット前に `pnpm lint && pnpm test` を実行
# AGENTS.md
## プロジェクト概要
[プロジェクトの説明]
## セットアップ
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
## テスト
pytest
# 特定のテストを実行
pytest tests/test_module.py -k "test_name"
## コードスタイル
- Python 3.10+
- Black でフォーマット
- isort でインポート整理
- mypy で型チェック
## リント
black .
isort .
mypy src/
## PR 規定
- コミット前に `black . && isort . && pytest` を実行
# AGENTS.md
## プロジェクト概要
[プロジェクトの説明]
## セットアップ
go mod download
## ビルド
go build ./...
## テスト
go test ./...
# 特定のテストを実行
go test ./... -run TestName
## コードスタイル
- gofmt でフォーマット
- golint でリント
- Go 1.21+
## リント
go fmt ./...
golint ./...
go vet ./...
すべての情報が最初から提供されていない場合は、ユーザーに質問して情報を収集します。
一度に多くの質問をせず、最も重要な情報から段階的に収集してください。
ローカルサーバーで起動している Marp スライドを視覚的に検証し、レイアウト問題を自動修正するスキル。「スライドをレビュー」「Marp スライドの視覚的チェック」「スライドのレイアウトを確認」「プレゼン資料の見た目を検証」などのリクエストでトリガーします。テキストの切れ目、重なり、配置問題、コントラスト不足、はみ出し、余白不足などの視覚的問題を検出・修正します。
PRDと機能設計書に基づいてアーキテクチャ設計書を作成するスキル。docs/prd.md と docs/functional-design.md が存在する場合に、テクノロジースタック、レイヤードアーキテクチャ、データ永続化戦略、パフォーマンス要件、セキュリティ設計等を含むアーキテクチャ設計書を作成します。「アーキテクチャ設計書を作成して」「技術仕様書を書いて」「architecture design を作って」等のリクエストで使用してください。
コードレビューを実施するためのスキル。ユーザーがコードの品質、セキュリティ、テスト、パフォーマンス、アーキテクチャの観点からコードレビューを依頼した場合に使用します。「コードレビュー」「コードをチェック」「PRをレビュー」「このコードを確認して」などのコードレビュータスクに言及した場合にトリガーします。セキュリティ脆弱性、ロジックエラー、テスト品質、パフォーマンス問題を優先順位付けして指摘し、具体的な改善提案を行います。
ドキュメントレビューを実施するためのスキル。提案書、設計書、PRD、技術仕様書などのドキュメントをレビューする際に使用します。「ドキュメントをレビュー」「提案書をチェック」「設計書を確認」「この文書をレビューして」「ドキュメントの品質を確認」などのドキュメントレビュータスクに言及した場合にトリガーします。ビジネス・戦略観点、論理構造、技術的妥当性、リスク管理、表現の正確性を多角的に評価し、建設的な改善提案を行います。
ドキュメント執筆をサポートするスキル。ユーザーがPRDに基づいてドキュメントを作成、編集、または更新したい場合に使用します。このスキルは、docs/prd.md に記載されたプロダクト要求仕様書を参照しながら、技術ドキュメント、設計ドキュメント、ユーザーガイド、APIドキュメントなどの執筆を支援します。「ドキュメントを書く」「仕様書を作成」「ガイドを作る」などのドキュメント作成タスクに言及した場合にトリガーします。
PRDに基づいて機能設計書を作成するスキル。docs/prd.md が存在する場合に、システム構成、データモデル、コンポーネント設計、アルゴリズム設計等を含む機能設計書を作成します。「機能設計書を作成して」「PRDから設計書を作って」「functional design を書いて」等のリクエストで使用してください。