前言¶
在 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）¶
- 任意 Bash 工具执行完成之后——Agent 跑完一条 shell 命令后，可据此 Skill 对刚执行的命令做说明。
- 用户问 「what does this command do」 或 「explain this command」（或语义相同的「这条命令做什么 / 解释一下」）。
- 用户询问 某条具体 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 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
将 <你的 skills 目录> 换成上表中与你当前工具对应的路径即可。
方式二：让 Agent 按官方提示安装¶
SkillHub 页面提供的安装提示大意为：请 Agent 阅读 https://skillhub.cn/install/skillhub.md，并安装 @user_846d0839/bash-explainer。适合已开启「让 AI 执行安装步骤」的工作流。
各客户端对「安装后是否需重启 / 重载窗口」的说明以各自文档为准；SkillHub 安装指南仅统一要求 --dir 与目录正确。
典型用法¶
官方未给出固定对话脚本，用法由触发条件推导，可在本地复现下列模式。
-
执行后自动讲解
让 Agent 通过 Bash 工具执行一条你不熟悉的命令（例如带管道、子 shell 或长选项的组合）。命令结束后，直接问：「解释一下刚才那条命令」或 “explain this command”。在已安装 bash-explainer 的前提下，Agent 应按 Skill 约束针对 刚执行的 bash 做分段说明。 -
点名某条命令
在未执行的情况下，粘贴一条 shell 命令并问其含义。Skill 写明可对 特定 shell 命令 的语义作答；若上下文里完全没有 bash 且问题也与 shell 无关，则不应误触发。 -
与日常开发结合
排查 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
