如何用 SkillDock 的 Git Diff 预览安全更新与推送 AI Skill:完整团队协作指南

原创2026-11-15 14:55:431,841 阅读

如何用 SkillDock 的 Git Diff 预览安全更新与推送 AI Skill:完整团队协作指南

SkillDock 是一款面向 Claude Code、Cursor、Codex、Windsurf、Gemini CLI 等 AI 编程工具的 AI Skill 管理桌面软件。它的 Git Diff 预览功能可以让你在更新、推送 Skill 之前逐文件审查变更内容,支持行级(hunk)回退本地修改,是团队共享 AI Skill 时的"安全闸"。本文带你完整走一遍:查看协作状态 → 预览更新差异 → 一键更新 → 安全推送的团队协作流程。

SkillDock AI Skill 管理主界面

为什么 AI Skill 更新需要 Git Diff 预览

团队协作中,AI Skill 通常以 Git 仓库形式共享:成员 A 修改了 Skill 并推送到团队仓库,成员 B 本地可能也有改动。如果直接"一键更新",本地修改可能被覆盖或产生难以处理的冲突。

SkillDock 的做法是:把每个 Git 来源的 Skill 当作真实仓库管理,自动检测四种协作状态,并在任何更新/推送动作前先给出 Diff 预览——先看清,再操作。

SkillDock Skill 分组列表与状态

SkillDock 的 4 种 Git 协作状态

在 Skill 列表或详情中,每个 Git 关联的 Skill 会显示一个状态徽章:

状态 含义 建议动作
可更新 远端有新提交,本地落后 打开"更新预览"查看差异,确认后拉取
待提交 本地存在未提交修改 在变更视图中检查、编辑或回退,再提交
待推送 本地有已提交但尚未推送的内容 一键推送到团队仓库
无徽章 本地与远端一致 直接使用

状态由 git_state.rs 中的 derive_collab_status 逻辑推导,结合 git_divergence.rs 的分支领先/落后计数,前端展示见 SkillStatusBadge.tsx。

Skill 详情页与工具同步

第一步:查看"更新预览",确认远端改了什么

当 Skill 显示可更新时,点击卡片上的"更新预览"按钮,SkillDock 会对比本地 HEAD 与远端分支的差异,展示:

  • 需要拉取的提交数、当前分支与远端分支名称;
  • 逐文件差异:修改(M)、新增(A)、删除(D)一目了然;
  • 每个变更文件可用"仅看变更 / 显示全部"两种模式查看,未变更行自动折叠。

更新预览界面是只读的,确保你审查时不会误触修改。Diff 视图由 SkillDiffView.tsx 基于 CodeMirror 的 merge 视图实现,后端差异采集见 git_changes.rs 中的 collect_ref_changes。

提示:预览会同时列出你本地是否有未提交改动,让你提前判断是否需要先处理本地变更。

第二步:一键安全更新

确认远端变更内容无误后,点击更新按钮。SkillDock 会将 Skill 仓库更新到远端最新版本(对干净仓库执行 rebase 合并逻辑,见 commands.rs 的 update_skill),更新完成后状态回到"本地与远端一致",即可继续同步到各工具。

第三步:审查本地变更,按文件甚至按块回退

如果你修改了 Skill 并准备推送,先打开本地变更视图:

  1. 可编辑 Diff:本地变更视图与更新预览不同,它是可编辑的——可以直接在差异中继续调整内容,修改后点"保存";
  2. 回退单个变更块(hunk):每个变更块左侧都有回退按钮,只撤销这一处改动而不影响其他修改,确认弹窗会防止误操作;
  3. 回退整个文件:撤销该文件的全部本地修改,新增的未跟踪文件会被直接移除。

回退逻辑在后端 git_changes.rs 的 revert_working_tree_change 中实现:它先校验补丁仍有效(防止文件在审查期间被改动),再用 git apply --reverse 精确撤销,对应 Tauri 命令为 commands.rs 的 revert_skill_change。

从 Git 仓库安装 Skill

第四步:一键提交并推送到团队仓库

审查完毕、确认要保留的修改后,执行推送:

  • SkillDock 自动把剩余本地变更提交到当前分支(提交信息形如 chore: update <skill名>);
  • 然后推送到 origin 的对应分支;
  • 若仓库处于 detached HEAD 等异常状态,会明确报错而不是冒险操作。

推送前可先查看"推送预览"快照(见 commands.rs 的 get_push_preview_snapshot),它会展示目标分支、未提交文件清单和未推送提交数。

团队推荐协作流程

SkillDock Skill 管理工作流

  1. 维护者从 Git 仓库安装 Skill(仓库地址见安装页),统一存放在 ~/.skilldock/skills 作为分发生效源;
  2. 任何成员修改 Skill 后,先看本地变更 Diff → 按块回退不需要的内容 → 一键提交推送;
  3. 其他成员看到可更新徽章 → 打开更新预览确认改动 → 一键拉取;
  4. 更新完成后,把 Skill 同步启用到 Cursor、Claude Code、Codex、Windsurf 等目标工具,无需手动复制文件。

SkillDock 支持的工具列表

常见问题

更新会覆盖我的本地修改吗? 不会。存在本地未提交修改时,Skill 显示待提交状态,且界面会提示"本地存在未提交修改,请先提交后再推送";更新预览也会明确告知你本地有未提交改动。

误删/误改了一处内容怎么办? 在本地变更视图里对该变更块点回退即可,无需整文件撤销;操作前有确认弹窗,且回退前会校验内容是否已变化。

本地和远端都改了呢? 状态会提示"本地与远端均有变化,建议先处理本地改动,再更新远端内容",先推送本地、再更新远端即可。

核心模块索引

登录后查看全文
skilldock