better-dsh 0.2.4 → 0.2.5-a

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/profile-commands.md

@@ -0,0 +1,467 @@
+---
+sidebar_position: 7
+---
+
+# Profile 命令参考
+
+本页涵盖所有与 [Hermes profiles](../user-guide/profiles.md) 相关的命令。通用 CLI 命令请参阅 [CLI 命令参考](./cli-commands.md)。
+
+## `hermes profile`
+
+```bash
+hermes profile <subcommand>
+```
+
+管理 profile 的顶级命令。不带子命令运行 `hermes profile` 将显示帮助信息。
+
+| 子命令 | 描述 |
+|------------|-------------|
+| `list` | 列出所有 profile。 |
+| `use` | 设置当前活跃（默认）profile。 |
+| `create` | 创建新 profile。 |
+| `delete` | 删除 profile。 |
+| `show` | 显示 profile 详情。 |
+| `alias` | 重新生成 profile 的 shell alias。 |
+| `rename` | 重命名 profile。 |
+| `export` | 将 profile 导出为 tar.gz 归档文件。 |
+| `import` | 从 tar.gz 归档文件导入 profile。 |
+| `install` | 从 git URL 或本地目录安装 profile 发行版。参见 [Profile 发行版](../user-guide/profile-distributions.md)。 |
+| `update` | 重新拉取发行版管理的 profile 并重新应用其 bundle。 |
+| `info` | 显示 profile 的发行版元数据（来源 URL、commit、最后更新时间）。 |
+
+## `hermes profile list`
+
+```bash
+hermes profile list
+```
+
+列出所有 profile。当前活跃的 profile 以 `*` 标记。
+
+**示例：**
+
+```bash
+$ hermes profile list
+  default
+* work
+  dev
+  personal
+```
+
+无选项。
+
+## `hermes profile use`
+
+```bash
+hermes profile use <name>
+```
+
+将 `<name>` 设为活跃 profile。此后所有 `hermes` 命令（不带 `-p`）都将使用该 profile。
+
+| 参数 | 描述 |
+|----------|-------------|
+| `<name>` | 要激活的 profile 名称。使用 `default` 可返回基础 profile。 |
+
+**示例：**
+
+```bash
+hermes profile use work
+hermes profile use default
+```
+
+## `hermes profile create`
+
+```bash
+hermes profile create <name> [options]
+```
+
+创建新 profile。
+
+| 参数 / 选项 | 描述 |
+|-------------------|-------------|
+| `<name>` | 新 profile 的名称。必须是合法的目录名（字母数字、连字符、下划线）。 |
+| `--clone` | 从当前 profile 复制 `config.yaml`、`.env`、`SOUL.md` 和 skills。 |
+| `--clone-all` | 从当前 profile 复制所有内容（config、memories、skills、cron、plugins）。会排除每个 profile 自己的历史数据：sessions、`state.db`、backups、state-snapshots、checkpoints。 |
+| `--clone-from <profile>` | 从指定 profile 克隆 config/skills/SOUL，而非当前 profile。除非与 `--clone-all` 配合使用，否则会隐含 `--clone`。 |
+| `--no-alias` | 跳过 wrapper 脚本创建。 |
+| `--description "<text>"` | 一到两句话描述该 profile 的用途。供 kanban 编排器根据角色而非仅凭 profile 名称来路由任务。可跳过，稍后通过 `hermes profile describe` 添加。持久化保存在 `<profile_dir>/profile.yaml` 中。 |
+| `--no-skills` | 创建一个**空** profile，不启用任何内置 skill。会在 profile 目录中写入 `.no-bundled-skills` 标记，使后续 `hermes update` 不再重新植入内置 skill 集，且拒绝与 `--clone`、`--clone-from` 或 `--clone-all` 组合使用（因为这些选项会复制 skill）。适用于不应继承完整 skill 目录的窄化编排器 profile 或沙箱 profile。 |
+
+创建 profile **不会**将该 profile 目录设为终端命令的默认项目/工作目录。如需让某个 profile 从特定项目目录启动，请在该 profile 的 `config.yaml` 中设置 `terminal.cwd`。
+
+**示例：**
+
+```bash
+# 空白 profile — 需要完整配置
+hermes profile create mybot
+
+# 仅从当前 profile 克隆 config
+hermes profile create work --clone
+
+# 从当前 profile 克隆所有内容
+hermes profile create backup --clone-all
+
+# 从指定 profile 克隆 config
+hermes profile create work2 --clone-from work
+
+# 从指定 profile 克隆所有内容
+hermes profile create work2-backup --clone-from work --clone-all
+```
+
+## `hermes profile describe`
+
+```bash
+hermes profile describe [<name>] [options]
+```
+
+读取或设置 profile 的描述。描述由 kanban 编排器使用，用于根据每个 profile 的能力路由任务，而非仅凭 profile 名称猜测。持久化保存在 `<profile_dir>/profile.yaml` 中，重启后仍有效，并与 gateway 共享。
+
+不带任何标志时，打印当前描述（若为空则显示 `(no description set for '<name>')`）。
+
+| 参数 / 选项 | 描述 |
+|-------------------|-------------|
+| `<name>` | 要描述的 profile。除非使用 `--all --auto`，否则必填。 |
+| `--text "<text>"` | 将描述设置为此精确文本（用户编写）。覆盖已有描述。 |
+| `--auto` | 通过辅助 LLM 自动生成 1-2 句描述，依据为该 profile 已安装的 skill、配置的模型和名称。在 `config.yaml` 的 `auxiliary.profile_describer` 下配置模型。自动生成的描述会标记 `description_auto: true`，以便 dashboard 标记供审查。 |
+| `--overwrite` | 与 `--auto` 配合使用时，也替换用户编写的描述（默认：跳过已明确设置描述的 profile）。 |
+| `--all` | 与 `--auto` 配合使用时，扫描所有缺少描述的 profile。 |
+
+**示例：**
+
+```bash
+# 读取当前描述
+hermes profile describe researcher
+
+# 显式设置描述
+hermes profile describe researcher --text "Reads source code and writes findings."
+
+# 让 LLM 生成描述
+hermes profile describe researcher --auto
+
+# 为所有没有描述的 profile 填充描述
+hermes profile describe --all --auto
+```
+
+## `hermes profile delete`
+
+```bash
+hermes profile delete <name> [options]
+```
+
+删除 profile 并移除其 shell alias。
+
+| 参数 / 选项 | 描述 |
+|-------------------|-------------|
+| `<name>` | 要删除的 profile。 |
+| `--yes`, `-y` | 跳过确认提示。 |
+
+**示例：**
+
+```bash
+hermes profile delete mybot
+hermes profile delete mybot --yes
+```
+
+:::warning
+此操作将永久删除 profile 的整个目录，包括所有 config、memories、sessions 和 skills。无法删除当前活跃的 profile。
+:::
+
+## `hermes profile show`
+
+```bash
+hermes profile show <name>
+```
+
+显示 profile 的详细信息，包括其主目录、配置的模型、gateway 状态、skill 数量和配置文件状态。
+
+此处显示的是 profile 的 Hermes 主目录，而非终端工作目录。终端命令从 `terminal.cwd` 启动（或在本地后端 `cwd: "."` 时从启动目录启动）。
+
+| 参数 | 描述 |
+|----------|-------------|
+| `<name>` | 要查看的 profile。 |
+
+**示例：**
+
+```bash
+$ hermes profile show work
+Profile: work
+Path:    ~/.hermes/profiles/work
+Model:   anthropic/claude-sonnet-4 (anthropic)
+Gateway: stopped
+Skills:  12
+.env:    exists
+SOUL.md: exists
+Alias:   ~/.local/bin/work
+```
+
+## `hermes profile alias`
+
+```bash
+hermes profile alias <name> [options]
+```
+
+重新生成位于 `~/.local/bin/<name>` 的 shell alias 脚本。适用于 alias 被意外删除，或移动 Hermes 安装目录后需要更新的情况。
+
+| 参数 / 选项 | 描述 |
+|-------------------|-------------|
+| `<name>` | 要创建/更新 alias 的 profile。 |
+| `--remove` | 移除 wrapper 脚本而非创建。 |
+| `--name <alias>` | 自定义 alias 名称（默认：profile 名称）。 |
+
+**示例：**
+
+```bash
+hermes profile alias work
+# 创建/更新 ~/.local/bin/work
+
+hermes profile alias work --name mywork
+# 创建 ~/.local/bin/mywork
+
+hermes profile alias work --remove
+# 移除 wrapper 脚本
+```
+
+## `hermes profile rename`
+
+```bash
+hermes profile rename <old-name> <new-name>
+```
+
+重命名 profile，同时更新目录和 shell alias。
+
+| 参数 | 描述 |
+|----------|-------------|
+| `<old-name>` | 当前 profile 名称。 |
+| `<new-name>` | 新 profile 名称。 |
+
+**示例：**
+
+```bash
+hermes profile rename mybot assistant
+# ~/.hermes/profiles/mybot → ~/.hermes/profiles/assistant
+# ~/.local/bin/mybot → ~/.local/bin/assistant
+```
+
+## `hermes profile export`
+
+```bash
+hermes profile export <name> [options]
+```
+
+将 profile 导出为压缩的 tar.gz 归档文件。
+
+| 参数 / 选项 | 描述 |
+|-------------------|-------------|
+| `<name>` | 要导出的 profile。 |
+| `-o`, `--output <path>` | 输出文件路径（默认：`<name>.tar.gz`）。 |
+
+**示例：**
+
+```bash
+hermes profile export work
+# 在当前目录创建 work.tar.gz
+
+hermes profile export work -o ./work-2026-03-29.tar.gz
+```
+
+## `hermes profile import`
+
+```bash
+hermes profile import <archive> [options]
+```
+
+从 tar.gz 归档文件导入 profile。
+
+| 参数 / 选项 | 描述 |
+|-------------------|-------------|
+| `<archive>` | 要导入的 tar.gz 归档文件路径。 |
+| `--name <name>` | 导入后的 profile 名称（默认：从归档文件推断）。 |
+
+**示例：**
+
+```bash
+hermes profile import ./work-2026-03-29.tar.gz
+# 从归档文件推断 profile 名称
+
+hermes profile import ./work-2026-03-29.tar.gz --name work-restored
+```
+
+## 发行版命令
+
+:::tip
+**初次接触发行版？** 请先阅读 [Profile 发行版用户指南](../user-guide/profile-distributions.md) — 其中通过完整示例介绍了原因、时机和方法。以下章节是在你已知需求时使用的简明 CLI 参考。
+:::
+
+发行版将 profile 转变为可共享、有版本的制品，以 **git 仓库**形式发布。接收方只需一条命令即可安装发行版，并可在不影响本地 memories、sessions 或凭据的情况下就地更新。
+
+`auth.json` 和 `.env` 永远不属于发行版的一部分 — 它们保留在安装用户的机器上。
+
+接收方的用户数据（memories、sessions、auth、对 `.env` 的自有编辑）在初次安装和后续更新中始终得到保留。
+
+:::info
+`hermes profile export` / `import` 仍是在**本机进行 profile 本地备份和恢复**的正确命令。发行版（`install` / `update` / `info`）是独立概念：通过 git 分发 profile，供他人安装。
+:::
+
+### `hermes profile install`
+
+```bash
+hermes profile install <source> [--name <name>] [--alias] [--force] [--yes]
+```
+
+从 git URL 或本地目录安装 profile 发行版。
+
+| 选项 | 描述 |
+|--------|-------------|
+| `<source>` | Git URL（`github.com/user/repo`、`https://...`、`git@...`、`ssh://`、`git://`）或包含 `distribution.yaml` 的本地目录根路径。 |
+| `--name NAME` | 覆盖 manifest 中的 profile 名称。 |
+| `--alias` | 同时创建 shell wrapper（例如 `telemetry` → `hermes -p telemetry`）。 |
+| `--force` | 覆盖同名的已有 profile。用户数据仍会保留。 |
+| `-y`, `--yes` | 跳过 manifest 预览确认提示。 |
+
+安装程序会显示 manifest、列出所需的环境变量，并在询问确认前提示 cron 任务信息。所需环境变量会写入 `.env.EXAMPLE` 文件，复制为 `.env` 后填写即可。
+
+**示例：**
+
+```bash
+# 从 GitHub 仓库安装（简写）
+hermes profile install github.com/kyle/telemetry-distribution --alias
+
+# 从完整 HTTPS git URL 安装
+hermes profile install https://github.com/kyle/telemetry-distribution.git
+
+# 从 SSH 安装
+hermes profile install git@github.com:kyle/telemetry-distribution.git
+
+# 开发时从本地目录安装
+hermes profile install ./telemetry/
+```
+
+### `hermes profile update`
+
+```bash
+hermes profile update <name> [--force-config] [--yes]
+```
+
+从记录的来源重新克隆发行版并应用更新。发行版所有的文件（SOUL.md、skills/、cron/、mcp.json）会被覆盖；用户数据（memories、sessions、auth、.env）不会被修改。
+
+默认保留 `config.yaml` 以保持本地覆盖设置。传入 `--force-config` 可将其重置为发行版附带的 config。
+
+### `hermes profile info`
+
+```bash
+hermes profile info <name>
+```
+
+打印 profile 的发行版 manifest — 名称、版本、所需 Hermes 版本、作者、环境变量要求、来源 URL/路径，以及发行版最后一次 `install` 或 `update` 时记录的 `Installed:` 时间戳。适用于安装前检查共享 profile 的需求，以及发现"该 profile 已安装 6 个月未更新"等情况。
+
+`hermes profile list` 也会在 `Distribution` 列中显示发行版名称和版本，`hermes profile show <name>` / `delete <name>` 会显示来源 URL，让你一眼看出哪些 profile 来自 git 仓库，哪些是本地创建的。
+
+### 私有发行版
+
+私有 git 仓库无需额外配置即可作为发行版来源 — 安装时会调用系统的 `git` 二进制文件，因此 shell 已配置的任何认证方式（SSH 密钥、`git credential` helper、GitHub CLI 存储的 HTTPS 凭据）均可透明生效。
+
+```bash
+# 使用 SSH 密钥，与普通 `git clone` 相同
+hermes profile install git@github.com:your-org/internal-assistant.git
+
+# 使用 git credential helper
+hermes profile install https://github.com/your-org/internal-assistant.git
+```
+
+如果克隆时在终端交互式提示输入凭据，该提示会正常显示。请先按照对同一仓库执行 `git clone` 的方式配置好认证，再执行安装。
+
+### 发行版 manifest（`distribution.yaml`）
+
+每个发行版在其仓库根目录都有一个 `distribution.yaml`：
+
+```yaml
+name: telemetry
+version: 0.1.0
+description: "Compliance monitoring harness"
+hermes_requires: ">=0.12.0"
+author: "Your Name"
+license: "MIT"
+env_requires:
+  - name: OPENAI_API_KEY
+    description: "OpenAI API key"
+    required: true
+  - name: GRAPHITI_MCP_URL
+    description: "Memory graph URL"
+    required: false
+    default: "http://127.0.0.1:8000/sse"
+distribution_owned:   # optional; defaults to SOUL.md, config.yaml,
+                      #   mcp.json, skills/, cron/, distribution.yaml
+  - SOUL.md
+  - skills/compliance/
+  - cron/
+```
+
+`hermes_requires` 支持 `>=`、`<=`、`==`、`!=`、`>`、`<`，或裸版本号（视为 `>=`）。若当前 Hermes 版本不满足规格，安装将失败并给出明确错误。
+
+`distribution_owned` 为可选项。若设置，更新时仅替换这些路径；profile 中的其他内容保持用户所有。若省略，则应用上述默认值。
+
+### 发布发行版
+
+编写发行版就是一次 git push：
+
+1. 在你的 profile 目录中创建 `distribution.yaml`，至少包含 `name` 和 `version`。
+2. 初始化 git 仓库（或使用已有仓库），推送到 GitHub / GitLab / 任何 Hermes 可克隆的托管平台。
+3. 告知接收方运行 `hermes profile install <your-repo-url>`。
+
+使用 git tag 进行版本化发布 — 克隆 `HEAD` 的接收方将获得最新状态，你也可以随时在 manifest 中更新 `version:`。
+
+## `hermes -p` / `hermes --profile`
+
+```bash
+hermes -p <name> <command> [options]
+hermes --profile <name> <command> [options]
+```
+
+全局标志，用于在不更改默认 profile 的情况下，在指定 profile 下运行任意 Hermes 命令。仅在该命令执行期间覆盖活跃 profile。
+
+| 选项 | 描述 |
+|--------|-------------|
+| `-p <name>`, `--profile <name>` | 本次命令使用的 profile。 |
+
+**示例：**
+
+```bash
+hermes -p work chat -q "Check the server status"
+hermes --profile dev gateway start
+hermes -p personal skills list
+hermes -p work config edit
+```
+
+## `hermes completion`
+
+```bash
+hermes completion <shell>
+```
+
+生成 shell 补全脚本。包含对 profile 名称和 profile 子命令的补全。
+
+| 参数 | 描述 |
+|----------|-------------|
+| `<shell>` | 要生成补全脚本的 shell：`bash`、`zsh` 或 `fish`。 |
+
+**示例：**
+
+```bash
+# 安装补全脚本
+hermes completion bash >> ~/.bashrc
+hermes completion zsh >> ~/.zshrc
+hermes completion fish > ~/.config/fish/completions/hermes.fish
+
+# 重新加载 shell
+source ~/.bashrc
+```
+
+安装后，Tab 补全适用于：
+- `hermes profile <TAB>` — 子命令（list、use、create 等）
+- `hermes profile use <TAB>` — profile 名称
+- `hermes -p <TAB>` — profile 名称
+
+## 另请参阅
+
+- [Profiles 用户指南](../user-guide/profiles.md)
+- [CLI 命令参考](./cli-commands.md)
+- [FAQ — Profiles 章节](./faq.md#profiles)

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/skills-catalog.md

@@ -0,0 +1,156 @@
+---
+sidebar_position: 5
+title: "内置技能目录"
+description: "随 Hermes Agent 附带的内置技能目录"
+---
+
+# 内置技能目录
+
+Hermes 附带一个大型内置技能库，安装时会复制到 `~/.hermes/skills/`。下方每个技能均链接至专属页面，包含完整定义、配置和用法说明。
+
+Hermes 在执行 `hermes update` 时也会同步内置技能，但同步清单会尊重本地删除和用户编辑。如果此处列出的某个技能在你的 `~/.hermes/skills/` 目录树中缺失，它仍随 Hermes 一同发布；可通过 `hermes skills reset <name> --restore` 恢复。
+
+如果某个技能未出现在此列表中但存在于仓库中，目录由 `website/scripts/generate-skill-docs.py` 重新生成。
+
+## apple
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`apple-notes`](/user-guide/skills/bundled/apple/apple-apple-notes) | 通过 memo CLI 管理 Apple Notes：创建、搜索、编辑。 | `apple/apple-notes` |
+| [`apple-reminders`](/user-guide/skills/bundled/apple/apple-apple-reminders) | 通过 remindctl 操作 Apple Reminders：添加、列出、完成。 | `apple/apple-reminders` |
+| [`findmy`](/user-guide/skills/bundled/apple/apple-findmy) | 在 macOS 上通过 FindMy.app 追踪 Apple 设备/AirTag。 | `apple/findmy` |
+| [`imessage`](/user-guide/skills/bundled/apple/apple-imessage) | 在 macOS 上通过 imsg CLI 发送和接收 iMessage/SMS。 | `apple/imessage` |
+| [`macos-computer-use`](/user-guide/skills/bundled/apple/apple-macos-computer-use) | 在后台驱动 macOS 桌面——截图、鼠标、键盘、滚动、拖拽——不抢占用户的光标、键盘焦点或 Space。适用于任何支持工具调用的模型。每当需要 `computer_use` 工具时加载此技能。 | `apple/macos-computer-use` |
+
+## autonomous-ai-agents
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`claude-code`](/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-claude-code) | 将编码任务委托给 Claude Code CLI（功能开发、PR）。 | `autonomous-ai-agents/claude-code` |
+| [`codex`](/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-codex) | 将编码任务委托给 OpenAI Codex CLI（功能开发、PR）。 | `autonomous-ai-agents/codex` |
+| [`hermes-agent`](/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-hermes-agent) | 配置、扩展或贡献 Hermes Agent。 | `autonomous-ai-agents/hermes-agent` |
+| [`opencode`](/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-opencode) | 将编码任务委托给 OpenCode CLI（功能开发、PR 审查）。 | `autonomous-ai-agents/opencode` |
+
+## creative
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`architecture-diagram`](/user-guide/skills/bundled/creative/creative-architecture-diagram) | 以 HTML 形式生成深色主题的 SVG 架构/云/基础设施图。 | `creative/architecture-diagram` |
+| [`ascii-art`](/user-guide/skills/bundled/creative/creative-ascii-art) | ASCII 艺术：pyfiglet、cowsay、boxes、图像转 ASCII。 | `creative/ascii-art` |
+| [`ascii-video`](/user-guide/skills/bundled/creative/creative-ascii-video) | ASCII 视频：将视频/音频转换为彩色 ASCII MP4/GIF。 | `creative/ascii-video` |
+| [`baoyu-infographic`](/user-guide/skills/bundled/creative/creative-baoyu-infographic) | 信息图（可视化）：21 种布局 × 21 种风格。 | `creative/baoyu-infographic` |
+| [`claude-design`](/user-guide/skills/bundled/creative/creative-claude-design) | 设计一次性 HTML 制品（落地页、幻灯片、原型）。 | `creative/claude-design` |
+| [`comfyui`](/user-guide/skills/bundled/creative/creative-comfyui) | 使用 ComfyUI 生成图像、视频和音频——安装、启动、管理节点/模型、运行带参数注入的工作流。使用官方 comfy-cli 管理生命周期，通过 REST/WebSocket API 直接执行。 | `creative/comfyui` |
+| [`design-md`](/user-guide/skills/bundled/creative/creative-design-md) | 编写/验证/导出 Google 的 DESIGN.md token 规范文件。 | `creative/design-md` |
+| [`excalidraw`](/user-guide/skills/bundled/creative/creative-excalidraw) | 手绘风格的 Excalidraw JSON 图表（架构、流程、时序）。 | `creative/excalidraw` |
+| [`humanizer`](/user-guide/skills/bundled/creative/creative-humanizer) | 人性化文本：去除 AI 腔，加入真实语气。 | `creative/humanizer` |
+| [`manim-video`](/user-guide/skills/bundled/creative/creative-manim-video) | Manim CE 动画：3Blue1Brown 风格数学/算法视频。 | `creative/manim-video` |
+| [`p5js`](/user-guide/skills/bundled/creative/creative-p5js) | p5.js 草图：生成艺术、着色器、交互、3D。 | `creative/p5js` |
+| [`popular-web-designs`](/user-guide/skills/bundled/creative/creative-popular-web-designs) | 54 种真实设计系统（Stripe、Linear、Vercel）的 HTML/CSS 实现。 | `creative/popular-web-designs` |
+| [`pretext`](/user-guide/skills/bundled/creative/creative-pretext) | 使用 @chenglou/pretext 构建创意浏览器 demo——无 DOM 的文本布局，支持 ASCII 艺术、绕障碍物的排版流、文字即几何游戏、动态排版和文字驱动的生成艺术。生成单文件 HTML。 | `creative/pretext` |
+| [`sketch`](/user-guide/skills/bundled/creative/creative-sketch) | 一次性 HTML 原型：生成 2-3 个设计变体供对比。 | `creative/sketch` |
+| [`songwriting-and-ai-music`](/user-guide/skills/bundled/creative/creative-songwriting-and-ai-music) | 歌曲创作技巧与 Suno AI 音乐 prompt（提示词）。 | `creative/songwriting-and-ai-music` |
+
+## devops
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+
+
+## email
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`himalaya`](/user-guide/skills/bundled/email/email-himalaya) | Himalaya CLI：在终端中收发 IMAP/SMTP 邮件。 | `email/himalaya` |
+
+## gaming
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+
+## github
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`codebase-inspection`](/user-guide/skills/bundled/github/github-codebase-inspection) | 使用 pygount 检查代码库：代码行数、语言、占比。 | `github/codebase-inspection` |
+| [`github-auth`](/user-guide/skills/bundled/github/github-github-auth) | GitHub 认证配置：HTTPS token、SSH 密钥、gh CLI 登录。 | `github/github-auth` |
+| [`github-code-review`](/user-guide/skills/bundled/github/github-github-code-review) | 审查 PR：通过 gh 或 REST API 查看 diff、添加行内评论。 | `github/github-code-review` |
+| [`github-issues`](/user-guide/skills/bundled/github/github-github-issues) | 通过 gh 或 REST API 创建、分类、标记、分配 GitHub issue。 | `github/github-issues` |
+| [`github-pr-workflow`](/user-guide/skills/bundled/github/github-github-pr-workflow) | GitHub PR 生命周期：分支、提交、开启、CI、合并。 | `github/github-pr-workflow` |
+| [`github-repo-management`](/user-guide/skills/bundled/github/github-github-repo-management) | 克隆/创建/fork 仓库；管理远程、发布版本。 | `github/github-repo-management` |
+
+## mcp
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+
+## media
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`gif-search`](/user-guide/skills/bundled/media/media-gif-search) | 通过 curl + jq 从 Tenor 搜索/下载 GIF。 | `media/gif-search` |
+| [`songsee`](/user-guide/skills/bundled/media/media-songsee) | 通过 CLI 生成音频频谱图/特征（mel、chroma、MFCC）。 | `media/songsee` |
+| [`youtube-content`](/user-guide/skills/bundled/media/media-youtube-content) | 将 YouTube 字幕转换为摘要、推文串、博客文章。 | `media/youtube-content` |
+
+## mlops
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`huggingface-hub`](/user-guide/skills/bundled/mlops/mlops-huggingface-hub) | HuggingFace hf CLI：搜索/下载/上传模型、数据集。 | `mlops/huggingface-hub` |
+| [`llama-cpp`](/user-guide/skills/bundled/mlops/mlops-inference-llama-cpp) | llama.cpp 本地 GGUF 推理 + HF Hub 模型发现。 | `mlops/inference/llama-cpp` |
+| [`evaluating-llms-harness`](/user-guide/skills/bundled/mlops/mlops-evaluation-evaluating-llms-harness) | lm-eval-harness：对 LLM 进行基准测试（MMLU、GSM8K 等）。 | `mlops/evaluation/evaluating-llms-harness` |
+| [`serving-llms-vllm`](/user-guide/skills/bundled/mlops/mlops-inference-serving-llms-vllm) | vLLM：高吞吐量 LLM 服务、OpenAI API 兼容、量化支持。 | `mlops/inference/serving-llms-vllm` |
+| [`weights-and-biases`](/user-guide/skills/bundled/mlops/mlops-evaluation-weights-and-biases) | W&B：记录 ML 实验、超参数搜索、模型注册表、仪表盘。 | `mlops/evaluation/weights-and-biases` |
+
+## note-taking
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`obsidian`](/user-guide/skills/bundled/note-taking/note-taking-obsidian) | 在 Obsidian 知识库中读取、搜索、创建和编辑笔记。 | `note-taking/obsidian` |
+
+## productivity
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`airtable`](/user-guide/skills/bundled/productivity/productivity-airtable) | 通过 curl 调用 Airtable REST API：记录增删改查、过滤、upsert。 | `productivity/airtable` |
+| [`google-workspace`](/user-guide/skills/bundled/productivity/productivity-google-workspace) | 通过 gws CLI 或 Python 操作 Gmail、Calendar、Drive、Docs、Sheets。 | `productivity/google-workspace` |
+| [`maps`](/user-guide/skills/bundled/productivity/productivity-maps) | 通过 OpenStreetMap/OSRM 进行地理编码、POI 查询、路线规划、时区查询。 | `productivity/maps` |
+| [`nano-pdf`](/user-guide/skills/bundled/productivity/productivity-nano-pdf) | 通过自然语言指令编辑现有 PDF 中的文本。 | `productivity/nano-pdf` |
+| [`notion`](/user-guide/skills/bundled/productivity/productivity-notion) | Notion API + ntn CLI：页面、数据库、Markdown、Workers。 | `productivity/notion` |
+| [`ocr-and-documents`](/user-guide/skills/bundled/productivity/productivity-ocr-and-documents) | 从 PDF/扫描件中提取文本（pymupdf、marker-pdf）。 | `productivity/ocr-and-documents` |
+| [`powerpoint`](/user-guide/skills/bundled/productivity/productivity-powerpoint) | 创建、读取、编辑 .pptx 演示文稿、幻灯片、备注、模板。 | `productivity/powerpoint` |
+| [`teams-meeting-pipeline`](/user-guide/skills/bundled/productivity/productivity-teams-meeting-pipeline) | 通过 Hermes CLI 操作 Teams 会议摘要流水线——汇总会议、检查流水线状态、重放任务、管理 Microsoft Graph 订阅。 | `productivity/teams-meeting-pipeline` |
+
+## research
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`arxiv`](/user-guide/skills/bundled/research/research-arxiv) | 按关键词、作者、分类或 ID 搜索 arXiv 论文。 | `research/arxiv` |
+| [`blogwatcher`](/user-guide/skills/bundled/research/research-blogwatcher) | 通过 blogwatcher-cli 工具监控博客和 RSS/Atom 订阅源。 | `research/blogwatcher` |
+| [`llm-wiki`](/user-guide/skills/bundled/research/research-llm-wiki) | Karpathy 的 LLM Wiki：构建/查询互联 Markdown 知识库。 | `research/llm-wiki` |
+| [`research-paper-writing`](/user-guide/skills/bundled/research/research-research-paper-writing) | 为 NeurIPS/ICML/ICLR 撰写 ML 论文：从设计到投稿。 | `research/research-paper-writing` |
+
+## smart-home
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`openhue`](/user-guide/skills/bundled/smart-home/smart-home-openhue) | 通过 OpenHue CLI 控制 Philips Hue 灯光、场景、房间。 | `smart-home/openhue` |
+
+## social-media
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`xurl`](/user-guide/skills/bundled/social-media/social-media-xurl) | 通过 xurl CLI 操作 X/Twitter：发帖、搜索、私信、媒体、v2 API。 | `social-media/xurl` |
+
+## software-development
+
+| 技能 | 描述 | 路径 |
+|-------|-------------|------|
+| [`dogfood`](/user-guide/skills/bundled/software-development/software-development-dogfood) | Web 应用探索性 QA：发现 bug、收集证据、生成报告。 | `software-development/dogfood` |
+| [`hermes-agent-skill-authoring`](/user-guide/skills/bundled/software-development/software-development-hermes-agent-skill-authoring) | 编写仓库内 SKILL.md：frontmatter、验证器、结构规范。 | `software-development/hermes-agent-skill-authoring` |
+| [`node-inspect-debugger`](/user-guide/skills/bundled/software-development/software-development-node-inspect-debugger) | 通过 --inspect + Chrome DevTools Protocol CLI 调试 Node.js。 | `software-development/node-inspect-debugger` |
+| [`python-debugpy`](/user-guide/skills/bundled/software-development/software-development-python-debugpy) | 调试 Python：pdb REPL + debugpy 远程调试（DAP）。 | `software-development/python-debugpy` |
+| [`requesting-code-review`](/user-guide/skills/bundled/software-development/software-development-requesting-code-review) | 提交前审查：安全扫描、质量门控、自动修复。 | `software-development/requesting-code-review` |
+| [`spike`](/user-guide/skills/bundled/software-development/software-development-spike) | 一次性实验，在正式构建前验证想法。 | `software-development/spike` |
+| [`systematic-debugging`](/user-guide/skills/bundled/software-development/software-development-systematic-debugging) | 四阶段根因调试：先理解 bug，再修复。 | `software-development/systematic-debugging` |
+| [`test-driven-development`](/user-guide/skills/bundled/software-development/software-development-test-driven-development) | TDD：强制执行红-绿-重构流程，先写测试再写代码。 | `software-development/test-driven-development` |