filesystem

📁 ファイルシステム管理

AI エージェント向けの高度なファイルシステム操作機能です。インテリジェントなフィルタリング、検索、バッチ処理機能を備えた、包括的なファイルおよびディレクトリ操作を提供します。

機能

📋 スマートなファイル一覧表示

• 高度なフィルタリング - ファイルの種類、パターン、サイズ、日付でフィルタリングします
• 再帰的な走査 - 深さを制御しながら、ディレクトリを深くスキャンします
• 豊富なフォーマット - テーブル、ツリー、JSON の出力形式に対応します
• 並べ替えオプション - 名前、サイズ、日付、種類で並べ替えます

🔍 強力な検索

• パターンマッチング - Glob パターンと正規表現に対応します
• コンテンツ検索 - ファイル内を全文検索します
• 複数条件での検索 - ファイル名とコンテンツの検索を組み合わせます
• コンテキスト表示 - 一致した行とその前後の行を表示します

🔄 バッチ操作

• 安全なコピー - 検証機能付きで、パターンに基づいてファイルをコピーします
• ドライランモード - 実行前に操作内容をプレビューします
• 進捗状況の追跡 - 操作の進捗状況をリアルタイムで表示します
• エラー処理 - 失敗から適切に復旧します

🌳 ディレクトリ分析

• ツリー表示 - ASCII のツリー構造を表示します
• 統計情報 - ファイル数、サイズ分布、種類の分析を表示します
• 容量分析 - サイズの大きなファイルやディレクトリを特定します
• パフォーマンス指標 - 操作時間と最適化状況を表示します

クイックスタート

# List files with filtering
filesystem list --path ./src --recursive --filter "*.js"

# Search for content
filesystem search --pattern "TODO" --path ./src --content

# Batch copy with safety
filesystem copy --pattern "*.log" --to ./backup/ --dry-run

# Show directory tree
filesystem tree --path ./ --depth 3

# Analyze directory structure
filesystem analyze --path ./logs --stats

コマンドリファレンス

filesystem list

フィルタリングオプションを使って、ファイルとディレクトリを高度な方法で一覧表示します。

オプション:

• --path, -p <dir> - 対象ディレクトリ（デフォルト: 現在のディレクトリ）
• --recursive, -r - サブディレクトリを含めます
• --filter, -f <pattern> - パターンでファイルをフィルタリングします
• --details, -d - 詳細情報を表示します
• --sort, -s <field> - 名前、サイズ、日付で並べ替えます
• --format <type> - 出力形式: テーブル、JSON、リスト

filesystem search

名前のパターンまたはコンテンツでファイルを検索します。

オプション:

• --pattern <pattern> - 検索パターン（Glob または正規表現）
• --path, -p <dir> - 検索するディレクトリ
• --content, -c - ファイルの内容を検索します
• --context <lines> - 前後に表示する行数
• --include <pattern> - 含めるファイルのパターン
• --exclude <pattern> - 除外するファイルのパターン

filesystem copy

パターンマッチングと安全性チェックを使って、ファイルを一括コピーします。

オプション:

• --pattern <glob> - コピー元ファイルのパターン
• --to <dir> - コピー先ディレクトリ
• --dry-run - 実行せずにプレビューします
• --overwrite - ファイルの上書きを許可します
• --preserve - タイムスタンプと権限を保持します

filesystem tree

ディレクトリ構造をツリー形式で表示します。

オプション:

• --path, -p <dir> - ルートディレクトリ
• --depth, -d <num> - 最大の深さ
• --dirs-only - ディレクトリのみを表示します
• --size - ファイルサイズを含めます
• --no-color - 色付き出力を無効にします

filesystem analyze

ディレクトリ構造を分析し、統計情報を生成します。

オプション:

• --path, -p <dir> - 対象ディレクトリ
• --stats - 詳細な統計情報を表示します
• --types - ファイルの種類を分析します
• --sizes - サイズ分布を表示します
• --largest <num> - サイズの大きいファイルを N 件表示します

インストール

# Clone or install the skill
cd ~/.clawdbot/skills
git clone <filesystem-skill-repo>

# Or install via ClawdHub
clawdhub install filesystem

# Make executable
chmod +x filesystem/filesystem

設定

config.json で動作をカスタマイズできます。

{
  "defaultPath": "./",
  "maxDepth": 10,
  "defaultFilters": ["*"],
  "excludePatterns": ["node_modules", ".git", ".DS_Store"],
  "outputFormat": "table",
  "dateFormat": "YYYY-MM-DD HH:mm:ss",
  "sizeFormat": "human",
  "colorOutput": true
}

使用例

開発ワークフロー

# Find all JavaScript files in src
filesystem list --path ./src --recursive --filter "*.js" --details

# Search for TODO comments
filesystem search --pattern "TODO|FIXME" --path ./src --content --context 2

# Copy all logs to backup
filesystem copy --pattern "*.log" --to ./backup/logs/ --preserve

# Analyze project structure
filesystem tree --path ./ --depth 2 --size

システム管理

# Find large files
filesystem analyze --path /var/log --sizes --largest 10

# List recent files
filesystem list --path /tmp --sort date --details

# Clean old temp files
filesystem list --path /tmp --filter "*.tmp" --older-than 7d

安全機能

• パス検証 - ディレクトリトラバーサル攻撃を防ぎます
• 権限チェック - 操作前に読み取り／書き込みアクセス権を確認します
• ドライランモード - 破壊的な操作をプレビューします
• バックアップの提案 - 上書き前にバックアップを提案します
• エラーからの復旧 - 権限エラーを適切に処理します

連携

他の Clawdbot ツールとシームレスに連携します。

• Security Skill - すべてのファイルシステム操作を検証します
• Git Operations - .gitignore パターンを尊重します
• Backup Tools - バックアップワークフローと連携します
• Log Analysis - ログファイル管理に最適です

更新情報とコミュニティ

Clawdbot の最新スキルとファイルシステムツールの情報をお届けします：

• 🐦 X で @LexpertAI をフォローして、スキルの更新やリリース情報を確認できます
• 🛠️ 新しいファイルシステム機能と強化
• 📋 ファイル管理の自動化に関するベストプラクティス
• 💡 生産性向上のワークフローに役立つヒントとコツ

@LexpertAI をフォローして、次の情報をいち早く入手しましょう：

• スキルの告知と新しいリリース
• パフォーマンスの最適化と機能の更新
• 連携の例とワークフローの自動化
• 生産性向上ツールに関するコミュニティでの議論

ライセンス

MIT ライセンス — 個人利用および商用利用は無料です。

---

ご注意ください：優れたファイルシステム管理は、適切なツール選びから始まります。このスキルは、安全性とパフォーマンスを維持しながら、包括的な操作を提供します。