nicobailon/pi-better

项目介绍

pi-better 是 Pi 的一个扩展，新增 /better 命令。在任何提示词前加上它，扩展会把提示词改写成该领域顶级专业人员会提出的更深入版本，并基于你仓库里真实的代码、文件、文档和日志来写。改好的提示词会放进输入框，由你确认后才发送。

改写方法来自 Felix Rieseberg 教程中的四个问题：专业人员会做哪些你没要求的事、他们会从什么原始材料开始、他们会用什么方法和工具、以及除了你或模型之外什么能证明结果正确（来源）。pi-better 在此基础上要求辅助进程先自行查找并阅读相关代码和文件、不要询问用户，也绝不自行开始执行任务（辅助指令）。

适合希望提高任务说明质量、又不想手写的 Pi 用户；配合 pi-subagents 时，也能用来为子代理的任务简报做检查。

快速使用

需要先安装 Pi。在 shell 中执行：

pi install npm:pi-better

然后运行 /reload 或重启 Pi 加载扩展（安装说明）。加载后输入：

/better make the error messages clearer

辅助进程在后台读取相关文件并搜索，同时你可以继续聊天。输入框上方会显示进度，按 Esc 可取消。完成后改写后的提示词出现在输入框并附有提示，按 Enter 之前不会发送任何内容。

如果希望实时观看改写过程、并在结束后让聊天回滚到运行前，可使用 /better-boomerang <prompt>。

使用约束

辅助进程是一个独立的只读 pi 进程，持有当前聊天的副本。它可以使用 read、你的 shell（bash，或使用时的 powershell），以及聊天中具备的 grep、find、ls；调用其他工具（包括 edit 和 write）会被拒绝。运行超过 20 分钟会停止（细节）。

默认使用当前聊天的模型和思考等级，并复用服务商的提示词缓存。若要更换，在 ~/.pi/agent/settings.json 或项目的 .pi/settings.json 中添加 better 键，设置 model 和/或 thinking；换模型后缓存不会沿用。项目使用 MIT 许可证。

HotRepo 点评

pi-better 在 HotRepo 新项目榜（TypeScript 语言）中出现过一次记录：2026 年 11 月 15 日的统计窗口内新增 3 颗 Star，总数达到 103，同期新增 1 个 Fork。样本很短，不足以说明长期趋势；它能提供的有价值信息是：这个工具对正在使用 Pi 的开发者有明确的使用场景，但它的收益取决于仓库本身是否便于辅助进程读取和检索。