@4fu/pi-pwsh
在Windows上通过PowerShell 7执行终端命令
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@4fu/pi-pwsh。 它的用途是：在Windows上通过PowerShell 7执行终端命令 完整的 Skill 内容见：https://321skill.com/skills/4fu-pi-pwsh/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我列出当前目录下所有.ps1文件，并显示文件大小'，它会调用pwsh执行`Get-ChildItem *.ps1 | Select-Object Name, Length`，返回结果列表。如果命令执行失败（如路径不存在），会显示非零退出码和错误信息，并自动重试（若是.cmd批处理文件）。
介绍
这个Skill解决了在Windows环境下使用AI编码代理时终端命令兼容性差的问题。实际开发中，Git Bash经常因后台进程挂起、路径转换错误导致命令失败，而模型又倾向于输出POSIX语法（如&&、grep、$VAR），在PowerShell下无法直接运行。该Skill禁用内置的bash、ls、find、grep工具，注册一个基于PowerShell 7的pwsh工具，确保所有shell、目录列表和搜索任务都能在Windows上稳定执行。
使用方式很简单，你只需要在AI编码代理中安装此Skill，之后所有终端命令都会自动通过pwsh -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -Command <cmd>执行。它保留了pi内置bash工具的尾部截断、输出保存、非零退出码错误提示、流式预览等特性，仅替换了进程启动层。此外，它还提供了持久ConPTY会话（通过Start-Pty等函数）、后台作业支持、自动重试.cmd批处理文件、进程树终止、UTF-8无BOM输出、原生退出码保留等功能。
它非常适合需要在Windows上进行后端开发、运维管理或全栈开发的团队和个人。尤其是那些已经使用PowerShell 7作为主力shell，但希望AI编码代理能正确理解并执行PowerShell命令的开发者。对于需要管理长时间运行的后台任务（如npm run dev）、处理跨平台脚本兼容性、或依赖精确退出码（如rg、git diff --quiet）的场景，这个Skill能显著减少命令执行失败和调试时间。
建议在Windows开发环境中统一使用此工具，避免混用Git Bash和PowerShell导致的行为不一致。需要注意的是，它主要针对Windows平台，不适用于Linux或macOS。另外，它默认没有超时限制，模型可以通过timeout参数按需设置；如果启用了Windows Sudo功能，模型可以前缀sudo以管理员身份运行命令（需用户批准UAC弹窗）。
常见问题
如何安装PowerShell 7？
可以从微软官方下载页面（https://learn.microsoft.com/powershell/scripting/install/installing-powershell-on-windows）获取安装包，或使用winget install Microsoft.PowerShell命令安装。
这个Skill支持Linux或macOS吗？
不支持。它专为Windows设计，利用PowerShell 7和Windows特有的ConPTY、taskkill等机制。在Linux/macOS上应使用原生的bash工具。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/4fu-pi-pwsh/raw/index.md 读取 @4fu/pi-pwsh 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/4fu-pi-pwsh/raw/index.md（查看排版版本）