前言¶

Agent 每次开会话都是”从零开始”。你让它记住一个项目的背景、决策和踩坑记录，它只能在当前对话里复述；下次新开窗口，这些信息就不见了。另一种做法是把内容贴进对话上下文，但这既占 token，也没法形成长期、可检索的项目记忆。

这个 Skill 解决的是后一件事：让 Agent 在需要时把真实存在的本地项目内容、项目信息、持久化项目记忆，以及 Obsidian 笔记、markdown wiki 笔记、LLM Wiki 笔记写入本地持久存储，而不是留在对话里。

这是什么¶

obsidian 同步管理工具，坐标 @user_11f3afce/obsidian-project-sync，版本 1.0.0，来源 community，分类 knowledge-management，发布者 user_11f3afce。

一句话定位：一个通用 SKILL.md 格式的 Agent Skill，用于触发”把本地笔记与项目内容持久化”的流程。它的触发条件写在简介里，原文如下：

Use when the user asks to sync, store, update, or persist real local project content, project information, durable project memory, Obsidian notes, markdown wiki notes, or LLM Wiki notes.

也就是说，它不是一个独立运行的程序，而是给 Agent 的一份指令：当用户提出同步、存储、更新或持久化上述内容时，按这套流程去做。标签显示 requires_api_key=false，不需要额外配置 API Key。

核心功能¶

能核实到的能力，就是简介中列出的触发场景，覆盖两类：

1、本地内容持久化。同步、存储、更新真实的本地项目内容与项目信息，形成 durable project memory。
2、笔记类内容持久化。Obsidian notes、markdown wiki notes、LLM Wiki notes 的同步、存储、更新与持久化。

需要说明的是，本次抓取只拿到了 SkillHub 的元数据页，SKILL.md 正文与 SKILL.md 内的步骤、脚本、命令未能打开核对。因此具体实现用了哪些工具调用、读写哪些目录、是否有冲突合并策略，本文不写，以官方页面为准。

安装与启用¶

官方安装命令、目录与配置项在抓取资料中缺失，未能核对，这里不编造。下面的做法是这类通用 SKILL.md Skill 的通行启用路径，具体路径请以官方页面为准：

1、拿到 Skill 的 SKILL.md 文件。
2、放到所用 Agent 的 skills 目录（通常是项目下的 .agents/skills/ 或用户级 skills 目录）。
3、在会话中直接提出同步、存储或更新笔记的需求，Agent 依据 SKILL.md 触发。

Cursor、Codex CLI、Claude Code 在 skills 目录位置与加载方式上存在差异，本次资料未提供分端说明，不做展开。

典型用法¶

下面是基于触发条件给出的、可复现的请求形式。它们都来自官方简介中列出的对象，未核实的细节行为不在此描述。

1、”把我这个本地项目的进展同步到笔记里。”对应场景：sync real local project content。
2、”把这些项目信息存下来，下次还要用。”对应场景：store / persist project information、durable project memory。
3、”更新我的 Obsidian 笔记 / markdown wiki 笔记 / LLM Wiki 笔记。”对应场景：update Obsidian notes、markdown wiki notes、LLM Wiki notes。

调用形式取决于你在哪个 Agent 里启用它，本文不做臆测。

适用场景与注意¶

适合谁：已经有 Obsidian 笔记库或 markdown wiki 结构、希望 Agent 把项目内容沉淀成长期记忆的开发者；希望同步动作由明确指令触发、而不是每次手动复制粘贴的人。

限制与坑：

1、requires_api_key=false 只说明不需要 API Key，不说明它不需要任何外部依赖；本地路径、权限、笔记库结构是否被正确读取，取决于 SKILL.md 的具体实现，需自行验证。
2、它是指令型 Skill，实际读写行为由 Agent 按 SKILL.md 执行。同步方向、冲突处理、是否覆盖原文件，都要先在官方文档确认。
3、版本号 1.0.0，来源 community，属于社区发布，不是官方维护渠道，接入前建议先在小范围笔记库上试跑。

结尾¶

这个 Skill 的价值在于把”让 Agent 记住项目”从手工贴上下文变成一次可重复的持久化动作，触发条件明确，不需要 API Key。元数据来自 SkillHub 页面快照，评分与下载数为抓取时点的页面数值，可能已变化；SKILL.md 正文未能核对，请到官方页面确认实现细节。

官方地址：https://api.skillhub.cn/user_11f3afce/obsidian-project-sync
SkillHub 页面：https://www.skillhub.cn/skills/user_11f3afce/obsidian-project-sync