@99percentpeople/pi-background-tasks
Pi 后台任务管理扩展,支持 PTY 和信号控制
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@99percentpeople/pi-background-tasks。 它的用途是:Pi 后台任务管理扩展,支持 PTY 和信号控制 完整的 Skill 内容见:https://321skill.com/skills/99percentpeople-pi-background-tasks/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'启动一个后台任务运行 npm run build,并持续监控日志',它会调用 bg_start 启动构建,然后使用 bg_logs 实时输出日志。如果构建卡住,可以用 bg_send 发送 Ctrl+C 中断,或用 bg_kill 强制终止。
介绍
这个 Skill 解决了在 Pi coding agent 中无法持久运行后台任务、难以管理长时间进程的问题。实际开发中,开发者经常需要启动编译、测试、部署等耗时命令,但 Pi 的默认 bash 工具会阻塞会话,且无法在任务完成后查看输出或发送信号。
使用方式很简单,你只需要通过 pi install npm:@99percentpeople/pi-background-tasks 安装扩展。之后就可以通过自然语言指令来启动后台任务(bg_start)、等待任务完成(bg_wait)、查看状态(bg_status)、获取日志(bg_logs)、发送信号(bg_send)或终止任务(bg_kill)。对于交互式程序,还可以启用 PTY 模式并通过 /bg-attach 命令附加到终端。
它非常适合需要长时间运行构建、自动化测试、数据流水线或交互式工具的开发者。尤其是那些已经使用 Pi 作为主要编码代理,但受限于单线程 bash 执行、无法同时管理多个任务的团队或个人。
建议在启动后台任务时始终指定 name 参数以便后续引用。需要注意的是,它主要依赖 Pi 的会话机制,任务在 Pi 会话结束后会被清理,因此不适合作为系统级守护进程使用。
常见问题
如何查看后台任务的实时输出?
使用 `bg_logs` 工具查看管道输出,或通过 `/bg-attach <id>` 附加到 PTY 任务实时交互。
能否同时运行多个后台任务?
可以,每个任务有独立 ID,通过 `bg_status` 列出所有任务,支持并行管理。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/99percentpeople-pi-background-tasks/raw/index.md 读取 @99percentpeople/pi-background-tasks 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/99percentpeople-pi-background-tasks/raw/index.md(查看排版版本)