dsh-update-guide（dsh更新ガイド）

このSkillでできること

✓dshのバージョン別アップグレード問題を体診する
✓開けない旧セッションやv0移行拒否を調査・修復する
✓Unknown agent presetやUNKNOWN_MODELを診断する
✓Session V3/V4、プラグイン、設定変更に伴う互換性問題を検証する

使い方

STEP 1

作業前にセッションログをバックアップし、対象バージョンと依存条件を確認する

STEP 2

scan-upgrade.mjsでバージョン別の一括体診を実行する

STEP 3

プリセット、モデル参照、v0セッション、プラグインなどの問題を個別に修復する

STEP 4

verify-sessionとverify-patchで問題が解消したことを二重確認する

Skillのインストール

AIにこのSkillを追加してもらう

GitHub URLごとCodexやClaude Codeへ渡し、現在の環境に合う方法を判断してもらいます。

このGitHubリポジトリにあるSkillを確認し、現在の環境に適した方法でインストールしてください。
インストール後、正常に利用できることを確認し、基本的な使い方も簡潔に説明してください。

Repository:
https://github.com/Fabian-698/dsh-update-guide

手動でインストールする

README / SKILL.mdから機械抽出できたコマンドのみ表示しています。推測したコマンドではありません。

bak=~/.dsh/sessions.bak-$(date +%Y%m%d-%H%M%S)
test ! -e "$bak" && cp -R ~/.dsh/sessions "$bak" && du -sh "$bak"

bash install.sh --dry-run      # 先看要做什么
bash install.sh                # 安装 / 更新（已存在时需 --force，会先备份）
bash install.sh --from ~/.dsh/skills/dsh-update-guide   # 从已有目录复制
tmp=$(mktemp -d)
git clone --depth 1 https://github.com/Fabian-698/dsh-update-guide.git "$tmp/repo"
cp -R "$tmp/repo/skills/dsh-update-guide" ~/.dsh/skills/
rm -rf "$tmp"

SKILL=~/.dsh/skills/dsh-update-guide
bak=~/.dsh/sessions.bak-$(date +%Y%m%d-%H%M%S)
test ! -e "$bak" && cp -R ~/.dsh/sessions "$bak" && du -sh "$bak"
node $SKILL/scripts/scan-upgrade.mjs --profile web
node $SKILL/scripts/scan-upgrade.mjs | grep -A2 preset   # 第 0.5 步：preset 未声明（0.1.7 P0，见模式 16）
node $SKILL/scripts/repair-v0-sessions.mjs --list     # 第 0 步：v0 迁移拒绝
node $SKILL/scripts/repair-v0-sessions.mjs --apply    # 需 sessions.bak-*，离线全链校验后原子替换
node $SKILL/scripts/fix-model-refs.mjs --list         # 再修失效模型引用
node $SKILL/scripts/fix-model-refs.mjs --provider deepseek-official --model deepseek-flash \
--reasoningEffort high --token-file /tmp/dshcookies.txt --dry-run
node $SKILL/scripts/test-plugin-boot.mjs              # 启用第三方插件前：隔离启动测试
node $SKILL/scripts/verify-session.mjs --all
node $SKILL/scripts/verify-patch.mjs --profile web --diff-default

このSkillを使うプロンプト例

Skill名を明示すると、意図したSkillを使わせやすくなります。自動発動型では必須とは限りません。

dshを0.1.7-rc.1へ更新した後、旧セッションでUnknown agent presetとUNKNOWN_MODELが発生します。安全な診断と修復手順を示してください。

出力例を見る

まずバックアップの有無とdshのバージョンを確認し、scan-upgrade.mjsで診断します。プリセットの宣言、失効モデル、セッション形式を順に修正し、最後にverify-sessionとverify-patchで確認します。

安全性チェック

自動解析による参考情報です。Skillの安全性を保証するものではありません。

外部API通信検出あり

Shellコマンド実行検出あり

ファイル読み取り明確な記述なし

ファイル書き込み検出あり

ネットワークアクセス検出あり

認証情報明確な記述なし

検出根拠を見る

shell: 或 `DSH_TOKEN` 提供（cookie 等同完整 API 凭据，用完即删）。 ## 自测与 CI ```bash node skills/dsh-update-guide/scripts/selftest.mjs # 快速档（不扫描真实会话） node skills/ds
file_write: 持降级读取,回退旧版 dsh 前必须有备份。备份失败必须当场发现,不能让 `|| true` 吞掉; `cp -R` 到已存在目录会嵌套成 `sessions.bak-. […truncated…] /test-plugin-boot.mjs` | 隔离 DSH_HOME 启动测试：全
network: sembly,普通依赖更新不适用。 license: MIT metadata: repository: https://github.com/Fabian-698/dsh-update-guide dsh-version-range: "0.1.2-rc.1 .. 0.1.7-rc.1" n
network: ;覆盖 **0.1.2-rc.1 → 0.1.7-rc.1** 三代破坏性变更与升级后的断链修复。 > 仓库:https://github.com/Fabian-698/dsh-update-guide (安装、多平台发现、版本与依赖矩阵见仓库 README)。 > REQUIRED BACKGROUND

dsh-update-guide

このSkillでできること

使い方

Skillのインストール

AIにこのSkillを追加してもらう

このSkillを使うプロンプト例

安全性チェック

関連Skill

action-titles

code-review

tang