docs(meta): 同步文件與參考資料

What：更新 README、AGENTS.md、templates 與 references，讓文件敘述與實際行為一致。

Why：稽核發現多處文件與程式行為分歧，違反「每個意義只有單一真實來源」。

How：以實際程式行為為準改寫敘述，重複的規則收成單一來源並以一行指引指過去。

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

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

references/guidelines.md

@@ -13,7 +13,7 @@
 
 ## Description 規則
 
-1. frontmatter 的 `description` 為一行英文，不超過 5 句或 5 個步驟。
+1. frontmatter 的 `description` 為一行英文，不超過 5 句或 5 個步驟——**兩個上限滿足任一個就算通過**，句數與步驟數都超過才要精簡。
 2. 使用專有名詞、概念或指引詞（例：WBS、TDD、decision tree、STE100）取代解釋。
 3. 必須寫清楚觸發時機（何時用、何時不用），這是各 CLI 自動載入的唯一依據。
 4. 複雜流程透過**組合其他技能**實現，不在單一 description 裡塞流程。
@@ -77,13 +77,17 @@
 
 技能組的每一支技能在被呼叫前都要確認本機版本沒有落後遠端發佈版本。判定在程式層，由 `jsc-hooks` 的 `version-guard.sh`（PreToolUse，matcher `Skill`）執行，**不靠技能內文自我約束**——寫在內文的規則，模型可以無視。
 
+這道檢查只擋「確定落後」一種情況。查不到任何一項基礎資訊就安靜放行（exit 0），不要求先修好環境：五支 CLI 只有 claude 讀得到本機載入版本，fail-closed 會把另外四支整批鎖死。
+
 | 項目 | 規則 |
 | --- | --- |
-| 比對對象 | 遠端發佈版本（`master` 的 `plugin.json`）對本機**實際載入**版本 |
-| 實際載入版本 | 讀 `installed_plugins.json` 的 `installPath` 底下那份 `plugin.json`，**不可只看註冊欄位**——兩者可能不同，只看註冊值會放過真正被載入的舊版 |
-| 落後 | 擋下該次技能呼叫（exit 2），並印出更新指令 |
-| 相等或超前 | 放行。開發技能組時本機本來就會超前 `master`，擋下去維護者自己動不了 |
-| 查不到遠端版本 | **擋**（fail-closed）。查詢失敗會重試一次，仍失敗才擋 |
+| 比對對象 | 遠端發佈版本（存取庫**預設分支**的 `plugin.json`，經 `jsc-gitea/tools/gitea.sh` 讀取，不寫死分支名）對本機**實際載入**版本 |
+| 實際載入版本 | 只認 `installed_plugins.json` 的 `installPath` 底下那份 `plugin.json`。註冊在 `installed_plugins.json` 的 `version` 欄位**不當備援**——註冊值可能比實際載入的版本新，拿它來比對會放過真正被載入的舊版 |
+| 落後 | 擋下該次技能呼叫（exit 2），並印出更新指令。**只有這一種情況會擋** |
+| 相等或超前 | 放行。開發技能組時本機本來就會超前預設分支，擋下去維護者自己動不了 |
+| 查不到本機載入版本 | **放行**（exit 0，安靜降級）。讀不到 `installed_plugins.json`、裡面沒有該 plugin 的條目、取不到 `installPath`、`installPath` 底下那份 `plugin.json` 讀不到，四種都算這一列，不退回註冊欄位 |
+| 解不出 Gitea 站台 | **放行**（exit 0，安靜降級） |
+| 查不到遠端版本 | **放行**（exit 0，安靜降級）。缺基礎設施不等於落後，擋下去會把四支非 Claude CLI 整批鎖死 |
 | 逃生門 | `JSC_VERSION_GUARD=off`（離線工作用），快取秒數 `JSC_VERSION_TTL`（預設 600） |
 
 **豁免清單**（永遠放行，改動前想清楚後果）：
@@ -122,7 +126,7 @@
 新增或更新技能後逐項檢查，任一不符就修正：
 
 - [ ] 名稱符合命名規則，且與既有技能目標不重複
-- [ ] description 為英文、≤ 5 句或 5 步驟、含觸發時機
+- [ ] description 為英文、≤ 5 句或 ≤ 5 步驟（滿足任一即通過）、含觸發時機（何時用、何時不用）
 - [ ] 可 hook 的規則已下放 jsc-hooks；可工具化的流程已下放 tools/；SKILL.md 沒有保留可由標準輸入輸出執行的細節流程
 - [ ] 細節流程已標示 MUST run as a sub agent
 - [ ] gitea 操作透過 gitea.sh 或 tea