关于 hackthebox
用于 Hack The Box 竞赛与挑战的安全工作流技能,指导凭据、VPN、目录和 Agent 协调,并涵盖完成后的报告与通知。
主要功能
- 01竞赛凭据与平台登录
- 02机器 VPN 与连通性检查
- 03按挑战创建工作目录
- 04为目标协调子 Agent
- 05完成后的技能更新与 Slack 通知
适用场景
- 01准备 Hack The Box 机器挑战环境
- 02为多个目标安排协调 Agent
- 03按流程整理挑战结果并通知
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ transilienceai/ communitytools --skill hackthebox安装后在 Claude Code 中输入/hackthebox确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
reference/logging-spec.mdplatform-navigation.mdslack-notifications.mdvpn-pool-routing.mdvpn-setup.mdworkflow.md详细介绍
工作流
- workflow.md — 完整工作流及命令。每一步都要阅读此文件
步骤
- 获取凭据 —
python3 .claude/tools/env-reader.py HTB_USER HTB_PASS HTB_TOKEN ANTHROPIC_API_KEY SLACK_BOT_TOKEN HTB_SLACK_CHANNEL_ID - 仅当竞赛类型为“Machine”时 → 确认 VPN 正在运行;否则从平台下载 VPN 文件,并指导用户启用 VPN
- 生成输出目录 — 为每个挑战运行
mkdir -p YYMMDD_<name>/{recon,findings,logs,artifacts,tools,reports}。不要由编排器创建初始版attack-chain.md或experiments.md—— 这是协调子 Agent 的首要操作(见skills/coordination/reference/spawning-recipes.md)。 - 为完成用户指定的任务,尽可能使用 HTB_TOKEN;否则通过 playwright 登录平台,访问 https://account.hackthebox.com/login 并使用 HTB_USER 和 HTB_PASS 填写登录表单
- 如有必要,启动机器
- 如有必要,检查与机器的网络连接
- 为每个目标生成一个协调子 Agent — 根据
spawning-recipes.md,运行Agent(name="coordinator-{tag}", run_in_background=True, ...)。切勿在编排器会话中内联执行 P0-P6 协调器工作流 —— 记账规范(attack-chain.md、experiments.md、goal_attempts 计数,以及在第 5/15/25 次实验时必须安排的质疑者)要求设立子 Agent 边界。最多同时运行 N 个 Agent,采用基于队列的生成方式。 - 解题后阶段 3 — 父级编排器(而非协调器)在每个协调器返回 PHASE3_SUMMARY 后,始终运行
/skill-update并发送 Slack 通知(见 workflow.md 第 8 步)
参考资料
- workflow.md — 工作流概览,包括凭据、VPN、设置和生成协调器
- spawning-recipes.md — 协调器 Agent 生成提示词模板(漏洞利用、提交标志、完成报告、统计数据)
- completion-report-schema.md — 挑战完成报告结构和模板
- slack-notifications.md — Slack 完成通知格式和示例
- platform-navigation.md — 平台网站导航指南
- vpn-pool-routing.md — VPN 池隔离。在生成任何机器前进行预检(release_arena、dedivip_lab 或其他)
- vpn-setup.md — VPN 连接故障排除
- anti-bot-bypass.md — 绕过 Cloudflare/Turnstile 检测
评论
支持 Markdown