vault backup: 2026-05-14 16:11:17

CLAUDE.md

@@ -1,14 +1,36 @@
 # Claude Code 配置 - Obsidian 知识库
 
-此知识库级别的配置为 Claude 操作提供额外的指导说明。
-在行动前，先列计划（工具调用）。
+此知识库级别的配置文件为 Claude 提供额外的操作指导。所有指令均作用于当前工作区（vault）。
 
-## 新增和完善文件
+> [!important] 执行原则
+> **行动前先规划** — 在执行任何涉及多文件变更的任务前，必须先列出计划再逐步执行。
 
-在初始化和完成文件时，必须**完整**读取参照 `./config/agent/DOCUMENT_OPERATION.md`
-了解结构、规范和惯例。
-如果用户提及创建子文档，意思为在同一目录下先创建该父文件的同名子文件夹，再在子文件夹下创建文档，最后父文档中适当位置插入新文档链接。
-在初次完善后，读取文件并二次检查是否符合文档的每一条内容规范——
-- **教学者模式** 提问设计
-- **代码示例** 合理注释
-- **图表** Mermaid 格式正确性
+## 文档创建与完善规范
+
+在初始化新文件或完善已有内容时，必须严格遵循以下流程：
+
+### 前置检查
+
+每次操作前完整读取 `./config/agent/DOCUMENT_OPERATION.md`，确保了解当前的结构要求、格式规范与命名惯例。
+
+### 子文档创建流程
+
+当用户提出在同级目录创建子文档的需求时，按以下顺序执行：
+
+1. **建立文件夹** — 在与父文档同名的目录下新建同名子文件夹
+2. **创建文件** — 在子文件夹中写入目标文档，编号前缀使用两位数字（如 `01-xxx.md`）
+3. **注册链接** — 回到父文档的合适位置插入该子文档的 Wiki-link 引用
+
+```
+example.md                ← 父文档
+└── example/              ← 同名子文件夹
+    └── 01-sub-doc.md     ← 子文档（两位数字前缀）
+```
+
+### 完成后的自检清单
+
+文档初稿完成后，重新读取全文进行逐条核对：
+
+- [ ] **教学者模式** — 是否通过提问启发思考？关键概念是否有递进式解释？
+- [ ] **代码示例** — 每段代码是否带有清晰的行内注释和上下文说明？
+- [ ] **Mermaid 图表** — 语法是否正确？中文文本是否全部包裹在英文双引号 `""` 中？