obsidian-safe-write

Obsidian Safe Write

定位

本 skill 只做 Obsidian-aware 的小范围安全写入，不负责业务正文创作。

适合写入标准 Properties、使用模板创建新文档、在 frontmatter 后追加标准块，以及用户明确确认后的单文件 move / rename。

触发场景

• 修改正式文档后更新 updated（格式与「何时不更新」的例外见 document-norms §2.7）。
• 项目配备的发布器（<platform>-publish）发布成功后回写该平台的同步状态字段。
• 新建 spec / plan / decision / overview 时用模板创建。
• 用户明确要求重命名或移动某个单文件。

何时不用

• 大段正文写作：用业务 skill + Edit / Write。
• 批量目录重命名：不要默认使用本 skill；先做方案和用户确认。
• 链接审计：用 obsidian-link-audit。
• 历史恢复：不用本 skill，恢复类操作必须单独确认。

CLI Probe

优先读取 .claude/workframe-state/obsidian-cli-status.json（schema 权威定义见 skill: obsidian-doc-structure §status.json schema）：

• do_not_probe: true → 永不重新 probe（不设 TTL、不做过期自判），直接按 cli_available 决定走 CLI 还是 fallback；重新启用 CLI 的唯一入口 = 用户手动删除该文件
• 缓存缺失 → 执行非执行检测（全程不运行任何 obsidian 命令）：定位命令（Get-Command obsidian / command -v obsidian）→ 判定是否 GUI 启动器（所在目录存在 Obsidian.exe / resources.pak 特征文件）→ 不可用则写入 status.json（cli_available: false、do_not_probe: true、reason）并 fallback
• 仅当非执行检测确认存在独立 CLI shim 时，才允许执行 obsidian version / obsidian vault info=path 验证并写入 commands_verified

⚠️ 未通过非执行检测时禁止执行任何 obsidian 命令——在「装了 GUI 但未启用 CLI」的机器上会误启动 Obsidian 窗口。

不可用时 fallback 到 Edit / Write，但必须先说明 fallback 原因。

调用前检查

执行任一 Obsidian CLI 命令前，必须依序确认：

• status.json 存在且 do_not_probe: true 且 cli_available: false → 直接 fallback，不做任何 probe。
• 命令在 commands_verified 数组中 → 可以使用 CLI。
• 命令不在数组中 → 直接 fallback，不尝试执行。
• status.json 不存在或 schema 不匹配 → 按「CLI Probe」的非执行检测流程重新检测（禁止直接执行 obsidian 命令）。

官方 CLI 命令

obsidian property:set path="<file>" name=updated value="2026-04-29T23:12:40+08:00" type=datetime
obsidian property:remove path="<file>" name="<field>"
obsidian prepend path="<file>" content="..."
obsidian create path="<file>" template="<template>"
obsidian move path="<old-file>" to="<new-file>"
obsidian rename path="<file>" name="<new-name>"

以本机 obsidian help <command> 的参数名为准。

模板协同

使用 create template= 时，不建立新的 Obsidian-only 模板体系。优先复用：