pi-fzfp

基于fzf的模糊文件选择器,快速定位并插入文件路径。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-fzfp。
它的用途是:基于fzf的模糊文件选择器,快速定位并插入文件路径。
完整的 Skill 内容见:https://321skill.com/skills/pi-fzfp/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请分析这个配置文件 @”,此时触发 pi-fzfp,在出现的 fzf 搜索界面中输入 config 等关键词,模糊匹配到目标文件后选中,其完整路径便会自动填入。AI接下来就能直接读取并分析你指定的文件内容。

介绍

在命令行或代码编辑器中,手动输入或查找特定文件路径往往繁琐且容易出错。pi-fzfp 通过集成强大的模糊搜索工具 fzf,解决了文件路径快速定位与自动补全的问题,让文件选取变得直观高效。

使用时,在支持 @file 语法的环境中(如某些AI助手或代码编辑器),触发文件选择命令,pi-fzfp 会调用 fzf 界面,让你通过输入部分文件名进行模糊匹配,实时预览并选中目标文件,其路径将自动插入到当前光标位置。

它非常适合经常需要在命令行、脚本或笔记中引用大量文件的开发者、运维人员和技术写作者,尤其适合项目结构复杂、文件众多的场景。

建议在已安装 fzf 和 Node.js 的环境中使用,以确保最佳体验。初次使用前,请确保熟悉所在工具对 @file 语法的支持方式。对于不依赖文件路径自动补全的简单文件浏览任务,使用系统原生文件管理器可能更直接。

核心特点

核心在于深度集成 fzf,提供流畅的模糊搜索和实时预览体验,而非简单的文件名匹配;同时,它专注于为支持 @file 语法自动补全的工具(如某些AI Agent)提供专用的文件路径插入解决方案。

注意事项

不适合不依赖 @file 语法或不需要在编辑流中插入文件路径的纯命令行文件浏览场景。

常见问题

pi-fzfp 和直接使用 fzf 有什么区别?

pi-fzfp 封装了 fzf,专门用于在支持 @file 语法的工具中自动补全并插入文件路径,是面向特定工作流的集成方案。

需要提前安装 fzf 吗?

是的,pi-fzfp 依赖 fzf 提供核心的模糊搜索功能,需要提前在系统中安装并配置好 fzf。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-fzfp/raw/index.md 读取 pi-fzfp 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。