@vladstudio/pi-file-tree
生成路径ASCII目录树的Pi扩展,支持智能适配上下文深度
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@vladstudio/pi-file-tree。 它的用途是:生成路径ASCII目录树的Pi扩展,支持智能适配上下文深度 完整的 Skill 内容见:https://321skill.com/skills/vladstudio-pi-file-tree/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'用pi-file-tree展示当前项目src目录的结构',它会返回排版规整的ASCII格式目录树。若你需要固定展示3层深度,可补充指令'指定遍历深度为3',它会按照要求输出对应层级的文件结构。
介绍
日常开发、文档编写或文件整理场景中,手动梳理目录结构耗时费力,普通目录树工具输出格式不统一、参数配置繁琐,难以快速清晰地呈现指定路径下的文件层级关系,也不方便直接嵌入到文档或对话中使用。该工具作为Pi生态的扩展组件,安装完成后只需传入目标路径参数即可调用,无需复杂配置,运行后会返回排版规范的ASCII格式目录树,输出结果为纯文本格式,可直接复制到文档、对话或代码注释中使用。它适合需要频繁梳理项目结构的前后端开发者、编写项目README或技术文档的技术写作者、整理本地资源目录的办公人员,以及需要在AI对话中快速展示文件架构的Pi工具使用者。使用时建议明确指定目标路径,若有特殊展示需求可传入对应参数调整输出规则,输出的ASCII树采用通用排版格式,在绝大多数纯文本环境中都能正常显示。
核心特点
和同类目录树工具相比,它具备智能自动深度适配能力,可根据当前可用上下文空间自动调整目录遍历层级,无需手动配置深度参数,避免输出过长挤占空间或层级过浅信息不足。
注意事项
仅支持生成ASCII格式的纯文本目录树,无法输出可视化图形类结构,且需在Pi扩展运行环境中使用。
常见问题
生成的ASCII目录树可以直接复制到Markdown中使用吗?
可以,输出为标准纯文本格式,粘贴后即可正常显示。
可以手动指定目录的展示深度吗?
支持手动传入深度参数,默认会自动适配最优展示层级。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/vladstudio-pi-file-tree/raw/index.md 读取 @vladstudio/pi-file-tree 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/vladstudio-pi-file-tree/raw/index.md(查看排版版本)