前言¶

在 Cursor、Claude Code 等環境裏，Agent 經常通過 Bash 工具跑 grep、docker compose、kubectl 一類命令。終端裏能看到輸出，但整條命令裏管道、重定向、選項組合的含義，往往需要你自己查 man 或拆開來問模型。

bash-explainer 是 SkillHub 上的一條社區 Skill（座標 @user_846d0839/bash-explainer，當前版本 1.0.0）。它不靠額外 API Key，而是用 SKILL.md 裏寫明的觸發條件，引導 Agent 在合適時機用自然語言說明「剛執行了什麼、各段在幹什麼」。下面介紹它的定位、能力與安裝方式。

這是什麼¶

bash-explainer 面向 Shell 命令理解與講解：當對話裏確實涉及 Bash，或你明確追問某條命令的含義時，Agent 應加載該 Skill 並按其說明組織解釋。

• 維護方：SkillHub 社區發佈者 user_846d0839，來源標註爲 community。
• 分類：dev-programming。
• 依賴：標籤 requires_api_key=false，不依賴外部 API Key。
• 商店數據（SkillHub 頁面與抓取資料）：評分 100000，下載約 820 次，安裝約 2 次（統計會隨時間變化）。

官方入口：

• Skill 頁：https://www.skillhub.cn/skills/user_846d0839/bash-explainer
• API 座標頁：https://api.skillhub.cn/user_846d0839/bash-explainer

核心功能¶

公開簡介以 何時觸發、何時不觸發 爲主，可覈實能力如下。

觸發條件（TRIGGER when）¶

1. 任意 Bash 工具執行完成之後——Agent 跑完一條 shell 命令後，可據此 Skill 對剛執行的命令做說明。
2. 用戶問 「what does this command do」 或 「explain this command」（或語義相同的「這條命令做什麼 / 解釋一下」）。
3. 用戶詢問 某條具體 shell 命令的含義。

不觸發條件（DO NOT TRIGGER when）¶

• 對話中 沒有執行過 bash 命令，且用戶 也不是在問 shell 命令 時，不應啓用該 Skill。

除上述規則外，頁面未單獨列出腳本、MCP 或固定輸出模板；實際解釋仍由當前 Agent 與模型生成，Skill 負責約束 什麼時候該講、講什麼對象。

安裝與啓用¶

Skill 遵循通用 SKILL.md 格式，需安裝到當前 Agent 能識別的 skills 目錄，否則不會被加載。

方式一：用 SkillHub CLI 安裝（推薦）¶

先確認本機是否已有 skillhub：

command -v skillhub && skillhub --version

若未安裝，可按 SkillHub 官方安裝文檔安裝 CLI（完整安裝或僅 CLI）：

# 完整安裝（CLI + 默認 Skill，推薦）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

# 僅安裝 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安裝 Skill 時 必須 使用 --dir 指向當前環境的 skills 目錄。官方文檔強調：省略 --dir 會默認裝到 ./skills/，Agent 可能識別不到，且部分環境仍需重啓後生效。

skillhub install @user_846d0839/bash-explainer --dir <你的 skills 目錄>

常用客戶端 skills 路徑（摘自 https://skillhub.cn/install/skillhub.md ）：

將 <你的 skills 目錄> 換成上表中與你當前工具對應的路徑即可。

方式二：讓 Agent 按官方提示安裝¶

SkillHub 頁面提供的安裝提示大意爲：請 Agent 閱讀 https://skillhub.cn/install/skillhub.md，並安裝 @user_846d0839/bash-explainer。適合已開啓「讓 AI 執行安裝步驟」的工作流。

各客戶端對「安裝後是否需重啓 / 重載窗口」的說明以各自文檔爲準；SkillHub 安裝指南僅統一要求 --dir 與目錄正確。

典型用法¶

官方未給出固定對話腳本，用法由觸發條件推導，可在本地復現下列模式。

1. 執行後自動講解
   讓 Agent 通過 Bash 工具執行一條你不熟悉的命令（例如帶管道、子 shell 或長選項的組合）。命令結束後，直接問：「解釋一下剛纔那條命令」或 “explain this command”。在已安裝 bash-explainer 的前提下，Agent 應按 Skill 約束針對 剛執行的 bash 做分段說明。

2. 點名某條命令
   在未執行的情況下，粘貼一條 shell 命令並問其含義。Skill 寫明可對 特定 shell 命令 的語義作答；若上下文裏完全沒有 bash 且問題也與 shell 無關，則不應誤觸發。

3. 與日常開發結合
   排查 CI 日誌、讀同事留下的 one-liner、或 Agent 自動生成的修復命令時，用上述問法把「符號級」輸出變成「步驟級」說明，無需另開終端查 man。

說明質量取決於模型與對話上下文；Skill 不保證固定章節結構或逐字引用 man 頁。

適用場景與注意¶

適合誰

• 經常讓 Agent 跑 shell、但希望自己仍能看懂每一段的開發者。
• 需要快速弄清管道、重定向、常見 CLI 選項，又不想每次手動拆命令的人。

限制與注意

• 觸發邊界：沒有 bash 執行、也不是在問 shell 時，不應依賴該 Skill；其它類型問題應走通用對話或其它 Skill。
• 非沙箱替代品：解釋命令不等於判斷命令是否安全；複製粘貼前仍要自行確認路徑、權限與破壞性操作。
• 統計與版本：以 SkillHub 頁面爲準（當前列爲 v1.0.0）；下載量、安裝量會更新，本文不寫死爲線索中的其它數字。
• 平臺差異：僅覈實到 SkillHub 通用安裝流程與各客戶端 skills 路徑；Codex CLI、Claude Code、Cursor 在「技能發現優先級」上的細節，以你本機 Agent 與 https://skillhub.cn/install/skillhub.md 爲準。

結尾¶

bash-explainer 用明確的 TRIGGER / DO NOT TRIGGER 規則，把「解釋 Bash」從偶發追問變成可預期的 Agent 行爲：執行後有據可依，提問有範圍可守，且無需 API Key。若你在 SkillHub 上篩選 dev-programming 類工具，可按座標安裝試用。

• Skill 主頁：https://www.skillhub.cn/skills/user_846d0839/bash-explainer
• 安裝說明：https://skillhub.cn/install/skillhub.md