SuperAPI AI 工具集

wokitoki

通用与其它

查看项目

更新于 10-16 01:28

技能介绍

WokiToki(命令名 toki)是一个本地、阻断式反馈 CLI,由 AI 在对话中途调用,以收集结构化、锚定、逐点的用户反馈。它以“对讲机”为品牌理念:来回往复,一次回答一件事。

用途:当需要一次性收集超过 3 个决策点(单选/多选/开关混合)、或用户可能想逐点回应的长篇多段说明与报告、或需要回复锚定到确切短语时使用。1–2 个选项选择、单个是/否、≤3 个简单决策用 AskUserQuestion;非交互/CI/无人在浏览器前时不使用,直接输出纯文本。

主要能力:一次运行即一个引擎,spec 是一组 blocks 列表。含 controls 的 block 是问题,不含 controls 的 block 是报告段落,混合即混合表单。控件类型有 single(单选)、multi(多选)、toggle(布尔开关,无 options)。controls.required 与 text.required 相互独立,每 block 可任意组合。Result 中 quotes 为用户高亮的精确短语,images 仅在用户粘贴图片时出现,为 ~/.toki/ 下的绝对路径。

使用方式:首次调用前做 Phase 0 二进制检查,缺失则构建:command -v toki >/dev/null 2>&1 || bun build --compile "<skill-dir>/cli/index.ts" --outfile "$HOME/.bun/bin/toki"(<skill-dir> 为 ~/.claude/skills/wokitoki)。回退方案:bun "<skill-dir>/cli/index.ts" <specPath>。将 spec 写入 JSON 文件(约定 ~/.toki/spec-<name>.json),运行 toki <specPath>(阻断),标志:--port <n>(默认 4747,忙则自增)、--timeout <min>(默认 1440=24h,可小数)、--no-open、--help。stdout 仅含 Result JSON,进度与错误走 stderr。退出码:0 提交成功;1 超时或运行时错误(视为用户离开而非失败);2 spec 无效(修复后重跑);130 Ctrl-C 取消。Result 备份写至 ~/.toki/result-<name>.json,但 stdout 为准。用户不在协议:退出码 1 时发简短待命消息并表示可重启,保持同 spec 可随时重跑。

限制:UI 外壳为英文,block 内容语言由作者决定;无外部依赖(仅 Bun 内置);默认超时 24h;运行位置不影响仓库(不写 cwd)。价格、平台等收费信息暂未提供。