pi-agent-sandbox
为PI提供沙箱环境感知与增强工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-agent-sandbox。 它的用途是：为PI提供沙箱环境感知与增强工具 完整的 Skill 内容见：https://321skill.com/skills/pi-agent-sandbox/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请分析一下这个目录下的Python脚本是否有潜在风险。'，由于AI运行在沙箱中并知晓此上下文，它会理解其文件访问能力受限，并可能优先采用静态分析或请求你将文件复制到沙箱内指定路径后再进行操作，同时其回复会附带沙箱标识提醒你注意环境。
介绍
这个Skill主要解决PI在沙箱环境中运行时缺乏明确标识和上下文信息的问题。当PI在agent-sandbox（asb）沙箱中启动时，它会自动在界面底部显示一个醒目的彩色[sandboxed:]页脚，并向PI的上下文注入沙箱访问相关的信息，帮助用户和AI明确当前处于受限的隔离环境。
使用方式非常直接。开发者只需通过npm安装此包，PI在检测到自身运行于asb沙箱时便会自动启用相关功能。此外，该Skill还附带了一个名为asb-pi的shell包装脚本，这个脚本可以方便地将PI启动在tmux会话内的沙箱环境中，简化了沙箱化工作流的启动步骤。
它非常适合需要在安全、隔离的沙箱环境中使用PI进行开发、测试或执行敏感任务的开发者、安全研究员和运维人员。使用沙箱可以防止意外操作对主机系统造成影响，而此Skill提供的视觉提示和上下文增强能有效避免在沙箱内外混淆操作。
建议在涉及代码执行、文件系统操作或网络访问等可能存在风险的任务前，主动使用asb-pi包装器启动沙箱会话。需要注意的是，沙箱环境本身具有隔离性，可能会限制某些系统调用或文件访问，因此并非所有PI功能都能在沙箱内完美运行，用户需根据实际任务评估。
核心特点
核心区别在于它不仅提供视觉上的沙箱状态标识（彩色页脚），还能自动向AI模型注入沙箱访问的上下文信息，使AI能更智能地适应受限环境；同时，它附带的`asb-pi`包装器将启动沙箱与终端复用器（tmux）结合，提供了开箱即用的、更易管理的沙箱化工作流。
注意事项
不适合需要在沙箱外直接访问主机硬件、特定驱动或进行不受限制的系统级操作的任务。
常见问题
如何知道PI是否运行在沙箱中？
运行后界面底部会显示彩色的[sandboxed:]标识。
asb-pi脚本是做什么的？
它是一个包装器，用于在tmux会话内自动启动沙箱化的PI，方便管理。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-agent-sandbox/raw/index.md 读取 pi-agent-sandbox 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-agent-sandbox/raw/index.md（查看排版版本）