SuperAPI AI 工具集

ask-ui

办公与效率

查看项目

更新于 10-15 19:48

技能介绍

用途:Ask UI 作为展示与持久化适配器,把一批问题渲染成本地网页表单,用户提交后答案写入 JSON,供调用方工作流继续使用。问题的生成与推理仍留在调用方。

主要能力:支持单选、多选、自由文本三类题目;支持必填与选填(选填需显式写 "required": false);支持条件题分支(showWhen,只能指向排在前面的题);支持上下文字段、推荐选项及理由;正文与背景支持 Markdown(GFM)与 Mermaid 图表;支持本地文件链接(仅放行文档与图片类扩展名);草稿自动保存,刷新或重开可恢复。

使用方式:标准路径为后台运行 node <ASK_UI_SKILL_DIR>/scripts/ask-ui.mjs ask --input <questions.json>,仅把 stdout 重定向到文件,stderr 留在控制台以显示 URL 与 ask-ui-id;输出 URL 后结束本轮,等 harness 完成通知,再读 stdout 文件继续。故障恢复用 resume --id <askId>;手动回退用 create,用户回复「已提交」后再 resume;结束后用 complete --id <askId> 清理。

适用场景:需要用户拍板或确认、一批含两个及以上独立问题、问题间有依赖需分支、更正已提交答案,以及 grill、头脑风暴、方案选型、需求澄清等工作流。

限制:运行时要求 Node ≥ 18;选择题至少两个选项,不接受字符串选项,无「其他」选项;answers.json 提交后不可变;仅在下表列出的故障情形才用 resume;唤醒适配器为可选增强,需用户同意,Codex thread id 只能由宿主提供。开发时只改 scripts/**/*.mts,.mjs 为编译产物。