mcpField
S
setup-agent-md

setup-agent-md

github.com/ismail9kエージェントワークフロー3054 回インストール1 週間前に更新
リポジトリ

setup-agent-md について

setup-agent-mdは、リポジトリ直下のAGENTS.mdをエージェント指示の正式なファイルとし、CLAUDE.mdをインポートポインターに設定するスキルです。既存ファイルとGitの状態を先に確認し、手書きの指示を移行・統合する際は承認を求めます。

主な機能

  1. 01既存の指示ファイルの確認
  2. 02変更前のGit状態の確認
  3. 03AGENTS.mdを正式な指示ファイルに設定
  4. 04CLAUDE.mdをインポートポインターとして維持
  5. 05移行・統合前の承認取得
  6. 06ファイルの再読込と最終差分の確認

活用シーン

  1. 01リポジトリでのエージェント指示の設定
  2. 02AGENTS.mdを保ちつつCLAUDE.mdのポインターを追加
  3. 03移行前に競合する指示を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ismail9k/skills --skill setup-agent-md

インストール後、Claude Code で/setup-agent-mdを入力して読み込まれたか確認します。

同梱ファイルassets/AGENTS.mdassets/CLAUDE.md

詳細

エージェント指示のセットアップ

ルート階層の AGENTS.md をリポジトリの標準指示ファイルとし、ルート階層の CLAUDE.md はそのインポートポインターとして維持します。このスキルが扱うのは、この2つのファイルのみです。イシュートラッカーや、エージェント固有のその他のファイルは設定しません。

変更する前に確認する

  1. リポジトリのルートを見つけ、既存のルート階層の AGENTS.md と CLAUDE.md があれば、全文を読みます。
  2. git status を確認し、既存の作業をセットアップによる生成物と 誤認しないようにします。
  3. 書き込みを行う前に、現在の内容と変更箇所を要約します。

手書きの内容は意図的なものとして扱います。すぐに進めてほしいという依頼があっても、内容を破棄したり、知らせずに移動したりしてよいわけではありません。

安全な対応を選ぶ

既存の状態対応
どちらのファイルも存在しない両方のアセットをそのままリポジトリのルートにコピーします。
AGENTS.md は存在するが、CLAUDE.md は存在しないAGENTS.md を維持し、CLAUDE.md のアセットをコピーします。
CLAUDE.md がすでにインポートポインターであるそのまま維持します。AGENTS.md が存在しない場合に限り、そのアセットから作成します。
CLAUDE.md に実際の指示が含まれている内容を提示し、共通の指示と真に Claude 固有の指示を分けたうえで、共通部分を移行するか、両ファイルを変更せずに残すかを尋ねます。
両方のファイルに実際の指示が含まれている重複箇所を示し、共通の指示を AGENTS.md に明示的に統合する案を提示します。ユーザーの承認を得るまで変更しません。

統合が承認された場合は、ユーザーの表現とリポジトリ固有の構成を維持します。不足している内容だけを追加し、既存の AGENTS.md を汎用テンプレートで置き換えてはいけません。

承認された移行の際に AGENTS.md が存在しない場合は、そのアセットを出発点として使い、承認された共通の指示を Project knowledge の下に配置します。移行した内容によって不要になった空のプレースホルダーヘッダーだけを削除します。Claude 固有の指示を残す必要がある場合は、その指示をユーザーがこの2つのファイル以外に保存するか、共通の指示として再分類するまで、変更を行いません。CLAUDE.md に残した指示と重複する、不完全な AGENTS.md を決して作成してはいけません。

アセット

  • assets/AGENTS.md は、存在しない AGENTS.md を作成するための完全なテンプレートです。
  • assets/CLAUDE.md は、完全なインポートポインターファイルです。

該当するアセットを読み、そのままコピーします。移行を伴わずにファイルを作成する場合、記憶を頼りにどちらかのファイルを再構成してはいけません。承認された移行では、前述のとおり、保持するユーザーの内容を AGENTS.md のテンプレートに追加できます。このテンプレートには、意図的にイシュートラッカー、計画、デリバリーのワークフローは含まれていません。これらは後から別のスキルで追加できます。

完了時

最終的な AGENTS.md と CLAUDE.md を読み返し、差分を確認します。承認された指示が抜けておらず、重複していないことを確認します。その後、作成、統合、変更せずに維持したファイル、およびユーザーの判断に委ねるために意図的に残したファイルを報告します。指示ファイルのセットアップが終わったら、別のセットアップやワークフローのスキルは呼び出さずに終了します。

やってはいけないこと

  • 手書きの指示を、提示して明示的な承認を得ることなく、上書きまたは削除しないでください。
  • 同じ指示を複数のエージェント固有ファイルにコピーしないでください。
  • .cursor/、.cursorrules、その他のツール固有ファイルを編集しないでください。これらはこのスキルの対象外です。
  • docs/agents/issue-tracker.md を作成したり、意図表明から PR までのワークフローを追加したりしないでください。
  • テンプレートの空のセクションに、コマンド、規約、アーキテクチャに関する説明、プロジェクトの事実を捏造して記入しないでください。
  • インポートポインターのパターンのほうが整って見える場合でも、既存の CLAUDE.md を黙って置き換えないでください。

コメント

Markdown 対応