filesystem

ファイルシステムスキル

ファイルシステムスキル - Claude Code の組み込みツールを使用したファイルシステム操作のガイダンスです。ファイルの読み取り、書き込み、検索、管理を効率的に行います。 - 単一または複数のファイルの読み取り - ファイルの作成または変更 - パターンによるファイルの検索 - ファイル内容の検索 - ディレクトリの移動

Claude Code の組み込みツール

ファイルの読み取り

Read ツール：ファイルの内容を読み取ります

Read file_path="/path/to/file.txt"

オプション：

• offset：開始行（大きなファイルの場合）
• limit：読み取る行数

ファイルの検索

Glob ツール：パターンでファイルを検索します

Glob pattern="**/*.ts"

一般的なパターン：

• **/*.ts - すべての TypeScript ファイル
• src/**/*.tsx - src 内の React コンポーネント
• **/test*.js - 任意の場所にあるテストファイル

内容の検索

主な検索方法：内容を検索するには、pnpm search:code "query" または Skill({ skill: 'ripgrep' }) を使用します。組み込みの Grep ツールはフォールバックとしてのみ使用します。

Grep ツール：ファイルの内容を検索します（フォールバック専用 — pnpm search:code または ripgrep スキルを優先してください）

Grep pattern="function myFunc" path="/src"

オプション：

• output_mode：「content」、「files_with_matches」、「count」
• -A、-B、-C：前後のコンテキスト行

ファイルの書き込み

Write ツール：ファイルを作成または上書きします

Write file_path="/path/to/file.txt" content="..."

Edit ツール：既存のファイルを変更します

Edit file_path="/path/to/file.txt" old_string="..." new_string="..."

ディレクトリ操作

Bash ツール：ディレクトリ操作に使用します

# List directory
ls -la /path/to/dir

# Create directory
mkdir -p /path/to/new/dir

# Move/rename
mv /old/path /new/path

</execution_process>

<best_practices>

よくあるワークフロー

複数のファイルを読み取る

# Read files in parallel (multiple Read calls in one message)
Read file_path="/src/app.ts"
Read file_path="/src/config.ts"
Read file_path="/src/utils.ts"

検索して読み取る

# 1. Find files
Glob pattern="**/*.config.ts"

# 2. Read matching files
Read file_path="/path/from/glob/result"

検索して置換する

# 1. Search for pattern
Grep pattern="oldFunction" path="/src"

# 2. Edit each file
Edit file_path="/src/file.ts" old_string="oldFunction" new_string="newFunction"

ベストプラクティス

1. 編集前に読み取る：編集する前に、必ずファイルを読み取ってください
2. Bash より Glob を使う：ファイルの検索には find より Glob を優先してください
3. 検索ツールの優先順位：最初に pnpm search:code または Skill({ skill: 'ripgrep' }) を使用し、通常の bash grep よりもフォールバックとして Grep ツールを使用してください
4. 並列読み取り：速度を上げるため、1 回のメッセージで複数のファイルを読み取ってください
5. 変更を確認する：編集後にファイルを読み取り、変更を確認してください

</best_practices>

**すべての TypeScript ファイルを検索して読み取る**：

Glob pattern="src/**/*.ts"
# Then read the results
Read file_path="/src/app.ts"

</usage_example>

<usage_example> 関数を検索して編集する：

Grep pattern="export function oldName" path="/src"
# Found in /src/utils.ts:23

Edit file_path="/src/utils.ts" old_string="export function oldName" new_string="export function newName"

</usage_example>

ルール

• 編集前に必ずファイルを読み取ってください
• bash の同等機能ではなく、組み込みツール（Read、Glob、Grep）を使用してください
• 編集後に変更を確認してください

メモリプロトコル（必須）

開始前：

cat .claude/context/memory/learnings.md

完了後：

• 新しいパターン -> .claude/context/memory/learnings.md
• 見つかった問題 -> .claude/context/memory/issues.md
• 決定事項 -> .claude/context/memory/decisions.md

中断されることを前提としてください。コンテキストがリセットされる場合があります。メモリに記録されていなければ、実行されていないものとして扱われます。