Blackbox

将编码任务委托给 Blackbox AI CLI 代理。这是一个多模型代理，内置评判器（judge），可通过多个大语言模型（LLM）运行任务并选择最佳结果。需要安装 blackbox CLI 并拥有 Blackbox AI API 密钥。

技能元数据


来源	可选 — 使用 `hermes skills install official/autonomous-ai-agents/blackbox` 安装
路径	`optional-skills/autonomous-ai-agents/blackbox`
版本	`1.0.0`
作者	Hermes Agent (Nous Research)
许可证	MIT
标签	`Coding-Agent`, `Blackbox`, `Multi-Agent`, `Judge`, `Multi-Model`
相关技能	`claude-code`, `codex`, `hermes-agent`

参考：完整 SKILL.md

信息

以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理所看到的指令。

Blackbox CLI

通过 Hermes 终端将编码任务委托给 Blackbox AI。Blackbox 是一个多模型编码代理 CLI，它将任务分发给多个 LLM（Claude、Codex、Gemini、Blackbox Pro），并使用评判器选择最佳实现方案。

该 CLI 是开源的（GPL-3.0，TypeScript，fork 自 Gemini CLI），支持交互式会话、非交互式一次性任务、检查点（checkpointing）、MCP 以及视觉模型切换。

前提条件

已安装 Node.js 20+
已安装 Blackbox CLI：npm install -g @blackboxai/cli

或从源码安装：

git clone https://github.com/blackboxaicode/cli.git
cd cli && npm install && npm install -g .

来自 app.blackbox.ai/dashboard 的 API 密钥
已完成配置：运行 blackbox configure 并输入你的 API 密钥
在终端调用中使用 pty=true — Blackbox CLI 是一个交互式终端应用

一次性任务 (One-Shot Tasks)

terminal(command="blackbox --prompt 'Add JWT authentication with refresh tokens to the Express API'", workdir="/path/to/project", pty=true)

用于快速临时工作：

terminal(command="cd $(mktemp -d) && git init && blackbox --prompt 'Build a REST API for todos with SQLite'", pty=true)

后台模式（长时间任务）

对于需要数分钟的任务，请使用后台模式以便监控进度：

# Start in background with PTY
terminal(command="blackbox --prompt 'Refactor the auth module to use OAuth 2.0'", workdir="~/project", background=true, pty=true)
# Returns session_id

# Monitor progress
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")

# Send input if Blackbox asks a question
process(action="submit", session_id="<id>", data="yes")

# Kill if needed
process(action="kill", session_id="<id>")

检查点与恢复

Blackbox CLI 内置了对暂停和恢复任务的检查点支持：

# After a task completes, Blackbox shows a checkpoint tag
# Resume with a follow-up task:
terminal(command="blackbox --resume-checkpoint 'task-abc123-2026-03-06' --prompt 'Now add rate limiting to the endpoints'", workdir="~/project", pty=true)

会话命令

在交互式会话期间，使用以下命令：

命令	效果
`/compress`	压缩对话历史以节省 token
`/clear`	清除历史并重新开始
`/stats`	查看当前 token 使用情况
`Ctrl+C`	取消当前操作

PR 审查

克隆到临时目录以避免修改工作树：

terminal(command="REVIEW=$(mktemp -d) && git clone https://github.com/user/repo.git $REVIEW && cd $REVIEW && gh pr checkout 42 && blackbox --prompt 'Review this PR against main. Check for bugs, security issues, and code quality.'", pty=true)

并行工作

为独立任务启动多个 Blackbox 实例：

terminal(command="blackbox --prompt 'Fix the login bug'", workdir="/tmp/issue-1", background=true, pty=true)
terminal(command="blackbox --prompt 'Add unit tests for auth'", workdir="/tmp/issue-2", background=true, pty=true)

# Monitor all
process(action="list")

多模型模式

Blackbox 的独特功能是通过多个模型运行同一任务并评判结果。通过 blackbox configure 配置要使用的模型 — 选择多个提供商以启用主席/评判器工作流，其中 CLI 会评估不同模型的输出并选择最佳的一个。

关键标志 (Flags)

标志	效果
`--prompt "task"`	非交互式一次性执行
`--resume-checkpoint "tag"`	从保存的检查点恢复
`--yolo`	自动批准所有操作和模型切换
`blackbox session`	启动交互式聊天会话
`blackbox configure`	更改设置、提供商、模型
`blackbox info`	显示系统信息

视觉支持

Blackbox 会自动检测输入中的图像，并可切换到多模态分析。VLM 模式：

"once" — 仅针对当前查询切换模型
"session" — 在整个会话期间切换
"persist" — 保持在当前模型（不切换）

Token 限制

通过 .blackboxcli/settings.json 控制 token 使用量：

{
  "sessionTokenLimit": 32000
}

规则

始终使用 pty=true — Blackbox CLI 是一个交互式终端应用，如果没有 PTY 将会挂起
使用 workdir — 让代理专注于正确的目录
长时间任务使用后台模式 — 使用 background=true 并通过 process 工具监控
不要干扰 — 使用 poll/log 监控，不要因为会话速度慢而终止它们
报告结果 — 完成后，检查更改内容并向用户总结
积分需付费 — Blackbox 使用基于积分的系统；多模型模式消耗积分更快
检查前提条件 — 在尝试委托之前，验证 blackbox CLI 是否已安装

技能元数据​

参考：完整 SKILL.md​

Blackbox CLI

前提条件​

一次性任务 (One-Shot Tasks)​

后台模式（长时间任务）​

检查点与恢复​

会话命令​

PR 审查​

并行工作​

多模型模式​

关键标志 (Flags)​

视觉支持​

Token 限制​

规则​