pi-unified-exec
为AI提供持久化、可交互的Shell会话管理能力。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-unified-exec。 它的用途是：为AI提供持久化、可交互的Shell会话管理能力。 完整的 Skill 内容见：https://321skill.com/skills/pi-unified-exec/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请启动项目的开发服务器，并监控日志，如果看到‘编译失败’的错误就重启它。” AI会通过pi-unified-exec启动一个长期Shell会话，运行`npm run dev`，并持续轮询输出。当检测到特定错误信息时，AI会向该会话发送Ctrl-C，然后重新启动命令。
介绍
pi-unified-exec 解决了AI助手在需要长时间、多步骤交互的复杂命令行任务中，难以维持会话状态和捕获完整输出的核心痛点。它通过创建一个长期存活的Shell会话（PTY），允许AI像人类一样通过标准输入（stdin）发送指令（包括Ctrl-C中断、方向键等特殊控制），并实时轮询输出，同时将所有交互过程完整记录到磁盘文件中。
使用时，开发者需要先安装此npm包，并在其AI应用或技能中集成。AI助手（如基于Claude或GPT的Agent）可以通过调用该模块提供的接口，向一个预先启动的Shell会话发送命令字符串，并获取其标准输出和错误流。这使得AI能够执行需要连续上下文的操作，例如启动开发服务器、进入REPL环境调试，甚至通过SSH管理远程机器。
该技能主要面向需要构建高级AI编程助手或自动化运维Agent的开发者。特别是那些希望让AI能够处理交互式命令行工作流（如调试Node.js应用、管理Docker容器、执行复杂的Git操作序列）的工程师，可以借助此工具大幅提升AI代理的实操能力。
需要注意的是，由于该技能赋予AI对Shell的直接控制权，务必在受控和安全的环境中使用，避免执行高风险命令。同时，应妥善管理日志文件，防止敏感信息泄露。对于简单的单次命令执行，使用普通的exec函数可能更轻量。
核心特点
与仅能执行单次命令的exec库不同，它提供了真正的持久化、交互式PTY会话，支持发送控制字符（如Ctrl-C）和轮询输出，并能将会话全过程日志保存到文件，这对于调试和审计AI的Shell操作至关重要。
注意事项
不适合用于执行简单的、一次性的、无需交互或状态保持的独立命令，那样会显得过于笨重。
常见问题
pi-unified-exec 能用来做什么？
让AI能像真人一样操作一个长期运行的终端，进行调试、运行交互式程序（如Python REPL）、管理服务器等。
它和child_process.exec有什么区别？
exec执行单次命令后结束，而unified-exec维持一个会话，支持连续输入、交互式命令和特殊按键模拟。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-unified-exec/raw/index.md 读取 pi-unified-exec 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-unified-exec/raw/index.md（查看排版版本）