⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
dsh-upgrade-audit
Audit external compatibility between two DSH (DeepSeek Harness) versions and detect reverts, producing an upgrade-report directory; compares git tags with a source checkout, or published npm packages without one. Use whenever the user asks to check/compare/audit two DSH versions or whether upgrading is safe — e.g. "more changes or reverts in dsh-vX -> dsh-vY", "compare the breaking changes" — even with only two version numbers and no source location. Read-only outside the report directory; npm mode installs in isolation with --ignore-scripts.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
DSH Plugin Upgrade Skill
简体中文 | English
教 AI 帮你升级 DSH 插件的 skill 集合，社区共建。
DSH（DeepSeek Harness） 是一个"所有功能都以插件形式存在"的 AI 运行框架。麻烦在于：DSH 每次发新版，老插件就可能启动不了。本仓库把已知的坑整理成 AI 读得懂的升级手册，让 Claude Code、Codex、Gemini 等 agent 帮你把插件安全迁到新版本，并用一套公开的 benchmark 检验这件事到底有没有做对。
📄 论文：Evaluating Agent Skills for Version-Specific Plugin Migration: A Retrospective Study（arXiv:2609.30120）。评估方法与主要发现见论文一节。
这个仓库里有什么
- 195 张升级说明卡：每张卡记录一个真实的坑——什么坏了、为什么坏、怎么修、信息来自哪个版本。按版本走廊排好序，覆盖 0.1.0-rc.8 → 0.2.0-rc.1（其中 0.1.7-rc.1 → 0.1.7-rc.2 一段尚未成卡），每条边的卡数与状态见下方覆盖表。
- 13 条通用对策：与具体版本无关的坑（先备份、新旧共存、启动卡死怎么办等），集中在一份清单里。
- 11 个 skill：统一工作流负责选择与编排，另外九个分别负责查升级、写插件、测插件、发插件、对比两个版本、排查运行时故障、接入重依赖、宿主升级后巡检整批已装插件、把升级经验提取成考题；还有一个不含 DSH 专有知识的通用迁移方法论，用作对照实验的控制组。
- 63 道自动判分的考题（benchmark）：22 道静态诊断、14 道混合、27 道实操，其中包含 dsh-web 与 dsh-data-agent 两次真实迁移。
- 一篇论文和完整的评估证据：从原始回答、逐条评分到跨模型复评全部公开可复算，见下方论文。
快速开始
使用 skills CLI（推荐）
一条命令装到它支持的 agent：
npx skills add oh-my-dsh/dsh-plugin-upgrade-skill
Claude Code
Marketplace 安装：
/plugin marketplace add oh-my-dsh/dsh-plugin-upgrade-skill
/plugin install dsh-plugin-upgrade-skill
**SSH 错误？**如果没有配置 GitHub SSH 密钥，使用 HTTPS URL：
/plugin marketplace add https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill.git /plugin install dsh-plugin-upgrade-skill
本地/开发模式：
git clone https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill.git
claude --plugin-dir /path/to/dsh-plugin-upgrade-skill
Codex
先添加 marketplace，再在 Codex 的插件界面中安装/启用该插件：
# GitHub marketplace
codex plugin marketplace add oh-my-dsh/dsh-plugin-upgrade-skill
# 本地开发 marketplace
git clone https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill.git
codex plugin marketplace add ./dsh-plugin-upgrade-skill
当前 Codex CLI 没有直接安装子命令；GitHub 与本地路径都通过 plugin marketplace add 注册。
Gemini CLI
直接从仓库或本地克隆安装：
# 从仓库
gemini skills install https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill.git --path skills
# 本地
git clone https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill.git
gemini skills install ./dsh-plugin-upgrade-skill/skills/
Cursor
将 skills/ 复制到 .cursor/skills/：
git clone https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill.git
cp -r dsh-plugin-upgrade-skill/skills/* .cursor/skills/
怎么用
Claude Code 中按名字调用 skill（插件安装后带命名空间）：
/plugin-workflow
/dsh-plugin-upgrade-skill:plugin-workflow
/plugin-upgrade 0.1.2
/dsh-plugin-upgrade-skill:plugin-upgrade 0.1.2
首次只调用统一入口、尚未说明目标流程时，它会先列出 9 个工作流程和 14 项可选能力，推荐只读
health-check 但不会自动执行。回复流程编号或名称，并按需增减能力后，它才会生成阶段账本并开始：
选择 1
选择 compatibility-migration，加上 docker-smoke 和 browser-check
也可以直接在对话中提问（任意 agent），skill 按描述自动触发；只读检查直接给结果，升级或迁移会先出计划再等确认：
先检查这个 DSH 插件，让我选择要不要升级、测试、查云端命名或发布
我需要把插件从 0.1.1 升级到 0.1.2，有哪些破坏性变更？
帮我把 dsh-ads 这个插件升级到 dsh-v0.1.2-alpha.2
校验这个插件的命名并查询中央注册表；保留索引 URL 和 SHA-256，不要提交注册
naming-registry 默认执行离线命名校验和只读中央查询；中央注册仍是单独的外部发布步骤。
代理网络下使用 Node 24+ 的 node --use-env-proxy 运行查询，Node 20-23 不保证内置 fetch
自动读取代理环境变量。查询失败、索引超限或 v2 契约不合法都表示“未知/未检查”，不能解释为名称可用。
11 个 skill 各自管什么
| Skill | 干什么用 |
|---|---|
| plugin-workflow | 统一入口。运行前选择检查、升级、测试、命名注册、打包发布等功能，生成阶段账本并分别确认写入、运行和外部发布 |
| plugin-upgrade | 主角。检查插件要不要升级、执行升级、把老插件适配到新 dsh 版本 |
| plugin-write | 写新插件，附命名规范和查重（避免和别人插件撞名） |
| plugin-test | 测插件改得对不对，含 docker 冒烟测试（装上 dsh 真启动一遍） |
| plugin-release | 打包发布插件，含发布前的自动检查 |
| dsh-upgrade-audit | 对比两个 dsh 版本到底改了什么，给升级卡提供证据 |
| plugin-runtime-debug | 排查插件在宿主里的运行时故障（坐标/投影不匹配、版本滞后、幽灵条目等） |
| plugin-fleet-sweep | 宿主升级后对整批已安装插件做巡检：静态扫改名/删除的 API、真浏览器逐插件断言，并按插件逐个修复发布 |
| plugin-heavy-dep | 给轻量插件接入重依赖（mermaid 这类），含懒加载接入清单 |
| dsh-benchmark-case | 把某个插件的真实升级经验（或已有版本卡）提取成一条可自动判分的 benchmark 考题（fixture + instruction + judge + solution） |
| generic-migration | 框架无关的插件迁移方法论（盘点耦合面、通读版本走廊、分层验证），不含任何 DSH 专有事实；用作对照实验的控制组 |
升级卡覆盖到哪个版本了
| 版本区间 | 状态 | 说明卡 | 备注 |
|---|---|---|---|
| 0.1.0-rc.8 → 0.1.1-rc.1 | 📝 草稿 | v0.1.1-rc.1.md | 9 张草稿卡（vlln 插件迁移：repository 机制移除、strict inject、0812 服务改名等；走廊为 0810–0812 内测快照窗口的最近公开 tag 对齐，待上游复核） |
| 0.1.1-rc.1 → 0.1.1-rc.2 | ✅ 完成 | v0.1.1-rc.2.md | 3 张卡 |
| 0.1.1-rc.2 → 0.1.2-alpha.1 | ✅ 完成 | v0.1.2-alpha.1.md | 28 张卡 |
| 0.1.2-alpha.1 → 0.1.2-alpha.2 | ✅ 完成 | v0.1.2-alpha.2.md | 8 张卡 |
| 0.1.2-alpha.2 → 0.1.2-alpha.3 | ✅ 完成 | v0.1.2-alpha.3.md | 2 张卡（A3-01 新增 settings.plugin.item keyed-slot 设置卡能力；A3-02 移除可选 SQLite Session 持久化后端，opt-in 部署需旧版导出） |
| 0.1.2-alpha.3 → 0.1.2-alpha.4 | ✅ 完成 | v0.1.2-alpha.4.md | 6 张卡（report → send_message、Python 运行时包改名、Session.events 移除、seq 强类型、PTC workflow 与 base web_fetch 默认值；三台真宿主验证） |
| 0.1.2-alpha.4 → 0.1.2-alpha.5 | ✅ 完成 | v0.1.2-alpha.5.md | 3 张卡（storage 域 compatibleVersions 读兼容与 backup-and-skip 兜底；旧家升级拒启/标题丢失修复；storage 层复现核对） |
| 0.1.2-alpha.5 → 0.1.2-rc.1 | ✅ 完成 | v0.1.2-rc.1.md | 0 张卡（纯版本 bump；含核对记录、macOS 真机验证与 release notes 覆盖矩阵） |
| 0.1.2-rc.1 → 0.1.3-alpha.1 | 📝 草稿 | v0.1.3-alpha.1.md | 8 张草稿卡（session-log 走廊 A1-01/02 + Windows 安装 fs-ext 原生构建 A1-03 + host-plane/policy A1-04/05/06 + A1-07/08 未发布 cohort 源码宿主验证配方与 composer/read_image 运行时复核；release tarball 实测，tag 对齐待上游复核） |
| 0.1.3-alpha.1 → 0.1.3-alpha.2 | 📝 草稿 | v0.1.3-alpha.2.md | 5 张草稿卡（persona 拆前缀/后缀、SubprocessHandle.pid 移除、base 移除 str-replace 编辑器默认行、launcher runCli()/import.meta.main、pi-ai 0.84.2→0.85.1） |
| 0.1.3-alpha.2 → 0.1.5-alpha.1 | 📝 草稿 | v0.1.5-alpha.1.md | 20 张草稿卡（Session 格式 V3 + EpochHeader.system 移除、ctx.agent 移除、Inbox 类型化、会话事件校验收紧、PTC 改名、system prompt 入消息历史、CLI 拒 desktop、--from-default-profile、文件面新 API、Web Client details→rightbar 重构、右栏/资源扩展点、tool-subagent 契约、host SSH/指令发现 seam；版本号跳跃边 0.1.3-alpha.2 → 0.1.5-alpha.1） |
| 0.1.5-alpha.1 → 0.1.5-alpha.2 | 📝 草稿 | v0.1.5-alpha.2.md | 24 张草稿卡（workspaceFiles 改查 workspaceFileScope、文件读取越出工作区根 + maxFileBytes、conversation 迁到根级 main、minimal profile 只剩持久 shell、两个不可忽略会话事件、pi-ai 配置变更、scope 感知工具指引、present/reveal、文档预览改名、新 chunked-list/tool-present 包、MCP 分页 cursor 拒绝、session-format-status 文档；客户端/打包面 12 张：rightbar 根级化 + layout 重写、client-resources 去 reload、ui-primitives 图标改名、ui-dockkit 漂移、消息反馈注入面、ui-workspace 导航、交付 turn tail、浏览器依赖迁 devDeps、documentPreviews 注册表、action 命令、feedback Remote、右栏默认页规则） |
| 0.1.5-alpha.2 → 0.1.5-rc.1 | 📝 草稿 | v0.1.5-rc.1.md | 5 张草稿卡（base 默认模型 id 改 deepseek-flash；适配器目录新增 V41 Flash（图片输入、历史系统提示词、不探测网关）；文档渲染器新增必填 scrollportRef；侧栏 guide 条目新增可选 description；含"未改动面"负面证据与 17 仓库舰队核对记录）。本边只有 17 个提交 |
| 0.1.5-rc.1 → 0.1.5-rc.2 | 📝 草稿 | [v0.1.5-rc.2.md](skills/plugin- |
// HOW IT'S BUILT
KEY FILES