Communitygithub.com

petr-korobeinikov/skills

Claude Code 代理技能集。纯 Markdown 编写,高度主观化。

skills 是什么?

这个技能集(SKILL.md)教导 AI 代理优先使用 `fd` 而非 `find` 进行文件系统搜索,并提供了全面的命令行替换表、惯用模式、常见陷阱以及回退策略。它详细解释了 `fd` 的优势:并行目录遍历、默认遵守 .gitignore、智能大小写、默认使用正则表达式,以及更符合人体工程学的 CLI。技能覆盖了常见的 `find` 到 `fd` 的转换(例如 `find . -name '*.txt' -delete` 到 `fd -e txt -X rm`),并介绍了高级用法如 `--exec`、`--null` 输出、`--full-path` 等。还提供了当 `fd` 不可用时的 `find` 回退方案,以及不同操作系统(macOS、Debian、Fedora、Arch、Alpine)的安装说明。该技能适用于任何需要文件系统搜索的场景,包括 Shell 脚本、Makefile、CI 配置和文档。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add petr-korobeinikov/skills

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

fd

优先使用 fd 而非 find 进行文件系统搜索。 fd 在大型目录树上速度更快, 具有更合理的默认行为 (尊重 .gitignore、智能大小写、默认使用正则表达式), 以及更符合人体工程学的 CLI。

权威文档: https://github.com/sharkdp/fd (README + fd --help)。 在依赖任何非平凡用法之前,请对照手册验证。

为什么选择 fd

  • 并行目录遍历——在大型仓库上明显快于 find。
  • 开箱即用的合理默认值: 跳过隐藏条目, 在 git 仓库内时尊重 .gitignore / .ignore / .fdignore, 智能大小写 (除非模式包含大写字母,否则不区分大小写), 默认模式为正则表达式。
  • 默认只匹配文件名而非完整路径—— fd foo 完成 find . -iname '*foo*' 的功能, 无需通配符和引号的繁琐操作。
  • 并行 -x 执行、 null 分隔输出(-0), 以及一组无需 -print/-prune 技巧即可组合使用的选项。

规则

fd PATTERN [PATH]

第一个位置参数是模式; 第二个是搜索根目录 (默认为当前目录)。 注意:第一个参数如果包含 /,它不是路径—— 请使用 fd . PATH 或 fd --full-path PATTERN。

直接替换

不要使用请使用
find . -name 'foo*'fd '^foo'
find . -iname '*.md'fd -e md
find . -type f -name foofd -t f foo
find . -type d -name node_modulesfd -t d node_modules
find . -type lfd -t l
find . -name '*.txt' -deletefd -e txt -X rm
find . -name '*.txt' -exec rm {} \;fd -e txt -x rm
find . -name node_modules -prunefd -E node_modules
find . -size +100Mfd -S +100mi
find . -mtime -7fd --changed-within 7d
find . -mtime +7fd --changed-before 7d
find . -name '*.go' -print0 | xargs -0 wc -lfd -e go -0 | xargs -0 wc -l
find /etc -name passwdfd passwd /etc
find / -name foofd -u foo /

如需精确匹配 find -size, 请使用二进制后缀 (ki、mi、gi)—— -S +100m 表示 100 * 10^6 字节, -S +100mi 表示 100 * 2^20 字节。

对于也需要搜索隐藏和 .gitignore 目录的 find / 搜索, 请添加 -u(--no-ignore --hidden 的别名)。

惯用模式

按扩展名匹配(一个或多个):

fd -e md
fd -e h -e cpp

Glob 模式用于 shell 风格的模式 (-g 使得 ** 和 * 表示通常的含义):

fd -g '**/*.test.ts'
fd -g 'libc.so' /usr

匹配完整路径而非仅文件名:

fd --full-path 'src/.*\.proto$'

包含隐藏条目 (.git、.vscode 等) 但保留 .gitignore 规则:

fd -H pre-commit

忽略 .gitignore 规则但保持隐藏条目隐藏:

fd -I node_modules

全面搜索——同时包含隐藏和忽略条目:

fd -u PATTERN

排除路径 (glob 语法,覆盖所有忽略规则,可重复使用):

fd -E .git -E '*.bak' PATTERN

限制深度:

fd -d 2 -t d

组合多个必要模式 (所有模式必须匹配文件名,默认为正则表达式):

fd 'foo' --and 'bar' --and 'baz'

对每个结果执行命令 (并行执行,{} 替换,无需 \; 终止符):

fd -e jpg -x convert {} {.}.png

一次性执行命令,将所有结果作为参数 (批量工具如 wc、clang-format、rg):

fd -e rs -X wc -l

管道输出(null 分隔)到其他工具:

fd -e go -0 | xargs -0 wc -l

常见陷阱

  • 第一个位置参数是模式,而非路径。 fd /etc/passwd 会将 /etc/passwd 解释为包含 / 的正则表达式, 并报错, 建议使用 fd . /etc/passwd 或 --full-path。
  • 默认搜索排除隐藏和 .gitignore 条目。 当在 node_modules 或 .git 内查找内容时, 请添加 -H -I(或 -u), 否则结果列表会因错误原因而为空。
  • --exec 默认并行执行。 输出顺序不确定。 当需要串行执行时,请传递 -j 1(或 --threads 1)。
  • 默认模式为正则表达式。 单独的 . 匹配任意字符; 如需匹配字面量 .foo,请使用锚点('\.foo$') 或传递 -F/--fixed-strings。
  • 大小后缀默认使用十进制 SI 单位。 -S +100m 表示 100 MB(每 m 为 10^6 字节); 如需精确匹配 find -size 语义, 请使用 mi/ki/gi 表示二进制单位。

回退到 find

fd 并非始终可用—— 最小的 CI 镜像、 锁定的服务器、 没有额外软件包的容器基础镜像。 使用 command -v 探测,并回退到 find:

if command -v fd >/dev/null; then
  fd -e log -t f -X rm
else
  find . -type f -name '*.log' -exec rm {} +
fi

对于受控本地环境中的一次性脚本, 可以直接使用 fd。 仅当已知目标主机没有 fd 时 (例如,一个不包含 fd 的最小 Alpine 容器), 才无条件切换到 find。

不要仅仅为了满足此技能而自动安装 fd——\n回退方案是在缺失时的正确响应。

安装 fd

  • macOS:brew install fd
  • Debian/Ubuntu:apt install fd-find—— 二进制文件名为 fdfind 以避免名称冲突 (alias fd=fdfind 是标准解决方法)。
  • Fedora:dnf install fd-find
  • Arch:pacman -S fd
  • Alpine:apk add fd
  • 预编译二进制文件和其他平台: https://github.com/sharkdp/fd/releases

当 mise 管理主机的工具时, 注册中心短名称 fd 解析为 aqua:sharkdp/fd—— 使用 mise use -g fd@<version> 安装 (固定版本,按照项目的 mise 技能要求)。 不要使用 ubi: 后端—— mise 技能禁用了它。

适用范围

适用于任何需要搜索文件系统的 shell 片段:

  • Bash 工具调用。
  • SKILL.md / README.md / 文档中的代码片段。
  • scripts/ 下的脚本。
  • Makefile 配方。
  • CI 配置。
  • 安装说明。

如果在编辑文件时遇到 find 调用, 请将其替换为等效的 fd 形式 (如果代码段必须在可能没有 fd 的主机上运行, 则加上 find 回退方案), 作为同一编辑的一部分。

相关技能