用途:当用户想真正理解某个概念,而不是要一个快速答案时使用。触发式说法包括「aha」「讲懂 X」「讲讲 X」「X 到底是什么/怎么工作的」「X 和 Y 有什么区别」,或要求图解、可视化、做一页解释、分享给别人看。若两三句话就能答清,则直接回答,不启用本技能;超短摘要、一句话回答、专家向深潜、改写既有文档等场景不使用。
主要能力:生成单文件自包含、零远程渲染依赖的 HTML 页面,按七层骨架组织——一句话核心、为什么存在、直觉类比、真实机制、容易混淆的邻居概念、边界与失败、记忆公式与自测与数字账本。页面用结构图、对比卡片、流程图、步骤模拟器、状态图等视觉形式承载内容,遵循大图少字、动画表现真实状态变化、内置折叠自测题与数字账本。起点按 L1 零基础、L2 相邻背景、L3 已入门三档校准,只调起点与类比,不删层。
使用方式:先用 npx @dimples/aha new <slug> "<概念名>" 生成脚手架,slug 用小写 kebab-case;随后分块编辑填入七层内容与模拟器步骤,取色只用 var(--token),不改 tokens 块;最后运行 npx @dimples/aha check <路径> 过 13 道质量门,再 npx @dimples/aha start 起本地服务(127.0.0.1:7332)并交付文件链接。另有 serve、share 命令;寓言故事与 vgpu 展示层为选配,仅在用户明确要求时启用。
限制:类比必须标注失效边界,不能替代真实机制;第 4 层需至少一个带真实值的实例;数字须可复算或给出来处,比例类数字入账本;不得内联颜色字面量、引入远程渲染依赖、做装饰性动画、出现提问者指代;check 不过需修复而非删内容;默认不做浏览器验证,除非用户要求看效果。