SuperAPI AI 工具集

filesystem

编程与开发

查看项目

更新于 10-15 16:26

技能介绍

用途

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 中执行文件读取、文件查找、内容搜索、文件写入与编辑、目录管理等任务,尤其适合需要遵循统一工具使用规范、保持操作可追溯(通过记忆协议)的开发工作流。

限制

资料未提供该技能的收费、价格、平台支持范围或效果保证等信息。