Communityコーディング&開発github.com

johnpapa/ai-ready

リポジトリを分析し、AGENTS.md、copilot-instructions、スキル、CI、課題テンプレートなど、AI対応の設定を生成するCopilot CLIプラグインです。

ai-ready とは?

johnpapa/ai-readyは、リポジトリの内容を自動的に分析し、AIエージェント(Copilot、Claude Code、Cursorなど)が効率的に作業できるように設定ファイルを生成するCopilot CLIプラグインです。このスキルは、AGENTS.mdやcopilot-instructions、スキル定義、CI設定、Issueテンプレートなど、AIがプロジェクトを理解して適切に行動するために必要な構成を一度に作成します。Github CLI(gh)の拡張として動作し、リポジトリのルートで`gh ai-ready`コマンドを実行するだけで使えます。生成されるファイルは、AIエージェントに対してプロジェクトのルール、アーキテクチャ、コーディング規約、ワークフローを明確に指示するため、AI支援開発の導入を劇的に簡略化できます。特に、AIエージェントを活用した開発環境を整備したいチームや、リポジトリのAIフレンドリー化を効率化したい開発者にとって有用です。

対応~Claude Code~Codex CLI~Cursor
npx skills add johnpapa/ai-ready

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ai-ready は何をしますか?

リポジトリを分析し、AGENTS.md、copilot-instructions、スキル、CI、課題テンプレートなど、AI対応の設定を生成するCopilot CLIプラグインです。

概要

johnpapa/ai-readyは、GitHub CLI(gh)の拡張機能として動作し、リポジトリをスキャンしてAIエージェント(Copilot、Claude Code、Cursorなど)がプロジェクトを即座に理解し始められるように、以下のようなファイルを自動生成します:

  • AGENTS.md - AIエージェント向けのプロジェクト概要と指示
  • .github/copilot-instructions.md - GitHub Copilot向けのカスタム指示
  • スキル定義ファイル(.vscode/skills.jsonなど)
  • CI設定(.github/workflows/)
  • Issue / PRテンプレート

インストール

gh extension install johnpapa/ai-ready

使い方

リポジトリのルートディレクトリで以下のコマンドを実行します:

gh ai-ready

すると、リポジトリの構造、使用言語、依存関係などを自動分析し、AI対応ファイルを生成します。

オプション

オプション説明
--dry-run実際にファイルを作成せずに、生成される内容をプレビュー
--force既存ファイルを上書き
--output-dir <path>出力先ディレクトリを指定(デフォルト: カレントディレクトリ)

生成されるファイル

  • AGENTS.md — AIエージェントがプロジェクトの全体像を把握するためのMarkdownドキュメント
  • .github/copilot-instructions.md — GitHub Copilotへのコード補完時の指示
  • .github/ISSUE_TEMPLATE/ — 課題テンプレート
  • .github/PULL_REQUEST_TEMPLATE.md — プルリクエストテンプレート
  • CIワークフローファイル

詳細

詳しくは公式リポジトリを参照してください。

関連スキル