mcpField
A
agents-md-improver

agents-md-improver

github.com/ericmjlエージェントワークフロー4135 回インストール5 日前に更新
リポジトリ

agents-md-improver について

agents-md-improver は、ユーザーの修正指示をリポジトリ向けルールの提案に変えるコーディングエージェント用スキルです。関連ファイルを確認し、編集前に承認を求めながら `AGENTS.md` のパッチを作成します。

主な機能

  1. 01修正指示を継続的なルールに変換
  2. 02指示ファイルの矛盾を確認
  3. 03`AGENTS.md` への統合パッチを作成
  4. 04編集前に承認を要求

活用シーン

  1. 01コーディングエージェントの新しいルールを記録
  2. 02リポジトリ内の指示を統合・整理
  3. 03重複または矛盾する指示を解消

インストール

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

$npx skills add https://github.com/ericmjl/skills --skill agents-md-improver

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

詳細

AGENTS.md 改善ツール

このスキルは、リポジトリの指示を正確で一貫した状態に保つのに役立ちます。ユーザーがコーディングエージェントの動作を修正した場合、それをリポジトリの指示ファイルを更新する機会と捉え、AGENTS.md にすっきり統合した変更を提案します。

使用方法

次の場合はいつでも、このスキルを使用します。

  • ユーザーがエージェントの動作を修正した場合（「X はしないでください」「代わりに Y をしてください」「今後は……」「……を覚えておいてください」「……というルールを追加してください」など）。
  • AGENTS.md、CLAUDE.md、.claude/CLAUDE.md、GEMINI.md などの指示ファイルの更新、またはそれらの整合や統合をユーザーが依頼した場合。
  • リポジトリの指示ファイル間に矛盾、重複、乖離があることにユーザーが気づいた場合。

要件

  • AGENTS.md を読み取り、編集するためのリポジトリ内ファイルへのアクセス。
  • リポジトリ内に存在する場合、CLAUDE.md や .claude/CLAUDE.md への読み取りアクセス。

このスキルで行うこと

  • ユーザーの修正を AGENTS.md に自然に反映するパッチを提案します。
  • 矛盾を探し、提案の中で解決します（必要な場合は確認を求めます）。
  • リポジトリ内に CLAUDE.md または .claude/CLAUDE.md がある場合は、指示を AGENTS.md に統合する案を提案し、その後、該当ファイルを削除、シンボリックリンク化、またはスタブ化する選択肢を提示します。

動作の仕組み

対象範囲

このスキルの対象は、リポジトリ固有のものに限られます。

  • リポジトリ内にある次の指示ファイルのみを対象とします。
    • AGENTS.md
    • CLAUDE.md（リポジトリのルート）
    • .claude/CLAUDE.md
    • GEMINI.md（リポジトリのルートおよび／またはリポジトリ内のサブディレクトリ）
  • システム全体の指示や、ユーザーのホームディレクトリ内のファイル（例：~/.claude/、~/.gemini/、~/.config/ など）は対象外とします。
提案を先に行うワークフロー（自動編集しない）
  1. AGENTS.md を読みます。
  2. ユーザーの修正を特定し、リポジトリ固有の永続的な指示に変換します。
  3. 指示を記載する場所を決めます。
    • 関連する既存のセクションを編集することを優先します。
    • まったく新しいトピックである場合は、関連する内容の近くに新しい ## セクションを設ける案を提案します。
  4. 変更するテキストを、小さなパッチまたはスニペットとして正確に作成します。
  5. 適用前に確認を求めます。
    • 「これらの変更を AGENTS.md に適用しますか？（y/n）」

ユーザーが確認した後にのみ、編集を適用します。

自然に統合するためのルール
  • 「YYYY-MM-DD: 修正」のような日付付きの変更履歴を追加しないでください。
  • 既存の文章や箇条書き、手順を更新し、そのルールが最初から文書に含まれていたような形にします。
  • 周囲の AGENTS.md のスタイルに書式を合わせます。
矛盾の確認

パッチを提案する前に、次の作業を行います。

  1. AGENTS.md を調べ、新しい修正と矛盾する箇所がないか確認します。
  2. 矛盾がある場合は、矛盾する行を書き換えるか削除し、提案するパッチに解決内容を含めます。
  3. 解決方法が曖昧な場合は、パッチの提案前に、対象を絞った質問を1つだけします。

次に、リポジトリ内のガイダンス（存在する場合）を調べます。

  • AGENTS.md と CLAUDE.md、.claude/CLAUDE.md を比較します。
  • 重複や矛盾を明示します。
  • 正式な情報源として AGENTS.md に統合することを優先します。
CLAUDE.md ファイルの統合手順（存在する場合）

リポジトリ内に CLAUDE.md または .claude/CLAUDE.md がある場合：

  1. AGENTS.md に統合するパッチを提案します。
  2. ユーザーが AGENTS.md のパッチを承認した後、各 CLAUDE ファイルについて、次にどうするかを提案します。
    • ファイルを削除する。
    • AGENTS.md を指すシンボリックリンクに置き換える。
    • 人やツールに AGENTS.md を参照するよう案内する短いスタブに置き換える（シンボリックリンクが望ましくない場合の代替策）。
  3. 削除などの破壊的な操作については、別途確認を求めます。

シンボリックリンクの向き（選択した場合）：

  • CLAUDE.md -> AGENTS.md
  • .claude/CLAUDE.md -> ../AGENTS.md
複数の指示がある環境での注意事項

一部のハーネスでは複数の指示ソースが統合され、競合するルールが非決定的に適用されることがあります。単一の正式な情報源（AGENTS.md）を優先し、統合と削除、シンボリックリンク化、またはスタブ化によって、並行する指示ファイルを減らします。

コメント

Markdown 対応