@4meta5/pi-zsh
为Pi智能体提供安全的Zsh脚本运行能力
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@4meta5/pi-zsh。 它的用途是：为Pi智能体提供安全的Zsh脚本运行能力 完整的 Skill 内容见：https://321skill.com/skills/4meta5-pi-zsh/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请运行项目的单元测试。”，它会检查‘npm run test:unit’是否在允许列表中，如果在，则安全地执行该命令并返回结果。或者，你可以说：“执行部署到预发布环境的脚本。”，它同样会验证并运行对应的授权命令。
介绍
这个Skill是一个专门为Pi编码智能体设计的Zsh脚本运行器扩展。它解决的核心问题是：如何在赋予AI助手执行Zsh脚本强大能力的同时，确保系统安全，防止恶意或意外命令的执行。
它的使用方式是基于“允许列表”机制。开发者需要预先定义一个允许执行的Zsh脚本命令列表。当Pi智能体需要运行脚本时，该扩展会检查命令是否在允许列表中，只有完全匹配的命令才能被执行，从而将风险控制在可预测的范围内。
它非常适合那些希望利用Pi智能体自动化本地开发任务，但又对直接授予Shell访问权限心存顾虑的开发者或团队。例如，自动化构建流程、运行测试套件、执行部署脚本等场景。
使用建议是，在配置允许列表时，应遵循最小权限原则，只添加确实需要的、经过审核的脚本命令。同时，由于它是“仅允许列表”模式，对于需要动态生成复杂命令或交互式Shell的任务并不适用，用户需提前规划好需要自动化的固定脚本集。
核心特点
核心区别在于其严格的白名单安全模型，与提供通用Shell访问的同类工具不同，它只允许执行预先明确授权的特定脚本命令，安全性更高。
注意事项
不适合需要动态、交互式或临时执行未预先授权命令的灵活自动化场景。
常见问题
这个Skill安全吗？
采用白名单机制，只运行预先授权的命令，安全性高。
能运行任何Zsh命令吗？
不能，只能运行配置在允许列表中的特定脚本命令。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/4meta5-pi-zsh/raw/index.md 读取 @4meta5/pi-zsh 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/4meta5-pi-zsh/raw/index.md（查看排版版本）