@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 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。 |
看完「@juicesharp/rpiv-ask-user-question」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。