@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 格式),按其中说明在我的环境里完成安装和配置。