file-operations

ファイル操作

Claude のネイティブツールを使用して、ファイルを変更せずに分析し、メタデータを取得します。

使用する場面

• 「[ファイル]を分析」
• 「[ファイル]の情報を取得」
• 「[ファイル]の行数」
• 「[ファイル1]と[ファイル2]を比較」
• 「ファイルの統計情報」

主な操作

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

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：ファイルの目的を理解