Obsidian 缓存清理 · Obsidian Cache Reset

解决 Obsidian 卡在 "Loading cache..." 无法启动的问题。

When to Use

• Obsidian 启动时卡在 "Loading cache..." 不动
• Vault 文件数量多、有大量非 markdown 文件（如 node_modules）
• 怀疑缓存损坏

Workflow

Step 1: 确认 Obsidian 已关闭

pgrep -x Obsidian && echo "Obsidian 正在运行，请先关闭" || echo "OK: Obsidian 未运行"

如果 Obsidian 正在运行，提示用户先关闭。 如果用户没有明确确认已关闭 Obsidian，使用 AskUserQuestion 确认后再继续。

Step 2: 清除 IndexedDB 缓存

执行前再次确认目标是 Obsidian IndexedDB 缓存，而不是 vault、插件配置或笔记。

rm -rf ~/Library/Application\ Support/obsidian/IndexedDB/

Step 3: 提示用户重新打开 Obsidian

告知用户：

1. 缓存已清除
2. 重新打开 Obsidian，首次加载会稍慢（重建索引）
3. 如果 vault 里有 node_modules 等大量非 markdown 文件，建议创建 .obsidianignore 文件排除

Optional: 创建 .obsidianignore

如果用户的 vault 包含 node_modules 或其他应忽略的目录，帮用户在 vault 根目录创建：

node_modules
.git
.output
dist
build

Notes

• 此操作仅影响 macOS
• 清除的是全局缓存，会影响所有 vault 的索引
• 不会删除用户数据、笔记、插件配置

Runtime context (shared)

运行前读取本 Skill 包的 skill.yaml，由宿主提供 skill-runtime/v1 上下文。字段解析顺序为：当前请求、项目上下文、个人 Preferences、品牌 Profile、通用默认值。

• 只使用 Manifest 声明的字段；Profile 保存公开品牌事实，Preferences 保存个人工作偏好。
• required: true 字段缺失时，按 Manifest 的问题配置向用户提出一个聚焦问题；用户明确同意后再保存回答。
• 报错提供可复制的 context_id、字段路径与来源，诊断内容避开秘密、完整私人路径和原始配置。

通用反馈闭环

用户在 Skill 驱动任务中提出修改意见时，继续当前产物前必须执行：

1. 先判断意见是 task-specific（仅本次）还是 reusable（可跨任务复用）。
2. task-specific 只修改当前任务，不改 Skill。
3. reusable 先确定作用域：领域规则先更新对应 canonical Skill；适用于所有 Skill 的规则先更新共享规范。
4. 完成规则更新、版本、lint 与分发核验后，再把修改应用到当前任务。
5. reusable 修改会使此前的“确认”“继续”“发吧”失效；完成当前产物修改和回读后必须停下，等待用户下一步指示，不自动进入发布、提交或其他外部写入。