ByteNoteByteNote

字节笔记本

2026年5月3日

Obsidian Skills 组合使用说明

API中转
¥120

本文档本身就是 note-creator + obsidian-markdown + json-canvas 三个 skills 组合使用的完整示例。

核心概念

  • note-creator: 自动分类到 20-学习笔记/
  • obsidian-markdown: 使用 frontmatter、callouts、wikilinks、mermaid
  • json-canvas: 创建可视化流程图

系统架构

mermaid
graph TD
    A[用户请求] --> B[note-creator<br/>项目级 Skill]
    B --> C{文件类型}
    C -->|.md| D[obsidian-markdown<br/>全局 Skill]
    C -->|.base| E[obsidian-bases<br/>全局 Skill]
    C -->|.canvas| F[json-canvas<br/>全局 Skill]
    D --> G[保存到分类目录]
    E --> G
    F --> G

Skills 配置

本地 Skill (note-creator)

属性
位置.claude/skills/note-creator/
功能笔记分类、目录管理、模板提供
特点项目级,仅本笔记库可用

全局 Skills

Skill位置功能
obsidian-markdown~/.claude/skills/obsidian-markdown/OFM 语法、wikilinks、callouts、math、diagrams
obsidian-bases~/.claude/skills/obsidian-bases/数据库视图、过滤、公式、聚合
json-canvas~/.claude/skills/json-canvas/思维导图、流程图、可视化

工作流程

标准执行流程

mermaid
sequenceDiagram
    participant User as 用户
    participant NC as note-creator
    participant OM as obsidian-markdown
    participant JC as json-canvas

    User->>NC: 创建笔记请求
    NC->>NC: 识别类型 & 确定目录
    NC->>OM: 创建 .md 内容
    OM->>OM: 使用 OFM 语法
    NC->>JC: 创建 .canvas (可选)
    JC->>JC: 添加节点和边线
    NC->>User: 保存到目标目录

调用优先级

  1. 首先: note-creator 确定目录和分类
  2. 其次: 根据文件类型选择 content skill
  3. 最后: 组合使用完成复杂任务

使用场景

场景 1: 学习笔记 (Markdown 单独使用)

用户输入: "创建一个 React Hooks 学习笔记"

执行流程:

  • note-creator 识别为学习笔记 → 20-学习笔记/
  • obsidian-markdown 创建内容 → React-Hooks学习.md

示例输出:

markdown
---
title: React Hooks 学习
tags:
  - react
  - frontend
category: 学习笔记
created: 2024-01-08
---

# React Hooks

> [!tip] 核心概念
> Hooks 让函数组件拥有状态和生命周期

## useState

```javascript
const [count, setCount] = useState(0)

参考

  • [[React 官方文档]]
text

### 场景 2: 工具命令 + 流程图 (Markdown + Canvas)

**用户输入**: "记录 Docker 部署流程,带流程图"

**执行流程**:
- note-creator 识别为工具命令 → 40-工具脚本/
- obsidian-markdown 创建文档
- json-canvas 创建流程图
- 输出: Docker部署流程.md + Docker部署.canvas

### 场景 3: 书籍追踪系统 (Markdown + Bases)

**用户输入**: "创建书籍追踪系统"

**执行流程**:
- note-creator 识别为书籍管理 → 10-书籍管理/
- obsidian-markdown 创建模板
- obsidian-bases 创建视图
- 输出: 书籍模板.md + 书籍追踪.base

### 场景 4: 知识体系导图 (Canvas 单独使用)

**用户输入**: "创建前端技术栈思维导图"

**执行流程**:
- note-creator 识别为思维导图 → 30-思维导图/
- json-canvas 创建导图
- 输出: 前端技术栈.canvas

## 文件类型映射

| 文件类型 | 扩展名 | 主要 Skill | 辅助 Skill | 默认目录 |
|---------|--------|-----------|-----------|---------|
| 笔记文档 | `.md` | obsidian-markdown | note-creator | 根据内容分类 |
| 数据库视图 | `.base` | obsidian-bases | note-creator | 10-书籍管理/ 等 |
| 思维导图 | `.canvas` | json-canvas | note-creator | 30-思维导图/ |
| 图片资源 | `.png/.jpg` | - | note-creator | 99-资源附件/ |

## 常用组合

| 任务 | Skills 组合 | 输出 |
|------|-----------|------|
| 学习笔记 | `note-creator + obsidian-markdown` | `.md` 文档 |
| 命令文档 | `note-creator + obsidian-markdown` | `.md` 文档 |
| 流程图 | `note-creator + json-canvas` | `.canvas` 导图 |
| 数据库 | `note-creator + obsidian-bases` | `.base` 视图 |
| 技术教程 | `note-creator + obsidian-markdown + json-canvas` | `.md + .canvas` |

## 最佳实践

### 1. 明确请求

好的请求示例:
- "创建一个 Python 装饰器学习笔记"
- "记录 Docker Compose 常用命令"
- "创建书籍阅读追踪系统"

### 2. 利用组合优势

创建技术教程时,组合使用多个 Skills:
- note-creator → 确定目录
- obsidian-markdown → 创建教程
- json-canvas → 流程图
- 输出完整的可视化教程

### 3. 使用 Wikilinks 建立关联

```markdown
## 相关资源
- [[note-creator Skill 配置]]
- [[Skill-creator官方规范]]
- [[Obsidian-Skills协同使用指南]]

## 流程图
![[Skills组合使用流程.canvas]]

相关资源

  • [[Skills组合使用流程.canvas]]
  • [[note-creator Skill 配置]]
  • [[Skill-creator官方规范]]
  • [[Obsidian-Skills协同使用指南]]
分享: