@yusukeshib/pi-notify

在Pi Agent完成回合时发送原生macOS通知

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@yusukeshib/pi-notify。
它的用途是:在Pi Agent完成回合时发送原生macOS通知
完整的 Skill 内容见:https://321skill.com/skills/yusukeshib-pi-notify/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请帮我分析这个数据集并生成报告。” 当Pi Agent在后台处理完分析任务时,你的macOS屏幕角落会弹出完成通知。点击该通知,系统会自动将你带回Pi的对话窗口,查看完整的分析结果。

介绍

这个Skill解决了在Pi Agent处理任务时,用户需要时刻盯着终端或窗口等待结果的问题。它通过调用macOS的原生通知系统,在Pi Agent完成一个回合(例如执行完一段代码或回答完一个问题)时,即时向用户推送通知,让用户可以放心地切换到其他应用工作,而不会错过任务完成的信号。

使用时,只需正常与Pi Agent交互,当Agent完成当前任务回合后,系统会自动弹出通知。通知会显示任务完成的状态,并且是“焦点感知”的——如果Pi的窗口已经是当前焦点,可能不会打扰用户。更棒的是,点击通知可以直接将焦点切换到Pi的应用窗口,实现快速继续对话。

它非常适合那些使用Pi Agent进行长时间、多步骤任务(如代码调试、数据分析、文档撰写)的macOS用户,特别是需要并行处理多项工作、容易因等待而分心或中断工作流的效率追求者。对于依赖Pi进行深度工作,但又不想被绑定在对话窗口前的开发者、写作者或研究人员来说,这是一个提升体验的小工具。

建议在需要进行耗时任务(如运行脚本、生成报告)前确保此Skill已启用。需要注意的是,它依赖macOS的terminal-notifier工具来发送通知,因此请确保你的系统环境支持。虽然通知是“状态感知”的,但在某些极端情况下(如系统通知设置被禁用),可能无法正常工作。

核心特点

核心区别在于其“状态感知”与“焦点感知”特性:它只在Pi Agent真正完成一个任务回合且用户可能不在焦点时发送通知,并允许用户直接点击通知跳回Pi窗口,实现了通知的精准触发与高效交互闭环。

注意事项

仅适用于macOS系统,且需要系统支持终端通知工具。

常见问题

这个Skill支持Windows或Linux吗?

不支持,它专门为macOS系统设计,依赖其原生通知机制和terminal-notifier工具。

点击通知真的能跳回Pi吗?

是的,点击通知会直接将应用焦点切换到Pi的对话窗口,方便快速继续工作。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/yusukeshib-pi-notify/raw/index.md 读取 @yusukeshib/pi-notify 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。