让开源，少一点语言距离。
npm包中文文档

@fitchmultz/pi-ask-question

中文文档
0.6.17发布于 2026/11/15MITES Module零依赖构建来源已验证近 30 天下载 3435

Pi extension that adds an interactive ask_question tool and /grill-me pressure-test mode

原始使用文档
中文原文
文档目录6 节
  1. Install
  2. Try it
  3. Limits
  4. Check requirements with /grill-me
  5. Reference
  6. License

pi-ask-question

This Pi extension asks for your decisions before the agent continues a task. Use /grill-me to guide the agent through unclear requirements.

Pi calls ask_question, shows choices, and returns your answer to the agent. Five minutes without interaction returns an AFK reply.

Install

Requires Node.js and a supported Pi release. See the compatibility requirements. Official Pi releases and Mitch's Pi fork are supported.

Run these commands:

pi install npm:@fitchmultz/pi-ask-question
pi

Use /reload if Pi is already open. See Git installation for the alternative source.

Try it

Send this request to Pi:

Plan a settings page. Use ask_question to ask which settings to include first.

Select a choice or select Type a custom answer. Multi-select questions let you select more than one choice.

Use Up/Down to move between choices. Press Enter to answer. For multi-select questions, press Space to change selected choices. Submit question sets and multi-select answers from the final review.

Press Ctrl+O to read the conversation, then press it again to return to the question. Your current answer stays in place.

Escape leaves the custom answer editor; otherwise, it cancels the question. Your editor draft stays unchanged. See terminal controls for question navigation, long text, and custom bindings.

Limits

An untouched question times out after five minutes, and the agent receives an AFK reply to continue already-authorized work and routine choices without treating the timeout as an answer to a material question or as approval. Once you interact, there is no time limit for that question or question set. Each new call starts its own timer.

In RPC mode, Pi learns about interaction when the client submits a dialog choice; navigating an unsubmitted dialog is not visible to Pi.

The tool keeps saved answers. It does not submit unsaved custom answer text or select an answer for you.

Question dialogs require the terminal UI or an RPC client that supports Pi dialogs. Pi does not offer ask_question to the agent in print mode, JSON mode, or SDK sessions without a UI, such as subagent children. See where the tool is offered.

Check requirements with /grill-me

Enable the mode before your request:

/grill-me on

The mode guides the agent to check available evidence and ask one blocking question at a time. The agent puts its suggested answer first. The agent can continue with obvious, low-risk steps.

Use /grill-me to toggle the mode. Use /grill-me off to disable the mode. Use /grill-me status to check the mode.

The terminal footer shows grill-mode when enabled. Pi saves the setting in your current session branch. The setting survives /reload.

In sessions without a UI, such as print and JSON modes, the agent asks questions in normal text.

Reference

Tool reference covers input examples, result fields, and UI details. Cooperative TUI answers documents the event protocol for trusted extensions.

Development covers local tests, host compatibility, and publication. See the changelog for changes. Report an issue if the extension fails.

License

MIT, Mitch Fultz.

版本与发布记录

@fitchmultz/pi-ask-question 共发布 19 个版本，首次发布于 2026/10/06；过去 12 个月发布了 19 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本发布日期距今
0.6.17latest2026/11/15今天
0.6.162026/11/122 天前
0.6.152026/11/113 天前
0.6.142026/11/114 天前
0.6.132026/11/114 天前
0.6.122026/11/114 天前

关于 @fitchmultz/pi-ask-question 的常见问题

@fitchmultz/pi-ask-question 是什么？

Pi extension that adds an interactive ask_question tool and /grill-me pressure-test mode

如何安装 @fitchmultz/pi-ask-question？

在项目目录运行 npm install @fitchmultz/pi-ask-question，或使用 pnpm add / yarn add / bun add。

@fitchmultz/pi-ask-question 支持 TypeScript 吗？

该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fitchmultz__pi-ask-question 是否存在。

@fitchmultz/pi-ask-question 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@fitchmultz/pi-ask-question 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=24.22.3 <25 || >=26.13.1。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@fitchmultz/pi-ask-question 可以商用吗？

@fitchmultz/pi-ask-question 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@fitchmultz/pi-ask-question 的下载量有多少？

根据 npm 官方下载统计，@fitchmultz/pi-ask-question 在 2026/10/15 – 2026/11/13 这 30 天内被下载 3,435 次，日均约 115 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@fitchmultz/pi-ask-question 还在维护吗？

最新版本 0.6.17 发布于 2026/11/15（今天）；至今共发布 19 个版本，其中过去 12 个月发布了 19 个；首次发布于 2026/10/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。