Agent Skills
返回列表
交互式CLI提问

交互式CLI提问

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/ya2026190

技能介绍

你在解决什么问题

写命令行工具的人大多踩过同一个坑:readline 能拿到输入,但一旦需要让用户在几个选项里挑一个,或者确认"要覆盖 src/ 吗",就得自己拼提示符、处理大小写、补回退逻辑。结果终端里提示样式不一致,用户按了 Ctrl+C 之后进程还挂在那里。

这个技能只负责一件事:把人机交互提问这一段标准化。不管是脚手架初始化时的问答,还是本地小工具需要确认、单选,都可以直接用 @clack/prompts 渲染干净的 text / select / confirm 流程,拿到结构化答案。

它是怎么工作的

核心是一条问答链:先定义问题列表,再逐个交给 @clack/prompts 渲染。文本输入走 text,选择题走 select,布尔确认走 confirm。上层负责统一外观和光标行为,调用方拿到的是最终字符串或布尔值。

有三点硬约束值得注意:

  • 必须处理取消:每个提示调用都要检查 isCancel,必要时调用 cancel,让进程干净退出,不要留下半截答案。
  • 实现要点注释标 小四原创,用来区分自写逻辑和上游库的行为,后续排查更清楚。
  • 它不构建完整的 Ink/React 终端应用,只承担提问这一小段职责。

典型流程:定义一套项目基本信息的问题 → 依次执行 askProjectBasics 或等价的 text/select 调用 → 自测 Ctrl+C,确认取消路径不会抛未捕获异常。

边界在哪

它面向一次性、线性的问答,不适合常驻进程的交互界面。需要持续刷新的实时仪表盘、增量渲染的图表,应该直接用 Ink 自建。

另一个常见坑是忽略 isCancel:用户按 Ctrl+C 时函数返回的是取消标记而不是正常值,不写分支就会让后续逻辑拿着 undefined 往下跑,最后抛出难以定位的异常。凡是破坏性操作的确认,结果都应当立即被消费,而不是留在内存里等后面才判断。

使用场景

  • 编写脚手架初始化脚本时,用统一美观的文本与选择题收集项目信息
  • 为本地构建脚本添加覆盖前确认步骤,确保破坏性操作有明确回复
  • 为运维工具实现多选环境参数配置,提升日常部署前的人机交互体验
  • 编写交互问答装置时,用结构化选择器替换裸 readline 输入,使会话更清晰

适合人员

  • 独立开发者:需要为自用 CLI 工具添加美观的初始化问答与选择确认
  • 前端工程师:编写内部脚手架时想替换 readline 获得更清晰的项目配置交互
  • 后端运维:为部署脚本加入确认与多选参数配置,降低人机交互出错率
  • 技术博主:撰写 CLI 开发教程时需要一个展示结构化交互最佳实践的实例