fix(tools): 改用共用推導取得技能組根目錄,並補齊結束碼宣告

以 plugin 形式安裝時,腳本會落在 CLI 的 plugin 快取目錄。
六支腳本原本一律取「腳本位置的上兩層」當技能組根目錄,這時一定推錯。
這一輪例行稽核的第一步就實際踩到:不先手動設環境變數,腳本根本跑不動,
而叫用它們的技能說明也沒提要設,等於留了一個必炸的預設值。

把推導規則抽成共用腳本,依序試環境變數、從目前目錄往上找、
腳本位置的上兩層、家目錄底下的 plugins,並以 gitea.sh 在不在當判準。
marketplace 每個 domain 存取庫都帶一份,單看它會把 domain 誤判成根。
推不出來就結束並指名要設環境變數,同時列出試過的每一個候選,
呼叫端一眼看得出要設什麼。只 clone 單一存取庫的環境留了逃生門:
環境變數有設且是目錄就照用,並在錯誤輸出提醒。

順手補上語言檢查與 manifest 同步兩支腳本的結束碼宣告與環境變數說明。
沒有宣告,呼叫端只能猜;猜錯就把失敗當成功。
This commit is contained in:
2026-08-31 11:11:12 +08:00
parent 9dabe98f2b
commit 7dc5c32de3
9 changed files with 159 additions and 27 deletions
+14 -4
View File
@@ -3,15 +3,25 @@
#
# 用法: inventory-tooling.sh [root]
#
# root: 預設取本腳本位置的上兩層(meta/tools -> meta -> 根)。
# 也可用參數或 JSC_PLUGINS_ROOT 覆寫。
# root: 給了參數就用參數。沒給就交給 tools/plugins-root.sh 推導
# (JSC_PLUGINS_ROOT -> 從 $PWD 往上找 -> 腳本位置上兩層 -> $HOME/plugins)。
# 以 plugin 形式安裝時,「腳本位置上兩層」會落在 plugin 快取目錄,單靠它一定推錯,
# 所以推導規則抽成共用腳本。
#
# 輸出: Markdown。內容包含 domain、manifest、技能、工具、hooks 與管理入口。
# 結束碼: 0=成功 1=根目錄、marketplace 或必要工具缺失
# 同一趟已經跑過 list-skills.sh、detect-clis.sh 與 wire-cli.sh status,結果都寫進輸出,
# 呼叫端沿用即可,不必再各跑一次。
# 結束碼: 0=成功 1=推導不出根目錄、根目錄不存在、marketplace 或必要工具缺失
# 環境變數: JSC_PLUGINS_ROOT(根目錄,見 plugins-root.sh)
set -eu
HERE=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
ROOT=${1:-${JSC_PLUGINS_ROOT:-$(CDPATH= cd -- "$HERE/../.." && pwd)}}
. "$HERE/plugins-root.sh"
if [ "$#" -ge 1 ] && [ -n "$1" ]; then
ROOT=$1
else
ROOT=$(jsc_plugins_root) || exit 1
fi
ROOT=${ROOT%/}
[ -d "$ROOT" ] || { echo "找不到 plugins 根目錄:$ROOT" >&2; exit 1; }