cyrene-obsidian-workspace

name	cyrene-obsidian-workspace
description	Cyrene 在 Learn 模式下操作 Obsidian Vault 的规范：目录约定、文件读取、按标题定位、创建与修改 Markdown 的安全原则。
version	1.0.0
autoInject	true
effectKind	mutation
modes	["learn"]

Cyrene Obsidian Workspace

本 Skill 描述 Cyrene 在 Learn 模式下如何操作绑定的 Obsidian Vault。常驻规则已由 learn_system.md 定义，本 Skill 只保留可执行的文件操作规范。

Vault 目录约定

当前会话绑定的 Vault 根目录为 workspaceRoot。所有相对路径均基于该根目录。

目录	用途	默认权限
materials/	用户放置原始学习资料	只读
notes/	学习笔记	读写
exercises/	练习、测验、复盘	读写
templates/	通用模板	读取
learn/progress.md	学习进度总览	读写（静默维护）

用户可以在 materials/、notes/、exercises/ 下自行创建子目录（如 notes/英语/、notes/论文精读/）。子目录名称可以使用中文。

读取文件

列出文件

• 使用 obsidian_list_files 获取 Vault 整体结构。
• 不确定文件位置时，先用 obsidian_search 搜索关键词。

读取全文

• 使用 obsidian_read_file 读取 notes/、exercises/、materials/ 下的文件。
• 读取前确认路径在 Vault 内，不接受绝对路径。

按标题读取章节

• 使用 obsidian_read_section 按 # / ## / ### 标题定位。
• 直属正文：指定标题下、遇到下一个同级或更高级标题之前的内容。
• 完整章节：指定标题及其所有子标题的完整内容。

例如文件结构：

# 主题

## 概念 A
概念 A 正文。

### 细节 1
细节 1 正文。

## 概念 B
概念 B 正文。

• obsidian_read_section 指定 ## 概念 A、includeChildren=false → 只返回 "概念 A 正文。"。
• obsidian_read_section 指定 ## 概念 A、includeChildren=true → 返回 "概念 A 正文。" + "### 细节 1" + "细节 1 正文。"。

写入文件

创建新文件

• 使用 obsidian_edit 的 create 操作。
• 创建前确认父目录存在（工具通常会自动创建）。
• 如果文件已存在，不得覆盖，改为追加或提示用户。

修改已有文件

• 必须先 obsidian_read_file 读取文件，获取 contentHash。
• 使用 obsidian_edit 的 replace_section 或 replace_all 操作时，必须传入 expectedContentHash。
• 如果 contentHash 不匹配，说明文件已被修改，必须重新读取后再操作。

追加内容

• 优先使用 append 或 append_to_section。
• 适合在笔记末尾添加新的理解、链接或总结。

安全规则

• 不操作 .obsidian/ 目录。
• 不跳出绑定的 Vault 根目录。
• 不覆盖已有文件。
• materials/ 默认只读；用户明确要求标注原始资料时例外。
• 不创建无意义的空占位文件。

常用路径模板

• 新主题笔记：notes/<subject>/<topic>.md
• 新练习/复盘：exercises/<subject>/<yyyy-mm-dd>-<topic>.md
• 进度总览：learn/progress.md
• 主题模板：templates/topic-template.md
• 复盘模板：templates/review-template.md