mcpField
R
review-claudemd

review-claudemd

github.com/ykdojoエージェントワークフロー10.3k238 回インストール5 週間前に更新
リポジトリ

review-claudemd について

Review CLAUDE.md from conversation history は、最近の会話をもとにプロジェクトの指示を見直す Claude ユーザー向けのワークフローです。グローバルとローカルの CLAUDE.md を分析し、違反、追加候補、古くなった可能性のある項目に分けて整理します。

主な機能

  1. 01最近のプロジェクト会話を特定
  2. 02会話履歴とグローバル・ローカル規則を比較
  3. 03指示違反の特定
  4. 04グローバル・ローカルの追加案
  5. 05古くなった可能性のある指針を抽出

活用シーン

  1. 01指示の見落としが続いた後のプロジェクト規則の確認
  2. 02ローカル CLAUDE.md 向けの固有パターンの発見
  3. 03強化が必要なグローバル規則の評価
  4. 04議論用の CLAUDE.md 変更案の整理

インストール

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

$npx skills add https://github.com/ykdojo/claude-code-tips --skill review-claudemd

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

詳細

会話履歴から CLAUDE.md をレビューする

最近の会話を分析し、グローバル（~/.claude/CLAUDE.md）とローカル（プロジェクト）の CLAUDE.md ファイルを改善します。

ステップ 1：会話履歴を探す

プロジェクトの会話履歴は ~/.claude/projects/ にあります。フォルダー名は、プロジェクトパスのスラッシュをハイフンに置き換えたものです。

# Find the project folder (replace / with -)
PROJECT_PATH=$(pwd | sed 's|/|-|g' | sed 's|^-||')
CONVO_DIR=~/.claude/projects/-${PROJECT_PATH}
ls -lt "$CONVO_DIR"/*.jsonl | head -20

ステップ 2：最近の会話を抽出する

現在の会話を除く、最も新しい会話を 15～20 件、一時ディレクトリに抽出します。

SCRATCH=/tmp/claudemd-review-$(date +%s)
mkdir -p "$SCRATCH"

for f in $(ls -t "$CONVO_DIR"/*.jsonl | head -20); do
  basename=$(basename "$f" .jsonl)
  # Skip current conversation if known
  cat "$f" | jq -r '
    if .type == "user" then
      "USER: " + (.message.content // "")
    elif .type == "assistant" then
      "ASSISTANT: " + ((.message.content // []) | map(select(.type == "text") | .text) | join("\n"))
    else
      empty
    end
  ' 2>/dev/null | grep -v "^ASSISTANT: $" > "$SCRATCH/${basename}.txt"
done

ls -lhS "$SCRATCH"

ステップ 3：サブエージェントを起動する

会話を分析するサブエージェントを並列に起動します。各エージェントは以下を読み込む必要があります。

  • グローバル CLAUDE.md：~/.claude/CLAUDE.md
  • ローカル CLAUDE.md：./CLAUDE.md（存在する場合）
  • 会話ファイルのバッチ

各エージェントには、以下のプロンプトテンプレートを渡します。

Read:
1. Global CLAUDE.md: ~/.claude/CLAUDE.md
2. Local CLAUDE.md: [project]/CLAUDE.md
3. Conversations: [list of files]

Analyze the conversations against BOTH CLAUDE.md files. Find:
1. Instructions that exist but were violated (need reinforcement or rewording)
2. Patterns that should be added to LOCAL CLAUDE.md (project-specific)
3. Patterns that should be added to GLOBAL CLAUDE.md (applies everywhere)
4. Anything in either file that seems outdated or unnecessary

Be specific. Output bullet points only.

会話はサイズごとにバッチ分けします。

  • 大（>100KB）：エージェント 1 人あたり 1～2 件
  • 中（10～100KB）：エージェント 1 人あたり 3～5 件
  • 小（<10KB）：エージェント 1 人あたり 5～10 件

ステップ 4：分析結果を集約する

すべてのエージェントの結果を、以下のセクションを含む要約にまとめます。

  1. 守られなかった指示 - 既存のルールのうち、従われなかったもの（より強い表現が必要です）
  2. 追加の提案 - ローカル - プロジェクト固有のパターン
  3. 追加の提案 - グローバル - あらゆる場面に当てはまるパターン
  4. 古くなっている可能性のある項目 - もはや関連性がない可能性のある項目

表または箇条書きで提示します。編集案の作成を希望するか、ユーザーに尋ねます。

コメント

Markdown 対応