SuperAPI AI 工具集

explain

前端与建站

查看项目

更新于 10-16 00:21

技能介绍

用途:该技能用于生成解释性文档,面向代码、系统、数据关系等主题,产出简洁、有证据支撑的 Markdown 和独立 HTML。它只做解释,不实现、修复或修改被解释对象。

触发限制:仅限手动触发。若用户未明确点名调用 explain,则停止,不撰写 Markdown/HTML,也不安装渲染依赖,并说明该技能为手动专用。

主要能力与规则:先给出答案或心智模型,再补充必要背景;论断须基于提供的或当前代码、数据、产物或对话上下文,代码需引用路径与符号,并区分观察到的行为与推断;默认 3–6 个章节、每段不超过三句、最多一张有用图表、1–2 段聚焦摘录(通常不超过 15 行);不在正文、代码、表格、图表间重复同一信息;对密钥、凭据、令牌、PII 等敏感值做脱敏。设计前必须阅读 references/explanation-design.md。

使用方式:先解读主题、受众、深度、输出位置与标题,仅在存在重大歧义时提问;检查上下文后再起草;缺失的当前外部论断用 web-research 技能检索,不可用则说明限制并省略无支撑论断。Markdown 写入用户指定位置,未指定则用系统临时目录。依赖不可用时,从技能目录执行一次:npm ci --ignore-scripts --no-audit --no-fund。渲染命令:node "<skill-dir>/scripts/render-explainer.mjs" --input "<markdown-path>" --output "<html-path>"。默认在浏览器打开,可用 --no-open 抑制,--title 设标题,--force 覆盖。

适用场景与限制:适合需要解释代码、系统或数据关系的场景。渲染失败时须报告诊断且不得声称已生成 HTML;浏览器启动警告不影响产物有效性。返回 Markdown 与 HTML 绝对路径及一行摘要,并披露研究、浏览器或渲染的跳过/失败情况。其他细节暂未提供。