SuperAPI AI 工具集

explain

通用与其它

查看项目

更新于 10-16 07:26

技能介绍

用途:把任意主题按多种输出格式进行解释,格式取自 Karpathy 的 ladder。支持四种格式:1 文字(ASD-STE100 简化技术英语,机器校验);2 示意图(单页 SVG);3 互动网页;4 带旁白视频。

主要能力:可同时选择多种格式,先写一份 5-7 个要点、有顺序的统一提纲,再据此生成各格式,保证内容一致。格式 1 始终为英语(STE 是受控英语);语言选项适用于格式 2-4,支持繁体中文与 English。

使用方式:参数可含格式编号,如 /explain 1,4 how TCP handshakes work。未给编号时通过 AskUserQuestion 一次提两问:生成哪些格式(多选)与语言。Claude Code 使用 AskUserQuestion 和 Artifact;其他 agent 用纯文本问同样问题,并把 HTML 写到输出目录而非发布 Artifact。各格式须只读对应参考文件后执行:格式 1 references/text.md,输出经 scripts/ste-check.mjs 校验;格式 2 references/diagram.md,单页 SVG 以 Artifact 发布;格式 3 references/web.md,互动页面以 Artifact 发布;格式 4 references/video.md,生成 video.mp4 并用 ffprobe 验证。所有路径相对 SKILL.md 所在目录,脚本以 node <该目录>/scripts/... 运行。格式 2-4 文件输出到 ${EXPLAIN_OUT:-$HOME/Documents/explainers}/<topic-slug>/。

环境要求:Node >= 22,在技能目录执行一次 pnpm install(安装 playwright-core);需要 Google Chrome(playwright-core 用于截图和视频渲染);格式 4 需要 ffmpeg(含 ffprobe)。语音顺序:ElevenLabs(若设置 ELEVENLABS_API_KEY)、经 uv 的本地 Kokoro、macOS say;Kokoro 支持中文(zh-TW)与英语,无需全局 Python,首次使用下载模型到 ${XDG_CACHE_HOME:-$HOME/.cache}/explain-kokoro/。可用 EXPLAIN_TTS=elevenlabs|kokoro|say 强制指定引擎(出错不回落)。

限制:格式 1 固定为英语 STE;语言仅影响格式 2-4;各格式依赖上述运行环境与命令行工具;检查失败且无法修复时需明说。收费、价格、平台与效果等资料暂未提供。