beautify

name	beautify
description	美化排版阶段。套用 Obsidian Markdown 规范，添加双链、标签、Callout 块、Mermaid 图表、YAML frontmatter 等 Obsidian 特性，优化段落长度和术语一致性。触发时机：用户审核通过 write 产出后，Phase 4。

Skill: beautify（美化排版）

触发时机

用户审核通过 write 产出后。

输入

{SYSTEM_ROOT}/2-drafts/{topic}/{topic}-笔记.md

依赖技能

技能	用途	调用方式
obsidian-markdown	Obsidian 语法规范（双链、Callout、frontmatter、标签、嵌入、Mermaid 等）	Skill({skill: "obsidian-markdown"})
obsidian-cli	在 Obsidian 中创建笔记、设置属性、搜索已有笔记建立双链	obsidian <command>
json-canvas	生成知识地图 Canvas（可选）	Skill({skill: "json-canvas"})
obsidian-bases	生成学习笔记索引 Base（可选）	Skill({skill: "obsidian-bases"})

执行步骤

Step 1: 加载语法规范

调用 Skill({skill: "obsidian-markdown"}) 获取完整的 Obsidian Flavored Markdown 语法参考，后续步骤严格遵循其规范。

Step 2: 检查基础 Markdown 规范

• 标题层级正确（不越级，最多 4 级）
• 统一格式（粗体、斜体、代码块标注语言）
• 段落不超过 6 行，大主题切换用 --- 分隔
• 对比数据用表格

Step 3: 添加 Obsidian 特性

按 obsidian-markdown 规范，依次添加：

3a. YAML Frontmatter

---
topic: ""
type: concept | practice | compare | cheat-sheet
difficulty: beginner | intermediate | advanced
tags: []
created: YYYY-MM-DD
updated: YYYY-MM-DD
sources: []
concepts: []
---

参考 obsidian-markdown 的 PROPERTIES.md 了解全部属性类型。

3b. 双链 [[]]

为笔记中出现的概念添加双链：

• 格式参考 obsidian-markdown 的 Internal Links 规范
• 可用 obsidian-cli search query="<概念>" 检测 vault 中是否已有对应笔记
• 已有笔记 → [[已有笔记]]；暂无笔记 → [[概念名]]（占位符，后续可补）
• 外部链接仍用标准 Markdown [text](url)

3c. 标签 #tag

根据内容添加行内标签和 frontmatter tags：

• 主题标签：#react #hooks #frontend
• 类型标签：#concept #tutorial #cheatsheet
• 难度标签：#beginner #intermediate #advanced
• 支持嵌套：#topic/subtopic

3d. Callout 块

参考 obsidian-markdown 的 Callouts 规范，选用合适类型：

• > [!note] 补充说明
• > [!warning] 坑点/注意事项
• > [!tip] 最佳实践/技巧
• > [!example] 代码示例
• > [!info] 背景知识
• > [!danger] 严重警告
• 必要时使用折叠：> [!note]- 点击展开

3e. Mermaid 图表

参考 obsidian-markdown 的 Diagrams 规范：

• 流程 → flowchart TD
• 序列 → sequenceDiagram
• 类关系 → classDiagram
• 节点可关联笔记：class NodeName internal-link;

3f. 其他 Obsidian 特性（按需）

• ==高亮== 标记关键句
• %%注释%% 隐藏编辑备注
• ![[嵌入]] 引用相关笔记或图片
• $LaTeX$ 数学公式

Step 4: 术语统一

同一概念全文使用统一术语，不一致处修正。

Step 5: 写入 Obsidian

用 obsidian-cli 将最终笔记写入目标路径：

obsidian create name="{topic}" path="{OUTPUT_PATH}/{topic}.md" content="<完整笔记内容>" silent overwrite

或直接写入文件后让 Obsidian 自动索引。

Step 6 (可选): 生成知识地图

如果需要，调用 Skill({skill: "json-canvas"}) 为该主题生成 .canvas 知识地图，节点为各子主题笔记，边为概念间关系。

Step 7 (可选): 生成学习索引

如果需要，调用 Skill({skill: "obsidian-bases"}) 为该主题创建 .base 索引文件，按标签/难度/类型过滤和展示相关笔记。

产出

写入 {OUTPUT_PATH}/{topic}/（或默认 {SYSTEM_ROOT}/3-published/{topic}/）：

• {topic}.md：最终格式化的 Obsidian 笔记
• attachments/：相关图片或文件（如果有）
• {topic}.canvas（可选）：知识地图
• {topic}.base（可选）：学习索引

禁止行为

• 不要修改笔记内容或含义
• 不要添加草稿中没有的信息
• 不要删除内容（只能调整呈现方式）
• 不要编造不存在的双链 —— 用 obsidian-cli search 验证
• 不要删除来源引用
• 不要硬编码 Obsidian 语法 —— 以 obsidian-markdown skill 为准

硬停止 (Hard Stop)

本阶段任务完成。向用户展示最终笔记。

严禁调用 /evaluate。严禁进入 Phase 5。 询问用户："需要修改吗？" 或 "要继续评估质量吗？" 仅当用户明确说"评估"或"继续"时才进入 Phase 5。 仅当用户说"完成"或"结束"时才结束任务。