菜单
Update vault to the latest version of obsidian-claude-pkm. Creates backup, shows diffs, preserves your content. Use when a new version is available.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/ballred/obsidian-claude-pkm --skill upgrade命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
Scaffold the PKM system onto an existing Obsidian vault. Scans your vault structure, maps folders interactively, and generates configuration — no template required.
Interactive vault setup and context loading. On first run, personalizes your vault. On subsequent runs, loads full context. Use at start of session or when Claude needs full vault context.
Smart review router. Detects context (morning, Sunday, end of month) and launches the appropriate review workflow. Use anytime for the right review at the right time.
基于 SOC 职业分类
| name | upgrade |
| description | Update vault to the latest version of obsidian-claude-pkm. Creates backup, shows diffs, preserves your content. Use when a new version is available. |
| allowed-tools | Read, Write, Edit, Glob, Grep, Bash |
| model | sonnet |
| user-invocable | true |
Updates your vault's system files to the latest version while preserving all your personal content.
/upgrade # Interactive upgrade with backup and diff review
/upgrade check # Preview what's changed without making modifications
.claude/skills/*/SKILL.md — Skill definitions.claude/agents/*.md — Agent configurations.claude/hooks/*.sh — Automation scripts.claude/rules/*.md — Convention rules.claude/output-styles/*.md — Output style definitions.claude/settings.json — Permissions and hook configCLAUDE.md — Root context file (merged carefully)Templates/*.md — Note templatesDaily Notes/** — Your daily journal entriesGoals/** — Your goal files and reviewsProjects/** — Your project folders and CLAUDE.md filesArchives/** — Your archived contentInbox/** — Your captured itemsCLAUDE.local.md — Your personal overridesvault-config.json — Your preferencesRead the current version from CLAUDE.md (look for "System Version:" line).
Compare with the upstream repo. If using git:
git fetch origin
git log HEAD..origin/main --oneline
If not a git repo or no remote, inform user they need to download the latest vault-template/ manually.
Before any changes, create a timestamped backup:
BACKUP_DIR=".backup/upgrade-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BACKUP_DIR"
cp -r .claude "$BACKUP_DIR/"
cp CLAUDE.md "$BACKUP_DIR/"
cp -r Templates "$BACKUP_DIR/" 2>/dev/null
Tell the user: "Backup created at $BACKUP_DIR"
For each system file that differs from upstream:
For each confirmed file:
CLAUDE.md: merge carefully — preserve user customizations (Personal Mission, Current Focus sections) while updating system sections (Skills table, version number)settings.json: merge — add new permissions/hooks, preserve existing customizationschmod +x .claude/hooks/*.sh/onboard to reload context/upgrade check)When invoked with "check":
/upgrade to apply## Upgrade Check
**Current version:** 3.0 (The Cascade)
**Available version:** 3.1
### Files to Update
| File | Change Summary |
|------|---------------|
| `.claude/skills/daily/SKILL.md` | Added cascade context surfacing |
| `.claude/agents/goal-aligner.md` | Added memory: project |
| `.claude/hooks/session-init.sh` | Added priority surfacing |
### New Files
- `.claude/skills/review/SKILL.md` — Smart review router
- `.claude/hooks/skill-discovery.sh` — Auto-list skills
### No Changes Needed
- `.claude/rules/` — Already up to date
Run `/upgrade` to apply these updates (backup will be created first).
CLAUDE.local.md personal overrides preservedWorks with:
/onboard — Reload context after upgrade