fix(pkg): 補齊稽核缺失並修掉護欄失效

What：依 jsc-meta:skill-check 的稽核結果修正技能與工具——補上每個步驟的可檢核完成條件、
把留在內文的標準輸入輸出流程下放 tools/、修正查表與退碼路由造成的誤判。

Why：稽核發現這些缺失會讓技能在實際執行時走錯分支或靜默通過。
完成條件缺漏是最常被違反的一項；退碼誤判與查表錯誤則會讓良性狀況被當成失敗。

How：逐項對照 references/guidelines.md 的審核檢查清單修正，新增的工具都有
documented exit codes，並以真實執行驗證每條路徑。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

tools/list-packages.sh

@@ -1,11 +1,28 @@
 #!/usr/bin/env sh
 # list-packages.sh — 列出專案的所有外部套件與目前版本。
-# 用法: list-packages.sh [專案目錄]（預設目前目錄）
-# 輸出（TSV）: ecosystem<TAB>name<TAB>current
-# 支援: nodejs（package.json）、python（requirements.txt / pyproject.toml）、dotnet（*.csproj）
+# 用法：list-packages.sh [專案目錄]（預設目前目錄）
+# 輸出（TSV）：ecosystem<TAB>name<TAB>current
+# 支援：nodejs（package.json）、python（requirements.txt / pyproject.toml）、dotnet（*.csproj）
+# 結束碼（慣例見 README「工具」章的結束碼總表）：
+#   0 掃描完成（沒有套件時輸出零行）
+#   1 參數個數不對
+#   4 需要的指令不存在（python3）
+#   6 找不到專案目錄——呼叫方停手
 set -u
+
+if [ "$#" -gt 1 ]; then
+  echo "用法：list-packages.sh [專案目錄]" >&2
+  exit 1
+fi
+
 DIR="${1:-.}"
 
+# 先擋找不到專案目錄。少了這道，壞路徑會輸出零行，被誤判成專案沒有套件。
+[ -d "$DIR" ] || { echo "project dir not found: $DIR" >&2; exit 6; }
+
+# 四種來源檔案都靠 python3 解析。少了 python3 會輸出零行，被誤判成專案沒有套件，所以先擋。
+command -v python3 >/dev/null 2>&1 || { echo "python3 not found" >&2; exit 4; }
+
 # nodejs: package.json 的 dependencies / devDependencies
 if [ -f "$DIR/package.json" ]; then
   python3 - "$DIR/package.json" <<'EOF'