@isr4el-silv4/pi-script-tools
自动发现并注册Shell脚本为Pi工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@isr4el-silv4/pi-script-tools。 它的用途是：自动发现并注册Shell脚本为Pi工具 完整的 Skill 内容见：https://321skill.com/skills/isr4el-silv4-pi-script-tools/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我列出/home/user/scripts目录下所有可用的工具。” 它会调用此扩展扫描该目录，并返回已注册的脚本工具列表。然后你可以说：“使用‘备份数据库’工具。” AI便会执行对应的Shell脚本，完成备份任务。
介绍
这个Skill是一个Pi平台的扩展工具，它解决了用户需要手动将常用Shell脚本注册为Pi工具的问题。通过自动化扫描指定目录下的脚本文件，它能够省去繁琐的配置步骤，让脚本快速变成可被Pi调用的功能模块。
使用起来非常简单。用户只需安装此扩展，并将其指向存放Shell脚本的文件夹。扩展会自动识别这些脚本，读取其元信息（如名称、描述、参数），并完成在Pi平台上的注册。之后，用户就可以像调用其他Pi工具一样，通过自然语言指令来运行这些脚本了。
它非常适合那些拥有大量实用Shell脚本，并希望将它们无缝集成到AI工作流中的开发者、运维工程师或高级用户。特别是对于经常使用Pi进行自动化操作，但又不想为每个脚本重复编写工具封装代码的团队。
使用建议是，确保你的Shell脚本有清晰的注释（例如使用特定的格式描述参数），以便扩展能正确解析。注意事项包括：该扩展主要处理相对独立的脚本，对于依赖复杂环境或需要交互式输入的脚本，可能无法完美适配，使用时需进行测试。
核心特点
核心区别在于其“自动发现”机制，无需为每个脚本手动编写配置文件或工具描述，能批量、零配置地将现有脚本库转化为AI工具。相比需要逐个定义工具接口的同类方案，它大幅降低了集成成本。
注意事项
不适合处理需要复杂用户交互、图形界面或高度依赖特定会话状态的Shell脚本。
常见问题
如何让扩展识别我的脚本参数？
在脚本头部使用特定格式的注释（如# @param）来描述参数，扩展会自动解析。
支持哪些Shell脚本？
主要支持Bash、Zsh等常见Shell编写的脚本，只要能在目标系统终端中执行即可。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/isr4el-silv4-pi-script-tools/raw/index.md 读取 @isr4el-silv4/pi-script-tools 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/isr4el-silv4-pi-script-tools/raw/index.md（查看排版版本）