|最后更新: Invalid Date
Tags
AI
视频介绍
资源地址
备注

安装「微信读书 -> Obsidian 增量同步」Skill

把下面这份 prompt 粘贴给支持本地文件操作的 AI Agent，例如 Codex、Claude Code、Claude 桌面版、WorkBuddy、OpenCode、OpenClaw 或 Hermes Agent。ChatGPT 网页版可以用来理解和改写，但通常不能直接替你在本机创建 skill 文件。

创建安装 Prompt

请帮我创建一个名为 weread-to-obsidian 的 skill。
这个 skill 的目标是：读取我的微信读书笔记，把有笔记的书籍同步成 Obsidian Markdown 笔记；首次运行导出全部有笔记的书，之后每次运行只处理新增或发生变化的书籍、划线和想法。
你不是只写一份说明文档，而是要真正创建一个可运行的 skill 文件夹和 SKILL.md。如果当前工具不能直接写文件，请输出每个文件的完整内容和建议保存路径。

安装原则

你需要自己先做内部判断，但不要把判断过程展示成一段说明给用户看。用户只需要看到必要的安装问题、API Key 获取步骤、将创建的文件和测试结果。

配置变量分类

按下面四类处理配置，不要把我的本机路径、账号、密钥或模板写死到分发版 skill 里。

A 类：固定不问，直接写进 skill

  • 微信读书 API 网关请求必须带 skill_version，版本号取当前已安装 weread-skills 的 frontmatter version
  • 业务参数必须平铺在 JSON body 顶层，不能包在 params 里
  • 笔记内容导出口径是：划线内容 + 个人想法/点评内容
  • 书签目前只能统计数量，不能导出书签内容
  • 封面只同步封面 URL 到 frontmatter，不下载图片
  • 默认先预览，再等用户确认后写入
  • 更新已有 Obsidian 笔记时，只替换同步区块，不覆盖用户自己写的内容

B 类：简单偏好，安装时问一句

  • skill 名称，默认 weread-to-obsidian
  • 文件命名规则，默认 {{title}} - {{author}}.md

C 类：需要查找或操作，问题要附指引

  • Obsidian vault 根目录
  • 笔记输出目录，相对 vault 根目录
  • 可选的 Obsidian 读书笔记模板路径，相对 vault 根目录
  • 目标 agent 的 skill 目录。如果能自动识别当前工具，就自动识别；不能识别时再问
路径问题必须告诉用户：
  • Mac：右键点击目标文件或文件夹，按住 Option，选择“拷贝……的路径名称”
  • Windows：打开目标文件夹，点击顶部地址栏，复制显示的路径

D 类：敏感凭证，绝不让用户粘贴到 skill 或对话里

  • 微信读书 API Key，格式通常是 wrk-...
  • 安装时必须引导用户打开微信读书 API Key 页面
  • 不询问用户选择哪种保存方式，由安装器按操作系统自动使用本机安全凭据体系
  • 不要把 API Key 明文写入 SKILL.md、配置文件、日志、终端历史或对话记录

安装时要问我的问题

一次性问完下面这些问题。每个问题都带默认值，我不回答时就用默认值继续。
  1. 你要创建的 skill 名称是什么？默认：weread-to-obsidian
  1. 你的 Obsidian vault 根目录在哪里？例如 /Users/you/Documents/Obsidian/My Vault
  1. 读书笔记输出到 vault 里的哪个目录？默认：Books/WeRead
  1. 你有固定的读书笔记模板吗？如果有，请给相对 vault 的路径；没有就留空
  1. 文件命名规则用哪一种？默认：{{title}} - {{author}}.md
  1. 首次同步范围是什么？默认：同步所有“有笔记”的书；不要默认同步整个书架里没有笔记的书

引导用户获取和保存 API Key

无论用户是否说自己已经有 Key，都必须先引导用户打开：
https://weread.qq.com/r/weread-skills
登录后页面可能会显示 wrk- 开头的 Key。
重要：不要让用户把 Key 粘贴到对话里。请让用户在本机终端里保存。

macOS

使用 Keychain 保存：
临时加载到当前 shell：

Windows

Windows 有类似 Keychain 的系统凭据能力，常见入口是 Windows Credential Manager。为了让本地 AI Agent 更容易用脚本安全读取，本 prompt 默认使用 PowerShell 的 SecretManagement + SecretStore；用户不需要在多种保存方式里选择。
PowerShell SecretManagement 保存方式：
当前会话加载：

Linux

如果系统有 Secret Service / secret-tool，优先保存到系统钥匙串；否则使用当前 shell 的环境变量。无论哪种方式，都不要把 Key 写入 skill 文件。

创建文件结构

在目标 agent 的用户 skill 目录下创建：
如果当前 agent 支持配置文件，也可以额外创建：
config.json 只能写用户本机路径、输出目录、模板路径、文件命名规则和安全凭据名称；不能写 API Key 明文。

目标 SKILL.md 模板

请根据我的回答，把下面模板里的占位符替换成真实配置，再保存为 SKILL.md。

安装完成后要做的测试

创建 skill 后，请先不要直接批量写入。按下面顺序测试：
  1. 测试 API Key 是否能读取
  1. 调 /user/notebooks 拉取前 5 本有笔记的书
  1. 选 1 本书测试 /book/bookmarklist 和 /review/list/mine
  1. 生成 1 个 Markdown preview
  1. 用户确认后，只写入这一本文档和状态文件
  1. 再运行一次，确认没有变化时会跳过
测试通过后，再执行首次全量同步。

不要做的事

  • 不要让用户把 API Key 明文粘贴到对话里
  • 不要把 API Key 写入 SKILL.md、config.json 或状态文件
  • 不要写死某个人的 Obsidian 路径或 WorkBuddy 路径
  • 不要默认同步整个书架里没有笔记的书
  • 不要把书签数量误当可导出的书签内容
  • 不要覆盖用户已经写在 Obsidian 读书笔记里的私人内容
  • 不要跳过 preview 直接批量写入，除非用户明确要求
Loading...