mcpField
C
claude-md-updater

claude-md-updater

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

claude-md-updater について

claude-md-updaterは、会話から長期保存に適したプロジェクト情報を特定し、指示ファイルの編集案を作成するスキルです。正確な差分を提示して承認を待ち、承認前には書き込みません。

主な機能

  1. 01長期保存するプロジェクト情報の特定
  2. 02AGENTS.mdまたはCLAUDE.mdの決定
  3. 03正確な統一差分の作成
  4. 04承認後にのみ書き込み
  5. 05秘密情報と一時メモの除外

活用シーン

  1. 01デバッグで得た継続的な知見の記録
  2. 02インフラやエンドポイント情報の更新
  3. 03再利用可能なワークフローの保存

インストール

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

$npx skills add https://github.com/jamditis/claude-skills-journalism --skill claude-md-updater

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

同梱ファイルagents/openai.yaml

詳細

プロジェクト指示ファイルの更新

現在の会話を分析し、プロジェクトの指示ファイルに保存する価値のある情報を特定してから、書き込む前に編集内容を承認用に提示してください。

下書きを作成する前に、対象ファイルを特定してください。

  1. AGENTS.md が存在する場合は、これを更新します。Claude Code で CLAUDE.md が存在しない場合は、@AGENTS.md を読み込む1行の CLAUDE.md も提案します。Claude Code が読み込むのは AGENTS.md ではなく CLAUDE.md です。
  2. CLAUDE.md だけが存在する場合は、これを更新します。
  3. 両方が存在し、いずれかがもう一方を読み込んでいる場合は、読み込まれる正規ファイルを更新します。
  4. どちらも存在しない場合は、AGENTS.md を作成します。Claude Code では、CLAUDE.md に追加する1行の読み込み指示も提案します。

確認する項目

1. 苦労して得た教訓
  • デバッグで判明した、すぐには気づかない原因
  • プラットフォームやツールの制約への回避策
  • 失敗を通して発見したアンチパターン
  • 「本当の問題は……だった」という気づき
2. 新しいインフラストラクチャ
  • 新たにデプロイしたサービス
  • 新しいエンドポイントや URL
  • 新しいファイルパスやディレクトリ
  • 新しい認証情報やトークン（参照先のみ。値は記載しない）
3. 新しいワークフロー
  • 繰り返し発生する問題を解決するコマンド
  • 効果的な複数ステップの手順
  • システム間の連携パターン
4. 更新された情報
  • 変更されたポート、IP、URL
  • 既存システムに追加された機能
  • 非推奨になった機能や削除された機能

分析手順

  1. 会話を確認し、次のキーワードを探します。

    • 「修正した」、「解決した」、「問題は……だった」、「判明した」
    • 「デプロイした」、「セットアップした」、「設定した」、「インストールした」
    • 「新しいエンドポイント」、「新しいサービス」、「新しいパス」
    • 「動作しない」、「制約」、「回避策」

  2. 見つかった情報を分類します。プロジェクトの指示ファイルに含めるのは、長期にわたって有効な情報だけです。

    • 苦労して得た教訓は「苦労して得た教訓」セクションに記載します
    • インフラストラクチャの変更は、該当するセクションを更新します
    • 新しいワークフローは、適切なセクションに追加します
    • 一時的なセッション固有のメモは、プロジェクトの指示ファイルに含めません（「保存しない情報」を参照）

  3. 正確な差分を作成します。対象として特定した指示ファイルに対する統一形式の差分を作成し、追加または変更する正確な行とセクションを示します。この差分がユーザーの承認対象であり、要約ではありません。

  4. 承認用に差分を提示し、ユーザーの承認を得るまで何も書き込みません。

出力形式

まず正確なパッチを示し、その後、カテゴリごとに短い要約を記載します。

## Proposed project instruction updates

```diff
--- a/AGENTS.md
+++ b/AGENTS.md
@@ section being changed @@
 existing context line
+new durable lesson, infra fact, or workflow
```

Summary of the diff above:
- Hard-won lessons: [one line, if any]
- Infrastructure updates: [one line, if any]
- New workflows: [one line, if any]

Apply this diff? Nothing is written until you approve.

保存しない情報

プロジェクトの指示ファイルはチームで共有され、Git にコミットされ、エージェントのセッションで読み込まれます。継続的な記録ではなく、長期にわたって有効で、頻繁には変更されない情報に使用してください。プロジェクトメモリースキルに従い、次の情報は含めないでください。

  • 一時的な「今日行った作業」のセッション要約
  • 頻繁に変わる情報
  • クライアントが修正を通じて時間とともに学習する内容

これらは、クライアントのメモリー機能（Claude Code では、 ~/.claude/projects/<project>/memory/ にある自動メモリー）または Git で無視されるローカルのメモファイル（Claude Code では CLAUDE.local.md）に保存してください。共有プロジェクト指示に含めると、コンテキストが肥大化し、古くなったセッション情報が後続のセッションで読み込まれることになります。

ルール

  1. 機密情報は決して追加しないでください。 認証情報の保存場所だけを参照し、実際のトークンは記載しないでください。
  2. 簡潔にまとめてください。 プロジェクトの指示ファイルは読みやすさを保ち、200行未満を目標にしてください。
  3. 重複を避けてください。 追加する前に、情報がすでに記載されていないか確認してください。
  4. 既存のスタイルに合わせてください。 現在のファイルの文体や形式に従ってください。
  5. 長期にわたって有効な情報のみを記載してください。 苦労して得た教訓、インフラストラクチャの情報、ワークフローを保存します。セッション固有のメモは、クライアントのメモリーまたは Git で無視されるローカルのメモファイルに保存し、コミット対象のプロジェクト指示ファイルには決して含めないでください。

コメント

Markdown 対応