技能调酒师MJorgin/skill-bartender

🍸 skill-bartender

为每个任务调制恰到好处的技能鸡尾酒——绝不倒入未经品尝的酒。

License: MIT
SkillSpector CI
DeepSeek Harness
Self-scan
Laziness ladder
Platforms
Docs

你的智能体已经能看到一份技能名称与描述的目录——但它倒得太满：加载了太多技能、加载了错误的技能，或者漏掉了那个能组合出任务的唯一工作流技能。skill-bartender 就是修正这次倒酒方式的元技能：

- 🪜 懒惰阶梯——普通工具足够时用零个技能；有一个匹配时用一个技能；工作流优先于手工拼凑的原子技能；不确定 → 不加载。
- 🍷 路由表——一份用户可编辑的任务→技能映射（references/policy.md），可覆盖默认设置。
- 🔐 安全酒窖——需要的技能缺失？隔离 → SkillSpector 扫描 → 明确的人工批准 → 安装。绝不自动安装。
- 🧠 学习——已加载但未使用的技能会被记录，下次跳过。
- 🧪 品鉴测试——审计已安装的技能，并将薄弱的描述改写为“何时使用”的句子。

为什么 · 你能得到什么 · 快速开始 · 实际效果 · 用法 · 安全模型 · 常见问题 · 示例 · 布局 · 许可证

English · 简体中文

🤔 为什么

大多数智能体把技能目录当作自助吃到饱。skill-bartender 则把它当作一间需要品鉴的酒吧：

| | skill-bartender | 典型的目录行为 |
|---|---|---|
| 每个任务加载的技能数 | 通常一个；普通工具足够时为零 | 匹配多少就加载多少 |
| 工作流技能 | ✅ 优先——绝不手工拼凑原子技能 | ❌ 经常被漏掉或手工拼凑 |
| 对匹配不确定时 | ❌ 不加载（宁可漏掉，也不误倒） | ⚠️ “以防万一”地加载 |
| 安装缺失的技能 | 🔐 隔离 → 扫描 → 人工批准 | ⚠️ 直接下载到技能目录 |
| 自动安装 | ❌ 设计上绝不 | ⚠️ 常常静默进行 |
| 从无用的加载中学习 | ✅ 已记录，下次跳过 | ❌ 无记忆 |

为什么是“懒惰阶梯”？ 错误的技能正文会永远留在对话历史中；一次错过的加载只花费一次工具往返。最好的加载是从未发生的加载（精神：ponytail）。

✨ 你能得到什么

| 能力 | 作用 | 位置 |
|---|---|---|
| 🪜 懒惰阶梯 | 在第一个成立的阶梯处停止：0 无技能 → 1 一个技能 → 2 工作流技能 → 3 不确定，不加载 | 所有平台 |
| 🍷 路由表 | references/policy.md 中的任务→技能映射；按路径模式路由的 URL 键控族（doc/drive/wiki/sheets/base/slides） | 所有平台 |
| 🔐 安全酒窖 | 缺少技能：搜索 → 隔离目录 → SkillSpector 扫描 → 脚本展示给人类（默认拒绝）→ 明确同意 → 安装；记录来源 + 提交哈希 + 判定 | DSH、Claude Code、Codex |
| 🧠 学习 | 未使用的加载会被记录，并在下次同一任务类型时跳过；长期未出现的技能会被提议移除 | DSH |
| 🧪 品鉴测试 | 按请求：列出已安装技能，将薄弱描述改写为触发短语形式（在 500 字符目录上限内） | 按请求 |

⚡ 快速开始

一个文件，三个平台：

DeepSeek Harness
mkdir -p ~/.dsh/skills/skill-bartender
cp skills/skill-bartender/SKILL.md ~/.dsh/skills/skill-bartender/
cp -r skills/skill-bartender/references ~/.dsh/skills/skill-bartender/

Claude Code
mkdir -p ~/.claude/skills/skill-bartender
cp skills/skill-bartender/SKILL.md ~/.claude/skills/skill-bartender/

Codex
mkdir -p ~/.codex/skills/skill-bartender
cp skills/skill-bartender/SKILL.md ~/.codex/skills/skill-bartender/

或者作为 DeepSeek Harness 捆绑包安装：

dsh plugin --profile web add github:akqwpeter-prog/skill-bartender

然后说一次“skill-bartender”，或者将路由表粘贴到你的
AGENTS.md 中以实现始终开启的路由。完整示例：docs/EXAMPLES.md。

📸 实际效果

一张图看懂倒酒流程：在第一个成立的阶梯处停止，未经品鉴测试绝不安装。

🚀 用法

四种使用方式：

| 方式 | 如何操作 | 何时使用 |
|---|---|---|
| A. 说出名称 | 在任何会话中，只需说“skill-bartender” | 一次性或首次设置 |
| B. 始终开启的路由 | 将路由表粘贴到 AGENTS.md | 每个任务都经过阶梯路由 |
| C. 请求倒酒 | “哪个技能适合这个任务？” | 在多个技能之间选择 |
| D. 酒窖审计 | “审计我安装的技能” | 品鉴测试：薄弱描述会被改写 |

skill-bartender 本身必须被加载一次（用户手势或任务匹配）——
它从不自我触发，也从不“以防万一”预加载。

🔐 安全模型（请阅读）
- 技能是指令，而指令可能具有对抗性（提示注入）。SkillSpector 是一个过滤器，而非保证。
- 任何技能中的 scripts/ 都是代码——未经人工审查绝不执行。
- 每次安装都必须经过人工批准。绝不允许静默安装。
- 此技能自扫描结果干净：SkillSpector 0 项发现（评分 0 / 安全）
— docs/skillspector-report.json。
- 安全策略：SECURITY.md。

❓ 常见问题

它会自动安装缺失的技能吗？
不会。每次下载都会进入隔离目录，使用 SkillSpector 进行扫描，只有在明确的人工批准后才会复制到技能根目录。扫描通过只是一个过滤器，而非保证——提示注入能够躲过静态扫描，因此脚本会展示给人工，并默认拒绝。

如果未安装 SkillSpector 怎么办？
uv tool install git+https://github.com/NVIDIA/skillspector.git，或运行 references/policy.md 中的人工检查清单。

它适用于 Claude Code 和 Codex 吗？
是的——同一个 SKILL.md 可在全部三个平台上安装，约需 15 秒。

这与 DshMarket / dsh-find-plugin / dsh-plugin-autoevo 有何不同？
它们负责查找、搜索和自动安装插件。skill-bartender 增加了路由策略（阶梯 + 路由表）以及先隔离后批准的纪律。请将其与生态系统配合使用，而非取而代之。

它如何被评估？
路由策略附带一套黄金任务套件：docs/eval.md。

🎁 示例

- docs/EXAMPLES.md — 真实路由案例、酒窖安装、审计。
- docs/ROUTING-GUIDE.md — 如何编写你自己的任务→技能规则。
- docs/eval.md — 路由策略的黄金任务套件。

🗺️ 布局

skill-bartender/
├── skills/
│   └── skill-bartender/
│       ├── SKILL.md             # 技能本身（一个文件，三个平台）
│       └── references/policy.md # 用户可编辑的路由表
├── docs/
│   ├── screenshots/how-it-works.png
│   ├── eval.md                  # 黄金任务套件
│   ├── EXAMPLES.md / ROUTING-GUIDE.md
│   ├── skillspector-report.json # 自扫描：0 项发现
│   ├── social-preview.png       # 横幅（通过 scripts/ 重新生成）
│   └── lang/README_ZH.md        # 简体中文
├── scripts/
│   ├── make-banner.py           # 合成 docs/social-preview.png
│   ├── make-diagram.py          # 合成工作原理图
│   └── validate.py              # 本地结构验证
├── cordis.patch.yml / index.js / package.json   # DSH 捆绑清单
└── LICENSE (MIT)

🤝 加入 DSH 插件生态系统

DeepSeek Harness 开发者预览版仍处于面向 Harness 开发者的测试阶段；核心插件和基础 API 将持续迭代。我们期待与全球开发者一起，在开源、开放、可复用且可组合的基础设施之上，共同探索智能的上限。

- dsh-plugin 主题
- 快速开始
- DeepSeek Harness 仓库
- 配套执行器：dsh-skill-router

本仓库已打上 dsh-plugin 标签，并
收录于 awesome-dsh-plugin
精选列表中。欢迎提交 PR、issue 和翻译。

📄 许可证

MIT。Ponytail（MIT）仅作引用，并未打包——致敬内容见 SKILL.md。