avtc-pi-subagent-ui-bridge

让子Agent的交互式对话框在主会话中渲染。

安装使用

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

帮我安装这个 AI Skill:avtc-pi-subagent-ui-bridge。
它的用途是:让子Agent的交互式对话框在主会话中渲染。
完整的 Skill 内容见:https://321skill.com/skills/avtc-pi-subagent-ui-bridge/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“调用代码审查子Agent检查这段代码。”当子Agent发现一个潜在bug并建议修复方案时,它会通过此桥接库在主会话中弹出一个选择框,附带上文“发现未处理的空指针异常”,询问您“是否应用建议的修复补丁?”。您可以直接在主界面点击选择,无需切换上下文。

介绍

在基于Agent的复杂工作流中,经常需要调用子Agent(Subagent)来处理特定任务。传统方式下,子Agent如果需要与用户进行交互(例如弹出确认对话框、选择框或表单),这些交互界面通常被限制在子Agent的上下文中,用户无法在主会话(根会话)中直接看到和操作,导致体验割裂,需要频繁切换上下文。

avtc-pi-subagent-ui-bridge 通过简单的集成,解决了这个问题。它作为一个桥梁,能够将子Agent发起的交互式对话框(UI组件)无缝地“提升”并渲染到用户所在的根会话中。同时,它会自动将触发该对话框的子Agent的最后一条消息作为上下文一并传递,确保用户清楚当前交互的背景和目的。开发者只需按照规范集成此桥接库即可。

这个Skill主要面向那些在构建复杂、多层嵌套Agent系统的开发者,特别是当他们的子Agent需要提供丰富的、需要用户即时反馈的交互界面时。例如,一个负责代码审查的子Agent可能需要弹出一个对话框让用户选择修复方案。

使用建议是,在设计和开发子Agent的交互逻辑时,确保交互请求的格式符合此桥接库的规范。注意事项包括:它主要处理UI组件的渲染位置和上下文传递,不负责具体的UI组件实现;需要确保根会话环境支持渲染这些交互组件;在调试时,需关注上下文信息传递的准确性。

核心特点

核心区别在于它专注于解决“嵌套子Agent的交互界面隔离”这一具体问题,通过将交互界面提升至根会话并附带子Agent的最后消息作为上下文,实现了跨层级Agent的无缝用户体验,而同类工具可能更侧重于Agent间的纯消息传递或任务编排。

注意事项

不适合仅进行单向信息传递、无需复杂用户交互的简单子Agent调用场景。

常见问题

这个桥接库支持哪些类型的交互组件?

支持常见的交互式对话框,如确认框、选择器、表单等,具体取决于根会话UI框架的能力。

集成后会影响子Agent原有的逻辑吗?

基本不影响,它主要改变交互界面的渲染位置和上下文传递方式,不干涉子Agent的核心处理逻辑。

给 AI 助手的安装指引

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

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