@heyhuynhgiabuu/pi-task
Pi AI的任务委派与子代理管理扩展
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@heyhuynhgiabuu/pi-task。 它的用途是：Pi AI的任务委派与子代理管理扩展 完整的 Skill 内容见：https://321skill.com/skills/heyhuynhgiabuu-pi-task/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请使用pi-task，在后台启动一个子代理，让它运行这个数据清洗脚本，并创建一个Widget让我看进度。’ 它会创建一个后台子代理执行脚本，并提供一个Widget实时显示清洗进度和日志。或者
对AI说：‘我想一边和你讨论API设计，一边让另一个代理生成文档，用前台模式。’ 它会创建一个前台子代理与你同步交互，专门处理文档生成任务。
介绍
该Skill旨在解决用户在Pi AI中执行复杂或耗时任务时，需要将工作委派给专门子代理并有效管理其运行状态的问题。它允许用户创建并管理运行在“前台”或“后台”的子代理，通过直观的Widget组件实时观察任务进度，并集成了tmux以实现对后台进程的可视化监控，同时提供了SDK回退机制确保稳定性。
使用方式非常灵活。用户可以通过简单的指令，让Pi AI将特定任务（如数据分析、代码审查、文档生成）委派给一个专门的子代理去执行。用户可以选择让子代理在前台运行并即时交互，也可以将其放入后台，同时通过Widget或tmux会话随时查看其输出和状态，而无需中断主对话。
它非常适合需要并行处理多任务、运行长时间脚本或希望将复杂工作流模块化的开发者、数据分析师和运维人员。例如，开发者可以一边与主代理讨论架构设计，一边让后台子代理运行单元测试或构建项目。
使用建议是，对于需要持续交互的探索性任务，使用前台子代理；对于耗时且输出稳定的任务，则放入后台并通过Widget或tmux观察。注意事项包括，确保运行环境支持tmux以使用完整的可观测性功能，并理解后台子代理的生命周期管理，避免资源泄漏。
核心特点
核心区别在于它深度融合了tmux，为后台运行的子代理提供了类似终端多路复用的强大可观测性和控制能力；同时，其Widget组件提供了轻量级的图形化状态监控，这在同类任务委派工具中较为少见。
注意事项
不适合需要极低延迟交互或运行环境严格受限（如无法安装tmux）的场景。
常见问题
如何查看后台运行子代理的输出？
可以通过集成的Widget组件实时查看，或使用tmux attach命令连接到对应的tmux会话查看完整输出。
前台和后台子代理有什么区别？
前台子代理与主对话同步交互，适合需要即时反馈的任务；后台子代理异步运行，主对话可继续，适合耗时任务，可通过Widget或tmux监控。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/heyhuynhgiabuu-pi-task/raw/index.md 读取 @heyhuynhgiabuu/pi-task 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/heyhuynhgiabuu-pi-task/raw/index.md（查看排版版本）