本技能用于更新或维护已用脚手架创建的 Obsidian Arrow 项目。脚手架是仅创建式（拒绝非空目录），因此更新分为三条轨道：工具文件、agent 技能与样式，均不触碰 src/components/ 或 stories/。
两条 CLI 分工：create-obsidian-arrow 是临时生命周期工具（npx create-obsidian-arrow …），create <dir> 生成新项目，refresh [dir] 从当前模板拉取最新受管文件；oasbox 是项目内日常工具，作为本地 devDependency 安装，用 oasbox generate / validate / dev 等进行日常编写，仅在需要模板更新时用 refresh。
- 刷新工具链：在项目根运行 npx create-obsidian-arrow refresh（或 refresh <dir>），先用 npx create-obsidian-arrow refresh --dry-run 预览。它会从最新模板刷新受管文件并合并 package.json 脚本与缺失依赖。受管范围包括 scripts/、docs/、.github/、.husky/、biome.json、AGENTS.md、CLAUDE.md、tools/viewer/、tools/router/、tools/sandbox/、src/main.ts、src/utilities.css、test/；不会触碰 src/components/、src/views/、stories/、public/、index.html、vite.config.ts、tsconfig.json、.gitignore。首次更新会自动创建空 stories/ 占位；stories/views/ 与 stories/components/ 需用户自建。运行后执行 pnpm install && pnpm check。若从 0.4.0 之前版本升级，旧 src/viewer、src/router、src/sandbox 会残留，需手动用 rm -rf src/viewer src/router src/sandbox 删除。
Popover 及结构原语由 refresh 内容安全地交付：缺失的添加，未编辑的（按每条已发布版本的规范哈希判断）自动更新，已编辑的保留并报告以便核对；--force 会强制覆盖。icons.ts 缺失时也会被种子化，因需自行扩展图标，哈希首次添加后即分叉，refresh 始终保留用户版本。新增图标可在 src/components/icons.ts 的 ICON_MAP 追加条目，例如 "your-icon": YourIcon as unknown as LucideIconData, 之后用 ${icon("your-icon")} 调用。可运行 oasbox generate popover <Name> [--variant list|filterable|grouped|action] 生成已接线的弹窗。
-
更新已安装的 agent 技能：pnpm skills:update（等于 npx skills update -y）；或从已发布仓库重装：npx skills add kylebrodeur/obsidian-arrow-sandbox --all --yes。
-
嵌套在其它仓库内时需修正技能作用域：技能 CLI 按 cwd 安装项目作用域，可用 pnpm skills:install --yes --project-dir=<outer-repo> 或 pnpm skills:install --yes --global。
-
Obsidian 更新后重新拉取样式：pnpm pull-css。
-
更新后重新检查移植一致性：node scripts/component-hash.mjs --check port-parity.json。
-
导出带前缀的 CSS：需项目根存在 porting.config.json（从 porting.config.example.json 复制并设置插件 cssPrefix），运行 pnpm port:css，将带前缀 CSS 写入 outDir/；这是单次移植步骤，不属于 pnpm ci。以上命令与路径均按资料原样保留，未提供的收费、平台等信息暂未说明。