agents-md-generator

AGENTS.md ジェネレーター

エージェントの動作に実質的な影響を与える、検証済みのプロジェクト情報を含む簡潔な指示レイヤーを作成します。一般的なエンジニアリング知識は、常時読み込まれる指示には含めません。

委任

デフォルトではメインの会話で実行します。委任によって使用量が増える場合があります。サブエージェントを使う前に、提案するエージェントの数と範囲について明示的な承認を得てください。承認された範囲内ではその承認を再利用できますが、承認済みの数または範囲を拡大する前には、改めて確認してください。

指示チェーンを確認する

編集する前に、既存の指示、その所有者、スコープ、シンボリックリンクを確認します。AGENTS.md が CLAUDE.md を指すなど、機能している共有ソースは維持してください。好みのファイル名を優先するためだけに置き換えてはいけません。互換性ファイルを追加するのは、要求されたツールのサポートに必要な場合に限ります。リポジトリの指示を扱う作業では、グローバルなユーザー設定は対象外としてください。

不慣れなリポジトリや複数のツールを使うリポジトリでは、同梱の検出ツールで指示ファイルのパスや、宣言されているフレームワーク／ツールのシグナルを特定できます。

"<skill-directory>/scripts/detect-agent-context" --root "<repository-root>" --format json

Windows では、同じ引数を指定して scripts/detect-agent-context.cmd を使用します。Python は JSON を出力します。ネイティブの Bash／PowerShell フォールバックは、より簡潔なテキストレポートを出力します。スクリプトは対象プロジェクトではなく、このスキルを基準に解決してください。対象が明確で編集範囲が狭い場合は、ファイルを直接確認すれば十分です。

検出ツールは、認証情報、環境ファイル、指示の内容を読み取らずに、選択した公開マニフェストと指示／設定ファイルのパスを索引化します。これはあくまで索引として扱ってください。適用される指示を読み、保存するコマンドはその出典で確認してください。グローバルなパスを含めるのは、その調査が許可されており、関連性がある場合に限ります。

検出ツールの詳細は discovery.md を参照してください。読み込み順序やサポートされるツールの動作が出力に影響する場合は、tool-compatibility.md を参照してください。

長期的に有効なルールを選ぶ

一般的ではなく、プロジェクトの根拠に裏付けられ、複数のタスクで役立ち、具体的に従えるルールを残します。適切な候補には、正確なコマンドランナー、生成ファイルの所有者、特殊なビジネス上の境界、必須のチェック、リポジトリ固有のデプロイまたは承認上の制約などがあります。

一般的な助言、ペルソナ、重複したルール、古いコマンド、網羅的な一覧、必須の質問票、根拠のないスコア、手順、現在のプロジェクト方針と矛盾するものは削除するか、書き直します。実際の権限の境界を説明し、新たな承認条件を作り出したり、明示された条件を弱めたりしてはいけません。

詳細な設計、API、テスト、デプロイに関するガイダンスは、既存の管理元に残し、明確な参照条件を付けてリンクします。シークレット、ホームディレクトリのパス、プロンプトの記録、タスクログ、グローバルなツール一覧は除外してください。

作成または整合

デフォルトでは、簡潔な共有指示ソースを1つ使用します。対象ツールがサポートする明確なスコープの違いがある場合は、親のルールを繰り返さずに、階層化されたファイルを使用します。Codex では、構成を提案する前に、同じディレクトリにある AGENTS.override.md の優先順位を確認してください。Claude との互換性が求められる場合は、インポートまたは既存のシンボリックリンクを使うことで、ルールの重複を避けられます。

output-template.md は、候補を選ぶためのメニューとして使用してください。既存の内容を「維持」「更新」「移動」「削除」「未解決」に分類し、根拠となる情報から事実を確認します。ユーザーの判断が必要な競合についてのみ質問してください。既存ファイルの統合については、merge-and-verify.md を参照してください。

ルートファイルはおおむね80～150行、スコープを限定したファイルはそれより短くすることを目安とし、目標値に合わせるために内容を水増ししないでください。ルートファイルが200行または16 KiBを超える場合は、重複や配置が不適切な詳細がないか確認してください。正当な要件は維持しつつ、対象ツールの実際の読み込み上限を守ります。編集を避けるためだけにグローバルなコンテキスト上限を引き上げてはいけません。

復旧には追跡対象の差分を使用してください。失われる可能性のある未追跡の内容は維持します。通常のバックアップコピーを作成したり、履歴を変更したり、指示の生成だけを目的としてツール設定のディレクトリ全体を無視したりしてはいけません。

検証

引用されたパスとコマンド、適用範囲と優先順位、シンボリックリンク、ルールの重複、未解決のプレースホルダーを確認します。行数とバイト数を測定し、関連する指示チェーンが対象のツールに収まることを確認します。該当する場合は、リポジトリのバリデーターを実行します。コマンドを静的に確認しただけでは、実行したことにはなりません。つづりを確認するために、破壊的なコマンドを実行してはいけません。

維持、変更、移動、削除した重要なルール、根拠として使用した情報、未解決の競合を報告します。ユーザーから求められていない限り、個別の調査レポートは作成しないでください。