renat3u/dsh-upgrade-skill

dsh-upgrade-skill

升级 DSH（DeepSeek Harness）插件的 skill。适用于检查已安装插件的更新、把插件
升级到新版本、处理升级引入的 breaking changes，以及 DSH 宿主升级后适配插件源码。

主 SKILL.md 保持版本无关：它提供「确认目标版本 → 给插件定形态 → 按形态执行
清单 → 真实 profile 验证」的通用流程。具体到某个宿主版本的包改名、API 重命名和
DOM 契约变化，统一放在 references/migration-baseline.md 的「迁移证据基线」里，
避免版本串散落在全文各处。

目录结构

dsh-upgrade-skill/
├── README.md                              # 本文件
└── skills/
└── dsh-upgrade-skill/
├── SKILL.md                       # skill 主入口：通用升级工作流与形态清单
└── references/
├── migration-baseline.md      # 迁移证据基线（当前覆盖：0.1.1 → 0.1.2-alpha.2）
└── checklists.md              # 分形态修复样例、常见报错表、实测记录

安装

DSH 的 skill 发现根如下（优先级从高到低）：

| 来源 | 根目录 |
|---|---|
| project-dsh | /.dsh/skills |
| project-agents | /.agents/skills |
| custom | Config.customSkillDirs |
| user-dsh | /skills |
| user-agents | /skills |

任选其一，把 skills/dsh-upgrade-skill 整个目录放进去（或创建符号链接）：

mkdir -p ~/.agents/skills
ln -s "$(pwd)/skills/dsh-upgrade-skill" ~/.agents/skills/dsh-upgrade-skill

skill 系统扫描目录 bundle（/SKILL.md）与平铺 Markdown
（.md）。重启或新建会话后，模型会话目录中会出现
dsh-upgrade-skill，调用 skill 工具即可加载完整指令。

当前证据基线

- 升级起点：dsh-v0.1.1-rc.1
- 升级目标：dsh-v0.1.2-alpha.2（npm @deepseek-ai/dsh@0.1.2-alpha.2）
- 证据状态：迁移表来自两个 tag 的源码 diff；web client 的安装与 boot graph
已在目标版本上实测（浏览器内 DOM 交互待补）；ACP bridge 已完成构建、单测与
完整 initialize/session/new/prompt/cancel round trip（审批分支待专门复验）；
工具型 bundle + client 插件已完成构建、安装、web API 与内置自检（PASS 6/7）

只改这一个文件（references/migration-baseline.md）就能换到下一个目标版本；
主 SKILL.md 和 checklists 不需要跟着版本号一起改。

维护

- 目标版本变化时，更新 references/migration-baseline.md 的版本表、迁移表和
实测记录，并同步本 README 的「当前证据基线」；
- 新增插件形态或新报错时，先补 references/checklists.md，再在 SKILL.md 主
流程里加对应入口。