@bytesbrains/pi-agent-supervisor
AI代理运行时安全网，拦截危险命令并保护文件。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@bytesbrains/pi-agent-supervisor。 它的用途是：AI代理运行时安全网，拦截危险命令并保护文件。 完整的 Skill 内容见：https://321skill.com/skills/bytesbrains-pi-agent-supervisor/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请清理一下项目的临时文件。”，AI代理在尝试执行`rm -rf ./tmp`命令时，会被Supervisor拦截并记录，防止误删上级目录。它确保了只有符合安全规则的命令才能被执行。
介绍
该Skill旨在为AI代理提供运行时安全防护。它解决的核心问题是，当AI代理在用户环境中执行命令或操作时，可能因指令错误或被恶意引导而执行危险操作（如删除关键文件、执行恶意脚本），导致数据丢失或系统风险。
使用方式非常简单，通常作为AI代理运行时的中间件或插件集成。开发者通过npm安装后，在启动代理时引入该监督器，它便会自动拦截预设的危险命令（如rm -rf），保护指定目录下的文件不被意外修改，并强制执行API调用速率限制，同时记录完整的会话日志以供审计。
它非常适合那些开发或部署具有自主执行代码、文件操作或调用外部API能力的AI代理的开发者、运维人员和安全工程师。无论是个人项目还是企业级应用，只要涉及AI代理与本地或服务器环境的交互，都需要此类安全层来降低操作风险。
使用建议是，在集成前仔细配置其规则策略，明确需要保护的目录和禁止的命令列表。注意事项包括，它主要提供基于规则和模式的防护，对于极其复杂或新颖的攻击向量可能无法完全覆盖，因此不应将其视为唯一的安全措施，而应与其他安全实践结合使用。
核心特点
与同类仅提供命令黑名单的防护工具不同，它集成了文件保护、速率限制和会话记录三大功能，提供了一个更全面的运行时安全与审计解决方案。其设计直接针对AI代理的工作流，而非通用的系统安全工具。
注意事项
不适合用于防护规则极度动态、或需要完全放行AI代理所有操作（无任何限制）的极端实验性场景。
常见问题
它能防止AI删除我的重要文件吗？
可以，通过配置受保护目录，它能拦截针对这些文件的删除或修改命令。
会影响AI代理的正常运行速度吗？
作为轻量级中间件，影响微乎其微，主要开销在于规则匹配和日志记录。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/bytesbrains-pi-agent-supervisor/raw/index.md 读取 @bytesbrains/pi-agent-supervisor 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/bytesbrains-pi-agent-supervisor/raw/index.md（查看排版版本）