SkillCast 首批精选 Skill 正在整理中 查看市场 →
人工核验

Anatomy:用等距插画直观解释技术概念

Anatomy 是一个 Agent Skill,让 AI 将抽象技术概念转化为精美的等距交互式插图,支持 SVG、WebGL 和 3D 效果,适合创作者、教育者和技术博主。

等距插画SVGWebGL3D技术可视化交互式图表

这是什么

Anatomy 是一个开源的 Agent Skill,由开发者 wheresryan22 创建,旨在通过构建真实、可工作的物体来直观解释技术概念。它利用 Claude Code 等 AI 代理,生成高度精细的等距(isometric)交互式插图,这些插图以 SVG 为核心,可选配 WebGL 着色器和 3D 效果,让抽象的原理变得触手可及。

该技能的核心思想是:当你要求 AI 解释一个技术想法时,Anatomy 会发明一个物理实体,其工作原理恰好体现了该概念。例如,一个缓存键(cache key)在数据未变化时跳过工作,可以被设计成一个弹子锁,只有当每个弹子都匹配时才能转动。这种“用实物讲原理”的方式,让复杂的技术知识变得直观且易于理解。

Anatomy 生成的每个图形都包含数十个小型、实心、带阴影的部件,并放置在一个带标题、提示和实时读数的框架卡片中。图形会在鼠标悬停和键盘操作下平稳运动,AI 还会通过放大检查每个关节来验证自己的作品。图中显示的每个数字都来自驱动部件运动的同一个模型,确保准确性和一致性。

适合谁

Anatomy 特别适合以下人群:

  • 技术博主和内容创作者:需要将复杂的技术概念以视觉化方式呈现给读者,提升文章或视频的吸引力。
  • 教育工作者:在教学中使用交互式插图,帮助学生更直观地理解抽象原理。
  • 开发者:希望快速生成技术文档中的示意图,或为项目创建精美的可视化组件。
  • 产品经理和技术传播者:需要向非技术背景的受众解释技术方案。

无论你是技术专家还是初学者,只要你有想法,Anatomy 都能帮你将其转化为精美的视觉作品。

能做什么

Anatomy 可以生成三种类型的图形,所有图形共享同一套工具、相机和工艺规则:

类型 说明 示例
SVG 核心类型。实心等距部件,四色调阴影,从后到前绘制,带实时读数和缓动动画。可输出为独立 HTML 页面、独立 SVG 文件或 React/Next.js 组件。 dial-indicator, desk-computer, arcade-cabinet, test-rig
SVG + WebGL 用于线条无法表现的火焰、废气、水、焦散、灯光、辉光、蒸汽等效果。着色器在前后 SVG 之间的画布中运行,使用图形自身的等距相机,因此效果融入图形内部。即使没有 WebGL,SVG 仍可正常阅读。 raptor-engine, ripple-tank
3D(测试版) 支持真正 3D 旋转的部件:可旋转的表盘、转台,可弯曲的手指,可断裂掉落的部件。移动部件每帧重新投影和着色,其余部分保持静态艺术。 turning-dial

每个图形都支持浅色和深色主题,浅色是技能优先设计的主题,包括着色器效果。

使用前准备

要使用 Anatomy,你需要:

  • 安装 Node.js 20.10 或更高版本(技能本身无依赖,仅使用 Node 内置模块)。
  • 一个支持的 AI 代理:Claude Code、OpenCode、Codex 或 Antigravity。
  • 无需 API 密钥,无需额外 npm 安装。

安装方法

Anatomy 是一个标准的 Agent Skill,即一个包含 SKILL.md 的文件夹。你可以通过以下几种方式安装:

使用 skills CLI(推荐)

对于 Claude Code,全局安装:

npx skills add wheresryan22/anatomy -g -a claude-code

对于其他代理,替换 -a 参数:-a antigravity、-a opencode 或 -a codex。若仅安装到当前项目,去掉 -g。

使用 git 克隆

例如,对于 Claude Code 用户级安装:

git clone https://github.com/wheresryan22/anatomy.git ~/.claude/skills/anatomy

对于其他代理,将目标路径替换为对应的技能文件夹。

下载 ZIP

从 GitHub 下载 ZIP 文件,解压后将文件夹重命名为 anatomy,移动到对应的技能目录。macOS/Linux 一行命令示例:

mkdir -p ~/.claude/skills/anatomy && curl -L https://github.com/wheresryan22/anatomy/archive/refs/heads/main.tar.gz | tar -xz --strip-components=1 -C ~/.claude/skills/anatomy

安装后,Claude Code 会在会话中自动识别新技能。如果技能文件夹在会话启动时不存在,运行 /reload-skills。其他代理可能需要重启。

使用示例

安装完成后,在 Claude Code 中直接输入命令:

/anatomy explain how a token bucket rate limiter works, interactive

在 OpenCode 中使用相同的 /anatomy 命令;在 Codex 中则输入 $anatomy。AI 会生成一个交互式等距插图,展示令牌桶限流器的工作原理。

你还可以尝试其他示例,例如:

  • /anatomy explain how a cache key works —— 生成一个弹子锁插图。
  • /anatomy explain GPU context sharing —— 生成一个龙门绘图仪插图。

生成的图形会以 HTML 页面形式呈现,你可以直接打开查看交互效果。

风险与注意事项

  • Codex 沙箱限制:技能会通过启动无头 Chrome 来检查图形,但 Codex 的沙箱可能阻止 Chrome 运行。此时图形仍会生成,但检查会失败。建议在 Codex 提示时批准在沙箱外运行检查,或调整 ~/.codex/config.toml 中的审批策略。
  • Node.js 版本:确保 Node.js 版本不低于 20.10,否则可能无法正常运行。
  • 3D 模式为测试版:3D 功能仍在开发中,可能不稳定,建议用于实验性项目。
  • 资源占用:生成的图形可能包含大量部件,交互时对性能有一定要求,建议在较新的设备上使用。
  • 开源协议:该项目使用 MIT 许可证,你可以自由使用和修改,但需保留版权声明。

Anatomy 是一个强大的可视化工具,能够将抽象概念转化为精美的交互式插图,极大地提升技术传播的效率。如果你需要向他人解释复杂的技术原理,不妨试试这个技能。

INSTALLATION

安装命令

TERMINAL
npx skills add wheresryan22/anatomy -g -a claude-code
兼容平台Claude Code、Codex、OpenCode、Antigravity
运行环境需要 Node.js 20.10 或更高版本,无需 API 密钥,无额外依赖。
API Key不需要
本地环境需要
费用免费