{/* 此页面由 website/scripts/generate-skill-docs.py 从技能的 SKILL.md 自动生成。请编辑源文件 SKILL.md，而非此页面。 */}
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 |
| 平台 | linux, macos, windows |
| 标签 | Coding-Agent, Blackbox, Multi-Agent, Judge, Multi-Model |
| 相关技能 | claude-code, codex, hermes-agent |
参考：完整 SKILL.md
:::info 以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理所看到的指令。 :::
Blackbox CLI
通过 Hermes 终端将编码任务委托给 Blackbox AI。Blackbox 是一个多模型编码代理 CLI，可将任务分派给多个 LLM（Claude, Codex, Gemini, Blackbox Pro），并使用评判器（Judge）选择最佳实现方案。
该 CLI 是开源的（GPL-3.0, TypeScript, 从 Gemini CLI 衍生），支持交互式会话、非交互式一次性执行、检查点、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 是交互式终端应用
一次性任务
terminal(command="blackbox --prompt '为 Express API 添加带有刷新令牌的 JWT 认证'", workdir="/path/to/project", pty=true)
快速临时项目：
terminal(command="cd $(mktemp -d) && git init && blackbox --prompt '使用 SQLite 构建待办事项 REST API'", pty=true)
后台模式（长任务）
对于需要数分钟的任务，使用后台模式以便监控进度：
# 在后台启动，使用 PTY
terminal(command="blackbox --prompt '重构认证模块以使用 OAuth 2.0'", workdir="~/project", background=true, pty=true)
# 返回 session_id
# 监控进度
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")
# 如果 Blackbox 提问，发送输入
process(action="submit", session_id="<id>", data="yes")
# 需要时终止
process(action="kill", session_id="<id>")
检查点与恢复
Blackbox CLI 内置检查点支持，可暂停和恢复任务：
# 任务完成后，Blackbox 显示一个检查点标签
# 通过后续任务恢复：
terminal(command="blackbox --resume-checkpoint 'task-abc123-2026-03-06' --prompt '现在为端点添加速率限制'", workdir="~/project", pty=true)
会话命令
在交互式会话期间，使用以下命令：
| 命令 | 效果 |
|---|---|
/compress | 压缩对话历史以节省令牌 |
/clear | 清空历史并重新开始 |
/stats | 查看当前令牌使用情况 |
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 '评审此 PR。检查错误、安全问题和代码质量。'", pty=true)
并行工作
为独立任务启动多个 Blackbox 实例：
terminal(command="blackbox --prompt '修复登录错误'", workdir="/tmp/issue-1", background=true, pty=true)
terminal(command="blackbox --prompt '为认证添加单元测试'", workdir="/tmp/issue-2", background=true, pty=true)
# 监控所有
process(action="list")
多模型模式
Blackbox 的独特功能是通过多个模型运行同一任务并评判结果。通过 blackbox configure 配置要使用的模型 —— 选择多个提供者以启用 Chairman/评判器工作流，CLI 会评估不同模型的输出并选择最佳结果。
关键标志
| 标志 | 效果 |
|---|---|
--prompt "任务" | 非交互式一次性执行 |
--resume-checkpoint "标签" | 从保存的检查点恢复 |
--yolo | 自动批准所有操作和模型切换 |
blackbox session | 启动交互式聊天会话 |
blackbox configure | 更改设置、提供者、模型 |
blackbox info | 显示系统信息 |
视觉支持
Blackbox 自动检测输入中的图像，并可切换到多模态分析。VLM 模式：
"once"—— 仅当前查询切换模型"session"—— 整个会话切换"persist"—— 保持当前模型（不切换）
令牌限制
通过 .blackboxcli/settings.json 控制令牌使用：
{
"sessionTokenLimit": 32000
}规则
- 始终使用
pty=true—— Blackbox CLI 是交互式终端应用，没有 PTY 会挂起 - 使用
workdir—— 保持代理专注于正确的目录 - 长任务使用后台模式 —— 使用
background=true并通过process工具监控 - 不要干扰 —— 使用
poll/log监控，不要因为速度慢就终止会话 - 报告结果 —— 完成后检查更改并为用户总结
- 积分需要付费 —— Blackbox 使用基于积分的系统；多模型模式消耗积分更快
- 检查前提条件 —— 在尝试委托前确认
blackboxCLI 已安装