pkg/skills/pkg-update/SKILL.md

name, description

name	description
pkg-update	Update every external package of a project to its latest stable version using list-packages.sh and latest-version.sh, then run build and tests. Revert all changes on failure. Supports nodejs, python, and dotnet projects. Use for dependency refresh; not for adding or removing packages.

pkg-update — 套件批次更新

步驟

1. tools/list-packages.sh {專案目錄} 取得所有外部套件（ecosystem / name / current）。
2. 確認工作樹乾淨：有未認可變更就先停止並回報（避免還原時誤傷）。
3. 逐 ecosystem 更新，此步驟必須以 sub agent 執行（每個 ecosystem 一個 sub agent）：
   1. 對每個套件 tools/latest-version.sh {ecosystem} {name} 查最新穩定版。
   2. 改寫版本來源檔（package.json / requirements.txt / pyproject.toml / *.csproj）。
   3. 重新解析安裝（npm install / pip install -r / dotnet restore）。
4. 執行建置與測試：
   • nodejs：npm run build（如有）＋ npm test（如有）。
   • python：pytest（如有測試）。
   • dotnet：dotnet build ＋ dotnet test。
   • 推斷不出指令時依 jsc-ask:ask 規則詢問使用者。
5. 建置或測試失敗 → 還原全部變更（git checkout -- . 與清除未追蹤的 lock 變更），回報失敗套件與錯誤摘要。
6. 成功 → 回報更新清單（套件 / 舊版 / 新版），交由 jsc-git:commit 認可。