GitHub 热门项目推荐:anatomy(JavaScript|16020 Star)

这个项目有什么用

anatomy 是一个面向 AI 编程助手(Agent)的 skill:当你让 Claude 等助手解释一个技术概念时,它会把这个概念「做」成一个可交互的等距(isometric)插图——用几十个带阴影的小零件拼出一台真实运转的机器,让机器的工作过程本身就等于概念本身。比如「缓存键在数据没变时跳过计算」会被做成一把只有所有弹子都对齐才能转动的弹子锁。

它替代的是手工绘制示意图、拼贴静态图片或写大段文字描述的工作。典型场景包括:向团队解释限流器、缓存、GPU 上下文复用等抽象机制;制作技术博客或文档里的交互式配图;教学演示。适合需要频繁产出技术示意图的开发者、技术写作者和团队。

核心特性

  • 用实物隐喻解释概念:助手会先发明一个「工作方式即概念」的物理装置,再用零件把它搭出来,而不是画流程图。
  • 多技术栈渲染:图形以 SVG 为主体,可叠加 WebGL shader 与 3D 效果,例如 raptor-engine 示例中引擎和支架是 SVG,尾焰是同一等距相机下的 WebGL shader。
  • 自带交互与实时读数:图形放在带标题、提示和实时读数的卡片里,可用指针和键盘驱动,图中每个数字都来自驱动零件的同一套小模型。
  • 自我校验:助手会放大检查每个关节,示例 raptor-engine 附带审计,证明静止、拆开以及中间每一帧都没有管道互相穿透。
  • 零依赖安装:官方说明不需要 API key,也不需要 npm install,工具包只用 Node 内置模块。
  • 支持多种 Agent:可在 Claude Code、Antigravity、OpenCode、Codex 和 MiniMax Code 中运行。

怎么安装

前提:安装方式依赖 Node.js;README 提到 skills CLI 1.7.1 版本要求 Node.js 22.20 或更高。无需 API key。

  1. 用 skills CLI 安装(默认装进当前项目,并询问要为哪些 Agent 配置):
    npx skills add wheresryan22/anatomy -g
  2. 若想跳过询问,可加 -a claude-code、-a antigravity、-a opencode、-a codex 或 -a minimax-code 指定单个 Agent。
  3. 也可以用 git 克隆:把仓库克隆到对应 skill 目录,使 SKILL.md 位于 /anatomy/SKILL.md。Claude Code 用 ~/.claude/skills/anatomy 或 .claude/skills/anatomy;Antigravity 用 ~/.gemini/antigravity/skills/anatomy 或 .agents/skills/anatomy;OpenCode 用 ~/.config/opencode/skills/anatomy 或 .opencode/skills/anatomy;Codex 用 ~/.agents/skills/anatomy 或 .agents/skills/anatomy;MiniMax Code 用 ~/.minimax/skills/anatomy 或 .minimax/skills/anatomy。
  4. macOS 或 Linux 上也可一行下载安装(以 Claude Code 为例):
    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
  5. 若在运行中的会话里安装,Claude Code 会自动识别新 skill;如果会话启动时 skills 目录尚不存在,执行 /reload-skills。Antigravity、OpenCode 以 /anatomy 出现在聊天中,不显示则重启;Codex 在 /skills 下列出并用 $anatomy 运行;MiniMax Code 以 /anatomy 出现,不显示则重启 mcode。

怎么使用

安装后在 Claude Code 中直接下达指令即可,最小示例如下:

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

在 Antigravity、OpenCode、MiniMax Code 中使用同样的 /anatomy 命令;在 Codex 中输入 $anatomy。

进阶方面,README 说明图形分浅色与深色两种主题,浅色是 skill 优先设计的主题(含 shader)。另外 Codex 运行在沙箱中时可能阻止 headless Chrome 自检,图形仍会生成,只是检查失败。可按优先级处理:在 Codex 询问时批准该命令在沙箱外运行(需要默认的 approval_policy = "on-request"),或在 ~/.codex/config.toml 中放行:

approval_policy = "on-request"
sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true
writable_roots = ["/tmp"]

README 提醒较新的 Codex 版本可能使用不同的配置名,请查阅对应版本的配置参考。

适用场景与注意事项

  • 适合:需要把抽象机制讲清楚的技术分享、文档配图、教学演示,尤其是希望插图能交互、能拆解查看的场合。
  • 不适合:只需要一张静态流程图或对渲染体积敏感的页面——CLI 会复制整个仓库(含示例,约 10 MB)。
  • 自检依赖 headless Chrome,在受限沙箱(如 Codex)中可能失败,需要额外放行配置。
  • 3D 模式在 README 中标注为 beta。
  • 项目采用 MIT 协议,可自由使用与修改。

项目地址

仓库:https://github.com/wheresryan22/anatomy
作者/组织:wheresryan22
项目主页:https://skills.wheresryan.sh/anatomy

它是一个把「解释概念」变成「搭建可交互实物插图」的 Agent skill,安装轻量、支持多个助手,是否合用取决于你是否需要这种交互式等距图形。

© 版权声明
THE END
喜欢就支持一下吧
点赞8 分享