pi-skill-guard
拦截工具未找到错误，智能提供文档或执行命令
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-skill-guard。 它的用途是：拦截工具未找到错误，智能提供文档或执行命令 完整的 Skill 内容见：https://321skill.com/skills/pi-skill-guard/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘运行一下 `ffmpeg -version`’。如果系统没有预装ffmpeg技能，pi-skill-guard会拦截错误，并可能尝试在bash中执行该命令，返回版本信息或提示未安装。当您输入一个模糊的技能名时，它也可能直接展示相关文档供您参考。
介绍
当您在AI助手（如Pi）中尝试调用一个不存在的工具或命令时，通常会遇到令人困惑的“工具未找到”错误，导致工作流中断。pi-skill-guard 是一个扩展，专门拦截这类错误，并智能地为您提供解决方案。
它的工作原理是：当您输入的命令触发“工具未找到”错误时，该扩展会首先检查命令名称是否与已知的Skill名称匹配。如果匹配，它会自动注入该Skill的文档，让您了解其功能和用法。如果命令是未知的，并且带有参数，它会尝试将整个命令回退到bash环境中执行，从而可能直接完成您的意图。
这个Skill非常适合那些经常在AI助手环境中探索新工具、尝试执行系统命令，或希望获得更流畅、容错性更高交互体验的开发者、技术爱好者和高级用户。它减少了因命令错误而导致的停顿，让探索和执行过程更加顺畅。
使用建议：请注意，该Skill的回退到bash功能依赖于您本地环境的权限和可用命令，请谨慎执行未知来源的命令。它主要作为提高交互体验的辅助工具，并不能替代对系统命令和安全性的基本了解。
核心特点
核心区别在于它并非直接提供新功能，而是作为“错误拦截与智能补救”层，在工具调用失败时主动提供文档或尝试执行，将中断点转化为学习或执行机会，这是大多数具体功能型Skill所不具备的。
注意事项
不适合用于执行需要严格环境隔离或高安全性的生产级自动化任务。
常见问题
pi-skill-guard 能安装新工具吗？
不能，它主要是在工具调用失败时提供文档或尝试执行命令，不负责安装。
回退到bash执行安全吗？
需谨慎，它会在您的本地环境执行命令，请确保命令来源可信。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-skill-guard/raw/index.md 读取 pi-skill-guard 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-skill-guard/raw/index.md（查看排版版本）