用途
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 工具执行目录操作:
# 列出目录
ls -la /path/to/dir
# 创建目录
mkdir -p /path/to/new/dir
# 移动/重命名
mv /old/path /new/path
使用方式
常见工作流
并行读取多个文件:在一条消息中发起多个 Read 调用:
Read file_path="/src/app.ts"
Read file_path="/src/config.ts"
Read file_path="/src/utils.ts"
先搜索再读取:
# 1. 查找文件
Glob pattern="**/*.config.ts"
# 2. 读取匹配的文件
Read file_path="/path/from/glob/result"
查找并替换:
# 1. 搜索模式
Grep pattern="oldFunction" path="/src"
# 2. 编辑每个文件
Edit file_path="/src/file.ts" old_string="oldFunction" new_string="newFunction"
最佳实践
- 编辑前先读取:编辑文件前始终先读取该文件
- 优先使用 Glob 而非 Bash:查找文件时优先使用 Glob,而不是
find - 搜索工具层级:优先使用
pnpm search:code或Skill({ skill: 'ripgrep' });仅在回退时使用 Grep 工具,而不是直接使用 bash grep - 并行读取:在一条消息中读取多个文件以提升速度
- 验证更改:编辑后读取文件以验证结果
规则
- 编辑文件前始终先读取
- 使用内置工具(Read、Glob、Grep)而非 bash 等价命令
- 编辑后验证更改
记忆协议(强制)
开始前:
cat .claude/context/memory/learnings.md
完成后:
- 新模式 ->
.claude/context/memory/learnings.md - 发现问题 ->
.claude/context/memory/issues.md - 做出决策 ->
.claude/context/memory/decisions.md
假设中断:上下文可能重置。如果未写入记忆,就等于没有发生。
适用场景
适用于在 Claude Code 中执行文件读取、文件查找、内容搜索、文件写入与编辑、目录管理等任务,尤其适合需要遵循统一工具使用规范、保持操作可追溯(通过记忆协议)的开发工作流。
限制
资料未提供该技能的收费、价格、平台支持范围或效果保证等信息。