技能调酒师 MJorgin/skill-bartender

🍸 skill-bartender

为每个任务调一杯合适的技能鸡尾酒——绝不倒出没尝过的酒。

你的智能体已经能看到一份技能目录，里面有技能名称和描述——但它倒得太满：加载太多技能，加载错的技能，或者漏掉那个能串起整个任务的工作流技能。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 扫描 → 把脚本给人看（默认拒绝）→ 明确同意 → 安装；记录来源 + commit hash + 判定结果 | 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 skill-bartender

也可以直接从 GitHub 装：dsh plugin --profile web add github:MJorgin/skill-bartender。

然后说一次「skill-bartender」，或者把路由表粘进 AGENTS.md，让它常驻路由。完整示例：docs/EXAMPLES.md。

📸 实际效果

一张图看懂倒酒流程：停在第一个站得住的台阶，没品鉴过绝不安装。

🚀 用法

四种用法：

| 方式 | 怎么做 | 什么时候用 |
| A. 直接点名 | 在任何会话里说「skill-bartender」 | 一次性使用，或首次配置 |
| B. 常驻路由 | 把路由表粘进 AGENTS.md | 每个任务都走阶梯 |
| C. 请求倒一杯 | 「哪个技能适合这个任务？」 | 在多个技能之间挑 |
| D. 酒窖审计 | 「审计我安装的技能」 | 品鉴测试：弱描述会被改写 |

skill-bartender 自己必须先加载一次（用户主动触发或任务匹配）——它从不自触发，也从不「以防万一」预加载。

🔐 安全模型（请读这段）

- 技能本质是指令，而指令可能带有对抗性（提示词注入）。SkillSpector 是过滤器，不是保证。
- 任何技能里的 scripts/ 都是代码——未经人工审查绝不执行。
- 每次安装都必须人工批准。永远不允许静默安装。
- 这个技能自扫描结果干净：SkillSpector 0 项发现（评分 0 / SAFE）——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 # the skill itself (one file, three platforms)
│ └── references/policy.md # user-editable routing table
├── docs/
│ ├── screenshots/how-it-works.png
│ ├── eval.md # gold-task suite
│ ├── EXAMPLES.md / ROUTING-GUIDE.md
│ ├── skillspector-report.json # self-scan: 0 findings
│ ├── social-preview.png # banner (regenerate via scripts/)
│ └── lang/README_ZH.md # 简体中文 ├── scripts/ │ ├── make-banner.py # composes docs/social-preview.png │ ├── make-diagram.py # composes the how-it-works diagram │ └── validate.py # local structure validation ├── cordis.patch.yml / index.js / package.json # DSH bundle manifest └── 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 里。