File contents Beautiful Notes 技能
概述
这个技能提供 Obsidian 学术笔记的规划-生成-审查 三代理全流程,确保每篇笔记在知识树中有独特位置、结构清晰、排版精美。
核心流程(三代理)
用户请求 → 规划代理(note-planner) → 写作代理(note-generator) → 审查代理(note-reviewer) → 保存
代理
文件
职责
规划代理
note-planner.md
扫描目录,分析关系,输出规划卡
写作代理
note-generator.md
根据规划卡生成笔记
审查代理
note-reviewer.md
审查笔记质量
阶段1: 规划代理 (note-planner)
强制执行,不跳过
执行步骤:
扫描同级目录,了解已有笔记
分析关系(父话题/子话题/兄弟话题)
输出规划卡(格式见下方)
检查差异化(父子话题开头必须不同)
规划结论:创建新笔记 / 追加到已有 / 终止
规划卡模板 :
## [笔记名] 规划卡
### 基本信息
- 目标目录: [目录路径]
- 笔记类型: [concept/paper/method]
### 关系分析
- 父话题: [XXX] — 开头: "[父话题开头]"
- 子话题: [XXX]
- 兄弟话题: [XXX] — 差异是...
### 关系判定
[DUPLICATE / SUBSUMED / CONTAINS / OVERLAPS / INDEPENDENT]
### 核心定位
[一句话说明在知识树中的位置]
### 必须回答的核心问题
1. [问题1]
2. [问题2]
### 禁止重复的内容
[引导到对应笔记的内容]
### 开头差异化
- 父话题开头: "[父话题开头]"
- 本笔记开头: "[新开头方向]" — 与父话题不同 ✓
### 规划结论
[创建/追加/终止 + 原因]
阶段2: 写作代理 (note-generator)
根据规划卡生成笔记
角色: 光学领域专家 + 学术笔记专家
输入: 规划卡 + 主题
输出: 完整笔记初稿
写作原则 :
严格遵循规划卡中的"核心定位"和"禁止重复的内容"
使用 knowledge-structure 技能的脉络写作法
使用 knowledge-planning 技能的差异化原则
阶段3: 审查代理 (note-reviewer)
审查笔记质量
角色: Obsidian 学术笔记排版专家
检查项: 规划卡遵循 / 脉络清晰 / 排版规范 / 无重复内容
审查输出模板 :
## 笔记审查报告
### 基本信息
- 文件: [文件名]
- 状态: ✅ 通过 / ⚠️ 需修改 / ❌ 严重问题
### 规划卡遵循检查
- [ ] 核心定位正确
- [ ] 禁止重复内容已排除
- [ ] 开头与父话题不同
### 脉络检查
- [ ] 每节有明确目的
- [ ] 因果链清晰
### 排版检查
- [ ] Callout 使用正确
- [ ] 表格/公式/Mermaid 规范
使用方法
生成新笔记
当用户说 "生成 XX 笔记" 时:
规划阶段 : 调用规划代理 → 输出规划卡
写作阶段 : 调用写作代理 → 生成初稿
审查阶段 : 调用审查代理 → 审查报告
根据反馈修订(最多3次循环)
保存最终版本
审查现有笔记
当用户说 "审查 XX 笔记" 时:
读取笔记内容
对照规划卡检查差异化
对照排版规范逐项检查
输出审查报告和修改建议
优化排版
当用户说 "优化笔记排版" 时:
分析当前笔记的排版问题
按照规范进行优化
提交审查
排版核心原则
元素
规范
加粗
关键概念、核心参数
斜体
英文术语、变量名
==高亮==
需要醒目但非关键
Callout
物理图像→concept, 公式→formula
表格
表头加粗,有单位
标题
H1→H2→H3 连续,无跳级
质量门槛
笔记必须满足:
核心概念解释准确
公式正确且完整
层级结构清晰 (H1→H2→H3)
排版符合规范
引用文献存在
规划卡遵循 :核心定位正确,无重复内容
相关技能
knowledge-planning: 知识规划(强制前置流程)
knowledge-structure: 知识脉络(单篇笔记写作方法)
optics-learning: 光学知识树构建
academic-research: 学术研究辅助
literature-sync: Zotero 文献同步
本技能遵循 Obsidian 排版规范 v2.0
1 --- 2 name: beautiful-notes 3 description: Beautiful Notes 技能 4 --- 5 # Beautiful Notes 技能 6 7 ## 概述 8 9 这个技能提供 Obsidian 学术笔记的**规划-生成-审查**三代理全流程,确保每篇笔记在知识树中有独特位置、结构清晰、排版精美。 10 11 ## 核心流程(三代理) 12 13 ``` 14 用户请求 → 规划代理(note-planner) → 写作代理(note-generator) → 审查代理(note-reviewer) → 保存 15 ``` 16 17 | 代理 | 文件 | 职责 | 18 |------|------|------| 19 | **规划代理** | `note-planner.md` | 扫描目录,分析关系,输出规划卡 | 20 | **写作代理** | `note-generator.md` | 根据规划卡生成笔记 | 21 | **审查代理** | `note-reviewer.md` | 审查笔记质量 | 22 23 --- 24 25 ## 阶段1: 规划代理 (note-planner) 26 27 **强制执行,不跳过** 28 29 执行步骤: 30 1. 扫描同级目录,了解已有笔记 31 2. 分析关系(父话题/子话题/兄弟话题) 32 3. 输出规划卡(格式见下方) 33 4. 检查差异化(父子话题开头必须不同) 34 5. 规划结论:创建新笔记 / 追加到已有 / 终止 35 36 **规划卡模板**: 37 ```markdown 38 ## [笔记名] 规划卡 39 40 ### 基本信息 41 - 目标目录: [目录路径] 42 - 笔记类型: [concept/paper/method] 43 44 ### 关系分析 45 - 父话题: [XXX] — 开头: "[父话题开头]" 46 - 子话题: [XXX] 47 - 兄弟话题: [XXX] — 差异是... 48 49 ### 关系判定 50 [DUPLICATE / SUBSUMED / CONTAINS / OVERLAPS / INDEPENDENT] 51 52 ### 核心定位 53 [一句话说明在知识树中的位置] 54 55 ### 必须回答的核心问题 56 1. [问题1] 57 2. [问题2] 58 59 ### 禁止重复的内容 60 [引导到对应笔记的内容] 61 62 ### 开头差异化 63 - 父话题开头: "[父话题开头]" 64 - 本笔记开头: "[新开头方向]" — 与父话题不同 ✓ 65 66 ### 规划结论 67 [创建/追加/终止 + 原因] 68 ``` 69 70 --- 71 72 ## 阶段2: 写作代理 (note-generator) 73 74 **根据规划卡生成笔记** 75 76 - 角色: 光学领域专家 + 学术笔记专家 77 - 输入: 规划卡 + 主题 78 - 输出: 完整笔记初稿 79 80 **写作原则**: 81 - 严格遵循规划卡中的"核心定位"和"禁止重复的内容" 82 - 使用 knowledge-structure 技能的脉络写作法 83 - 使用 knowledge-planning 技能的差异化原则 84 85 --- 86 87 ## 阶段3: 审查代理 (note-reviewer) 88 89 **审查笔记质量** 90 91 - 角色: Obsidian 学术笔记排版专家 92 - 检查项: 规划卡遵循 / 脉络清晰 / 排版规范 / 无重复内容 93 94 **审查输出模板**: 95 ```markdown 96 ## 笔记审查报告 97 98 ### 基本信息 99 - 文件: [文件名] 100 - 状态: ✅ 通过 / ⚠️ 需修改 / ❌ 严重问题 101 102 ### 规划卡遵循检查 103 - [ ] 核心定位正确 104 - [ ] 禁止重复内容已排除 105 - [ ] 开头与父话题不同 106 107 ### 脉络检查 108 - [ ] 每节有明确目的 109 - [ ] 因果链清晰 110 111 ### 排版检查 112 - [ ] Callout 使用正确 113 - [ ] 表格/公式/Mermaid 规范 114 ``` 115 116 --- 117 118 ## 使用方法 119 120 ### 生成新笔记 121 当用户说 "生成 XX 笔记" 时: 122 1. **规划阶段**: 调用规划代理 → 输出规划卡 123 2. **写作阶段**: 调用写作代理 → 生成初稿 124 3. **审查阶段**: 调用审查代理 → 审查报告 125 4. 根据反馈修订(最多3次循环) 126 5. 保存最终版本 127 128 ### 审查现有笔记 129 当用户说 "审查 XX 笔记" 时: 130 1. 读取笔记内容 131 2. 对照规划卡检查差异化 132 3. 对照排版规范逐项检查 133 4. 输出审查报告和修改建议 134 135 ### 优化排版 136 当用户说 "优化笔记排版" 时: 137 1. 分析当前笔记的排版问题 138 2. 按照规范进行优化 139 3. 提交审查 140 141 --- 142 143 ## 排版核心原则 144 145 | 元素 | 规范 | 146 |------|------| 147 | **加粗** | 关键概念、核心参数 | 148 | *斜体* | 英文术语、变量名 | 149 | ==高亮== | 需要醒目但非关键 | 150 | Callout | 物理图像→concept, 公式→formula | 151 | 表格 | 表头加粗,有单位 | 152 | 标题 | H1→H2→H3 连续,无跳级 | 153 154 --- 155 156 ## 质量门槛 157 158 笔记必须满足: 159 1. 核心概念解释准确 160 2. 公式正确且完整 161 3. 层级结构清晰 (H1→H2→H3) 162 4. 排版符合规范 163 5. 引用文献存在 164 6. **规划卡遵循**:核心定位正确,无重复内容 165 166 --- 167 168 ## 相关技能 169 170 - `knowledge-planning`: 知识规划(强制前置流程) 171 - `knowledge-structure`: 知识脉络(单篇笔记写作方法) 172 - `optics-learning`: 光学知识树构建 173 - `academic-research`: 学术研究辅助 174 - `literature-sync`: Zotero 文献同步 175 176 --- 177 178 *本技能遵循 Obsidian 排版规范 v2.0*
photonics-dhl/self-learning/tree/main/.claude/skills/beautiful-notes commit 71e3900df1
Frequently asked questions How do I install the Beautiful Notes skill? Run npx skillmds@latest add photonics-dhl/beautiful-notes in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Beautiful Notes skill do? Beautiful Notes 技能 It is listed under Coding & Dev Tools on SkillMD.
Is Beautiful Notes safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Beautiful Notes? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Beautiful Notes free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Beautiful Notes? photonics-dhl (@photonics-dhl) published this skill. Their other Agent Skills are listed on their SkillMD profile.