ファイル操作

Claude のネイティブツールを使用してファイルを分析し、メタデータを取得します。ファイルは修正されません。

使用場面

• "analyze [file]"
• "get file info for [file]"
• "how many lines in [file]"
• "compare [file1] and [file2]"
• "file statistics"

コア操作

ファイルサイズとメタデータ

stat -f "%z bytes, modified %Sm" [file_path]  # Single file
ls -lh [directory]                             # Multiple files
du -h [file_path]                              # Human-readable size

行数カウント

wc -l [file_path]                              # Single file
wc -l [file1] [file2]                          # Multiple files
find [dir] -name "*.py" | xargs wc -l          # Directory total

コンテンツ分析

Read を使用して構造を分析してから、関数・クラス・インポートをカウントします。

パターン検索

Grep(pattern="^def ", output_mode="count", path="src/")        # Count functions
Grep(pattern="TODO|FIXME", output_mode="content", -n=true)    # Find TODOs
Grep(pattern="^import ", output_mode="count")                 # Count imports

ファイル検索

Glob(pattern="**/*.py")

ワークフロー例

包括的なファイル分析

1. サイズ・変更時刻を取得: stat -f "%z bytes, modified %Sm" file.py
2. 行数をカウント: wc -l file.py
3. ファイル読み取り: Read(file_path="file.py")
4. 関数をカウント: Grep(pattern="^def ", output_mode="count")
5. クラスをカウント: Grep(pattern="^class ", output_mode="count")

ファイルサイズの比較

1. ファイルを検索: Glob(pattern="src/**/*.py")
2. サイズを取得: ls -lh src/**/*.py
3. 合計サイズ: du -sh src/*.py

コード品質メトリクス

1. 総行数: find . -name "*.py" | xargs wc -l
2. テストファイル: find . -name "test_*.py" | wc -l
3. TODO: Grep(pattern="TODO|FIXME|HACK", output_mode="count")

最大ファイルを検索

find . -type f -not -path "./node_modules/*" -exec du -h {} + | sort -rh | head -20

ベストプラクティス

• 非破壊的: Read・stat・wc を使用し、決して修正しない
• 効率的: 小さなファイルは全文読み取り、大きなファイルは Grep を使用
• コンテキスト認識: プロジェクト平均と比較し、最適化を提案

統合

以下と連携:

• code-auditor: 包括的な分析
• code-transfer: 大きなファイルを特定した後
• codebase-documenter: ファイルの目的を理解するため