pi-alert
Agent 回合结束时自动发送系统通知
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-alert。 它的用途是：Agent 回合结束时自动发送系统通知 完整的 Skill 内容见：https://321skill.com/skills/pi-alert/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
对 AI 说：“请帮我运行测试并报告结果，完成后通知我。” 当 Agent 执行完测试命令并输出结果后，pi-alert 会自动发送系统通知，标题显示项目名，正文包含“运行测试（耗时12秒）”等摘要，并优先展示“更新了 test_utils.py”等文件变更信息。
介绍
这个 Skill 解决了 Agent 在后台运行任务时，开发者无法及时获知任务完成状态的问题。在实际开发中，当 Agent 执行代码审查、测试运行或耗时推理时，开发者常常需要不断切换窗口查看进度，容易分心或错过完成时机。
使用方式很简单，你只需要通过 pi install npm:pi-alert 安装扩展，之后每次 Agent 结束对提示词的响应时，系统会自动弹出通知。通知标题显示项目根目录名称（如 pi — pi-alert），正文包含活动摘要和耗时，优先展示“更新文件”“工具调用”“读取文件”等关键信息，最后以通用完成信息兜底。
它非常适合需要长时间运行 Agent 任务的开发者，尤其是那些使用 Pi 框架进行代码生成、批量处理或自动化测试的团队或个人。如果你经常在 Agent 执行任务时切换去做其他工作，这个 Skill 能帮你及时回到任务现场，避免遗漏反馈。
建议在开发环境中配合支持终端通知的模拟器（如 Ghostty、iTerm2、Kitty）使用，以获得最佳体验。需要注意的是，该扩展依赖终端环境变量，在 tmux 中需开启 allow-passthrough 才能生效；如果所有通知通道均失败，最后会回退到终端响铃，确保你不会完全错过。
常见问题
安装后为什么没有收到通知？
请确认你在 Pi 框架内运行 Agent，并且终端模拟器支持通知传递。在 tmux 中需启用 `allow-passthrough` 选项。如果仍然无通知，会回退到终端响铃。
如何在 Linux 上使用？
Linux 系统依赖 `notify-send`（来自 libnotify），可通过包管理器安装，如 `sudo apt install libnotify-bin`。终端原生通知支持 Ghostty、WezTerm、Kitty 和 rxvt-unicode。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-alert/raw/index.md 读取 pi-alert 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-alert/raw/index.md（查看排版版本）