Memory Audit スキル

現在のメモリ構成を監査し、最適化ポイントを特定する知識を提供。

Instructions

このスキルはメモリ構成の監査方法と評価基準を説明します。

監査項目

1. ファイル存在チェック

2. サイズチェック

3. 構成チェック

• プロジェクト概要が記載されている
• 技術スタックが明記されている
• 開発コマンドが記載されている
• 冗長な内容がない
• 秘密情報が含まれていない

監査手順

Step 1: 現状把握

# メモリのロード状態確認
/memory

# CLAUDE.md のサイズ確認
wc -l CLAUDE.md

# rules フォルダの確認
ls -la .claude/rules/ 2>/dev/null || echo "rules フォルダなし"

Step 2: 内容分析

CLAUDE.md の各セクションを確認:

□ 概要セクションの有無と適切さ
□ 技術スタックの完全性
□ コマンド一覧の正確さ
□ ルールの具体性
□ 不要な内容の有無

Step 3: 最適化ポイント特定

以下をチェック:

評価基準

健全性スコア

評価項目

1. サイズ効率（25点）
   - CLAUDE.md が 300行以下: 25点
   - 300-500行: 15点
   - 500行超: 5点

2. 構成（25点）
   - 必須項目が揃っている: 15点
   - rules を適切に活用: 10点

3. 具体性（25点）
   - 具体的なコマンド記載: 10点
   - 具体的なルール記載: 15点

4. 保守性（25点）
   - 更新しやすい構成: 15点
   - 重複なし: 10点

監査レポート形式

テンプレート

# メモリ監査レポート

## 概要

- 監査日: YYYY-MM-DD
- 対象: プロジェクト名
- 評価: A/B/C/D

## ファイル構成

| ファイル | 行数 | 状態 |
|---------|------|------|
| CLAUDE.md | XXX | 〇/△/× |
| .claude/rules/ | X files | 〇/△/× |

## 発見事項

### 良い点
- ...

### 改善点
- ...

## 推奨アクション

1. 優先度高: ...
2. 優先度中: ...
3. 優先度低: ...

よくある問題と対策

問題1: CLAUDE.md の肥大化

症状: 500行を超える CLAUDE.md

対策:

1. セクションごとに行数を確認
2. 50行超のセクションを特定
3. rules フォルダに段階的に移行

問題2: 情報の重複

症状: 同じ内容が複数箇所に記載

対策:

1. 重複箇所を特定
2. 正規の場所を決定
3. 他の箇所は参照に変更

問題3: 古い情報

症状: 現状と異なる記述

対策:

1. 定期的なレビュー実施
2. 自動化（CI/CD でチェック）
3. 更新ルールの策定

問題4: 抽象的すぎる

症状: 「良いコードを書く」のような曖昧な記述

対策:

1. 具体的なルールに書き換え
2. 例を追加
3. チェックリスト形式に変更

自動監査スクリプト例

#!/bin/bash
# memory-audit.sh

echo "=== メモリ監査 ==="

# CLAUDE.md チェック
if [ -f "CLAUDE.md" ]; then
    lines=$(wc -l < CLAUDE.md)
    echo "CLAUDE.md: $lines 行"
    if [ $lines -gt 300 ]; then
        echo "  ⚠️ 300行超 - 分離を検討"
    fi
else
    echo "CLAUDE.md: なし"
fi

# rules チェック
if [ -d ".claude/rules" ]; then
    count=$(ls -1 .claude/rules/*.md 2>/dev/null | wc -l)
    echo "rules ファイル数: $count"
else
    echo "rules フォルダ: なし"
fi

echo "=== 完了 ==="

Examples

簡易監査

Q: 今のメモリ構成をチェックして
A: /memory コマンドでロード状態を確認し、CLAUDE.md のサイズと内容を分析します。

詳細監査

Q: メモリを詳しく監査してレポートを作成して
A: ファイル構成、サイズ、内容を分析し、改善点と推奨アクションを含むレポートを作成します。