笔记写得勤快，但画流程图时总卡壳？
在团队文档协作或项目复盘中，图表制作往往是最耗时的“体力活”。Obsidian Visual Skills 并非传统的插件，而是一套为 AI (Claude Code) 量身定制的“画图技能包”。它通过将绘图流程自动化，让你只需通过自然语言描述，即可一键生成高质量的可视化图表。
一、技术原理：AI 如何“学会”画图？
Obsidian Visual Skills 的本质是 Claude Code 的提示词扩展（Skills）。它不依赖复杂的 SaaS 服务端配置，而是通过将 Skill 文件植入 Claude 的配置目录，赋予 AI 直接操作本地文件系统 的能力。
在这种机制下，你无需学习复杂的绘图语法，只需使用“人话”下达指令，Claude 就会直接生成符合 Obsidian 规范的 .md 或 .canvas 源文件。
| Excalidraw | Mermaid | Canvas |
|---|---|---|
 |
 |
 |
| 手绘风格 | 层级流程图 | 彩色卡片布局 |
二、可视化三件套：场景选型指南
该套件包含三个核心模块，你可以根据不同的沟通场景选择对应的 Skill：
🎨 Excalidraw 生成器
适用场景： 方案提案、向领导汇报、需要“手绘温度”的非正式文档。
- 生成包含 JSON 数据的
.md文件。 - 自动应用 Excalifont 字体，营造手绘美感。
- 完美支持中文字符渲染。
🚀 指令示例：“帮我画一个 CI/CD 流程图”
⚙️ Mermaid 可视化器
适用场景： 技术架构图、API 时序图、状态机、研发内部技术沟通。
- 基于代码生成，极其方便通过 Git 进行版本管理。
- 内置语法纠错逻辑，降低渲染失败率。
- 支持语义化配色，自动区分功能模块。
🚀 指令示例：“生成登录认证的时序图”
🧩 Obsidian Canvas 创建器
适用场景： 深度头脑风暴、复杂知识体系梳理、将长文拆解为卡片墙。
- 智能布局： 自动计算节点间距，避免内容重叠。
- 视觉分级： 提供 6 种预设颜色，自动区分内容层级。
🚀 指令示例：“把这篇文章整理成 Canvas 思维导图”
三、快速部署 SOP
前提条件： 确保你的环境中已安装 Claude Code CLI 和 Obsidian。
部署过程非常简单，只需将 Skills 文件夹迁移至 Claude 的配置目录即可激活：
# 1. 克隆 Skills 仓库
git clone https://github.com/axtonliu/axton-obsidian-visual-skills.git
# 2. 安装 Skills (macOS/Linux)
# Windows 用户请手动将文件夹复制至 %USERPROFILE%.claudeskills
cp -r axton-obsidian-visual-skills/excalidraw-diagram ~/.claude/skills/
cp -r axton-obsidian-visual-skills/mermaid-visualizer ~/.claude/skills/
cp -r axton-obsidian-visual-skills/obsidian-canvas-creator ~/.claude/skills/四、避坑指南：如何提升输出稳定性？
由于该套件目前处于 Experimental (实验性) 阶段，为了获得最佳的绘图效果，建议采取以下策略：
- 分步引导： 避免一次性输入 5000 字长文。建议先让 Claude 总结出“6-10 个关键节点及其关系”，确认无误后再发送“请画图”指令。
- 文本清洗： Mermaid 在处理中文夹杂复杂符号（如 LaTeX）时可能会渲染失败，建议在绘图前要求 AI 先进行文本简化。
📥 资源获取
Obsidian Visual Skills 旨在构建 AI 逻辑 与 可视化笔记 之间的桥梁。通过将繁琐的绘图工作交给 AI，你可以将更多精力放在思考本身。
GitHub 开源仓库： Axton Obsidian Visual Skills Pack
* 本项目开源免费，欢迎 Star 收藏。
