@juicesharp/rpiv-ask-user-question

向模型注册 ask_user_question 工具,把模棱两可的猜测变成终端底部 15 秒可选的结构化问卷。

安装命令
pi install npm:@juicesharp/rpiv-ask-user-question
临时试用 / 替代安装命令
pi -e npm:@juicesharp/rpiv-ask-user-question
挂接事件钩子与注册入口
tool_execution_start / 阻塞等待终端 TUI 交互回调
pi.registerTool()(ask_user_question)ctx.ui.custom()(底部多标签问卷交互面板)

1. 是什么

@juicesharp/rpiv-ask-user-question 是 rpiv-mono 套件中的终端人机问答扩展。

它非常聚焦,只做一件事:向模型暴露一个名为 ask_user_question 的工具,在终端底部渲染带选项说明、支持预览对比与自定义补充的多标签问卷界面。

2. 解决什么问题

直接让模型遇事停下来问用户,模型往往会吐出一长段文字提问,用户不得不在输入框里写一大段回复,或者干脆放任模型自己猜错方向后返工一小时。

把澄清动作结构化成“最多 4 题 × 每题 2–4 个带利弊说明的选项 + 可随时自由补充”,交互耗时大幅压缩。

3. 作用原理(事件钩子与工具注册层)

注册带强类型 JSON Schema 的 ask_user_question 工具,在 execute() 阶段通过终端 TUI 组件接管输入并返回结构化答案。

  • 模型判断需求存在关键设计分叉(例如缓存策略、状态落盘位置、错误回退语义)时,主动调用 ask_user_question 工具并传入最多 4 个问题、每个问题 2–4 个带说明的选项(可选附带 Markdown/ASCII preview 预览框)。
  • 工具 execute() 执行期间在 TTY 环境下向终端发送一次响铃信号(\x07),并用自定义 TUI 在终端底部打开多标签分页问卷。
  • 用户用方向键、Tab 与 Enter 选择,按 n 附加备注,或选中末行“Type something.”展开多行输入(支持 Shift+Enter 换行与 Ctrl+G 调起外部编辑器),在 Submit 标签页确认后将结构化 JSON 选择交还模型。

4. 怎么装与基本配置

  • 执行 pi install npm:@juicesharp/rpiv-ask-user-question 后重启 Pi 会话即可生效,无需额外配置文件。
  • 支持与同系列待办扩展 @juicesharp/rpiv-todo 搭配使用,一个管动手前澄清,一个管执行中清单。

5. 和同类怎么选

相比自带完整计划状态机的工具,它零心智负担、只在模型真正拿不准时被调用,适合几乎所有工作流作为底层配件。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
@narumitw/pi-plan-mode pi-plan-mode 是一整套 /plan 只读协作模式(包含草案预览、批准流转和新会话切换),而 rpiv-ask-user-question 只是一个独立的澄清工具。 平时不爱切模式、只希望模型拿不准时能弹出清晰选择题选一下,选 rpiv-ask-user-question。
@plannotator/pi-extension 侧重浏览器可视化审阅整份计划文件或代码 Diff 批注。 选型决策用 rpiv-ask-user-question 快速拍板,长计划与代码审阅用 Plannotator。

同方向对比包与顺序阅读

@narumitw/pi-plan-mode

在终端内复刻 Codex 风格只读 /plan 协作模式:安全探索、分屏预览计划、批准后可切新会话执行。

阅读该包机制详评

@plannotator/pi-extension

把计划审查、消息批注与代码 PR Diff 评审从终端搬进浏览器可视化界面的交互扩展。

阅读该包机制详评

05 计划、评审与人机交互

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「@juicesharp/rpiv-ask-user-question」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)