@akshaykarle/pi-tools
Pi编码代理的一站式多功能扩展包
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@akshaykarle/pi-tools。 它的用途是:Pi编码代理的一站式多功能扩展包 完整的 Skill 内容见:https://321skill.com/skills/akshaykarle-pi-tools/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我安装pi-tools,然后创建一个包含安全、编码和测试三个子代理的团队,任务是对用户注册模块进行安全性审查,并分配任务给各代理。'它会自动安装扩展、配置安全规则(如禁止rm -rf)、启动三个子进程,并将代码审查、漏洞扫描、测试用例编写分派给对应代理,最终汇总报告。
介绍
这个Skill解决了Pi编码代理在安全、任务协同和多智能体协作方面的能力缺失问题。在日常开发中,AI代理可能执行危险命令(如rm -rf /)、泄露环境变量中的密钥,或缺乏对任务进度和团队分工的管控。pi-tools通过内置的安全拦截、沙箱隔离、任务看板和智能体编排,让代理在受控环境下高效工作。
使用方式很简单,你只需要在终端执行pi install @akshaykarle/pi-tools,或将其添加到~/.pi/agent/settings.json的packages中。安装后所有扩展自动加载,你可以通过自然语言指令触发安全规则(如“禁止删除系统文件”)、管理任务(“添加待办:完成数据库迁移”)、或创建多智能体团队(“启动一个由分析、编码、测试代理组成的团队”)。还支持通过/sandbox status、/team-list等命令查看状态。
它非常适合需要提升AI编码代理安全性和可控性的开发团队。尤其是那些使用Pi进行多项目、多任务并行开发的团队,以及需要多人协作、任务分配和进度跟踪的场景。单独工作的开发者也能利用安全沙箱和任务管理功能,避免代理误操作导致数据丢失。
建议在安装后先配置sandbox.json中的允许路径和网络域,并根据团队需求调整安全策略(如白名单、密钥掩码)。注意,沙箱功能依赖@anthropic-ai/sandbox-runtime,在部分Linux发行版上可能需要额外权限。agent-teams扩展会启动多个Pi子进程,对内存有一定消耗。
常见问题
如何临时禁用沙箱?
执行`/sandbox off`命令,或使用`--no-sandbox`启动参数;重新启用执行`/sandbox on`。
安全扩展会拦截哪些命令?
硬阻止:rm -rf /、mkfs、dd of=/dev、fork炸弹等破坏性命令,以及密钥外泄、修改agent自身配置等行为;sudo、chmod、git push --force等需要确认。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/akshaykarle-pi-tools/raw/index.md 读取 @akshaykarle/pi-tools 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/akshaykarle-pi-tools/raw/index.md(查看排版版本)