D3 可视化 技能
使用明确的比例尺、响应式尺寸和清理机制,构建定制 D3 图表与交互。
社区 · chrisvoncsefalvay| 作者 | chrisvoncsefalvay |
|---|---|
| 许可证 | No licence file |
| 来源 | chrisvoncsefalvay/claude-d3js-skill · GitHub 上的 SKILL.md |
| 项目官网 | d3js.org |
| 适用于 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| 读取源文件日期 |
d3-viz 指导在 JavaScript 框架或原生 JavaScript 中制作定制 D3.js 图表、网络和地理可视化,同时介绍 D3 控制 DOM 与框架渲染元素两种模式。
示例涵盖比例尺、坐标轴、数据关联、响应式测量、过渡和交互。它们只是起点;需要在实际应用中核对数据、生命周期、键盘访问及不可信标签。
摘自该技能的 SKILL.md: D3.js Visualisation
功能
- 选择视觉编码,并明确谁负责 DOM。
- 准备数据、比例尺、边距和响应式尺寸。
- 添加交互、清理、无障碍替代内容和性能检查。
产出内容
- 可视化代码、比例尺及框架集成。
- 适配后的图表模板和数据处理指引。
适用场景
- 制作标准图表库以外的定制图表。
- 修复响应式尺寸或 D3 与框架的控制冲突。
不适用的场景
- 期待 3D 渲染器,或认为 SVG 有标签就具备完整无障碍支持。
所需条件
- JavaScript 应用,以及兼容的 D3 模块或经过明确选择的 CDN 构建。
- 用于渲染和交互验证的浏览器;不强制要求付费账户或 MCP 服务。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | D3 流程、图表模式、交互和无障碍指引。 |
references/ | 比例尺、颜色和可视化模式参考。 |
assets/chart-template.jsx | 需要适配到目标框架的图表起始模板。 |
assets/interactive-template.jsx | 带生命周期清理责任的交互起始模板。 |
2026-11-18 在仓库中查到的许可证:No licence file。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 制作响应式 D3 散点图,附数据表和可用键盘访问的点详情。
- 用 D3 计算比例尺,由 React 控制图表的 SVG 节点。
- 修复尺寸变化后的清理,避免把不可信数据插入提示框 HTML。
如何安装 d3-viz
D3 与源内容权利
复制含 assets 和 references 的完整根技能文件夹,在目标项目中单独安装 D3。
此技能仓库中没有许可证文件。D3 自身的许可不会自动适用于这份独立的社区指引。
技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:
Claude Code:把文件夹复制到技能文件夹
把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。
git clone --depth 1 https://github.com/chrisvoncsefalvay/claude-d3js-skill.git
mkdir -p ~/.claude/skills/d3-viz
git -C claude-d3js-skill archive HEAD | tar -x -C ~/.claude/skills/d3-vizClaude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /d3-viz,或直接描述任务。
在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。
Codex、Gemini CLI、Cursor 和 GitHub Copilot
这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:
git clone --depth 1 https://github.com/chrisvoncsefalvay/claude-d3js-skill.git
mkdir -p .agents/skills/d3-viz
git -C claude-d3js-skill archive HEAD | tar -x -C .agents/skills/d3-viz| 智能体 | 项目文件夹 | 用户文件夹 | 说明 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | 输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | 在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | 适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。 |
这些步骤的来源
已于 2026-11-14 对照各厂商的文档核实:
几何计算与控制权
避免两个系统更新同一批 SVG 节点。明确每部分由 D3 还是框架控制,并在清理时移除观察器、事件和模拟器。
在真实浏览器中测试指针和键盘交互。代码示例和 ARIA 标签不代表完整无障碍支持。
关于 d3-viz 的常见问题
这是官方 D3 技能吗?
不是。这是社区指引;独立网站链接指向 D3 官方文档。
必须让 D3 控制 DOM 吗?
不必。原说明也介绍由 D3 计算数据、由框架渲染元素的模式。
示例能处理所有数据取值范围吗?
不能。请按实际数据验证定义域、缺失值、正负值、格式和比例尺选择。
示例提示框能安全处理任意标签吗?
不一定。使用 HTML 字符串的示例,在处理不可信数据时需要转义或改用纯文本渲染。
更多 AI 技能
相关技能
Dashmotion 技能
社区 · Mars (csthink)生成带结构检查的独立 HTML 动画流程图和架构图。CSV 数据摘要 技能
社区 · coffeefuelbump使用本地 Python 图表检查 CSV 结构、缺失值和数值摘要。GenAI Mesh Gradient 技能
社区 · Yanice Yang (9929y)将视觉需求转成可编辑的 Figma 渐变、分层 SVG 或带参数的浏览器渲染。Matplotlib 技能
社区 · K-Dense使用明确坐标轴创建科学绘图。AI信息图 技能
社区 · K-Dense通过OpenRouter生成及审查栅格信息图。Markdown Mermaid写作 技能
社区 · Clayton Young / K-Dense使用符合版本的Mermaid结构图编写Markdown。