hackthebox について
Hack The Boxのコンペティションやチャレンジ向けのセキュリティワークフローです。環境準備、プラットフォームへのアクセス、ターゲットごとのエージェント調整、完了後の報告と通知を案内します。
主な機能
- 01認証情報とプラットフォームへのログイン
- 02マシンのVPNと接続確認
- 03チャレンジごとの作業ディレクトリ作成
- 04ターゲットごとの調整エージェント起動
- 05完了後のスキル更新とSlack通知
活用シーン
- 01Hack The Boxのマシンチャレンジ環境の準備
- 02複数ターゲットにまたがるエージェントの調整
- 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 ファイルをダウンロードし、有効化する方法をユーザーに案内してください。
- 出力ディレクトリを生成します — チャレンジごとに
mkdir -p YYMMDD_<name>/{recon,findings,logs,artifacts,tools,reports}を実行します。オーケストレーターからattack-chain.mdやexperiments.mdを初期生成しないでください — これらはコーディネーターサブエージェントの最初のアクションです(skills/coordination/reference/spawning-recipes.mdを参照)。 - ユーザーから与えられたタスクを達成するには、可能な場合は HTB_TOKEN を使用し、それ以外の場合は https://account.hackthebox.com/login で playwright を使用してプラットフォームにログインし、HTB_USER と HTB_PASS をログインフォームに入力します。
- 必要に応じて、マシンを起動します。
- 必要に応じて、マシンへのネットワーク接続を確認します。
- ターゲットごとにコーディネーターサブエージェントを起動します —
spawning-recipes.mdに従い、Agent(name="coordinator-{tag}", run_in_background=True, ...)を実行します。オーケストレーターのセッション内で P0-P6 のコーディネーターワークフローを実行しないでください — 記録の規律(attack-chain.md、experiments.md、goal_attempts のカウント、experiments 5/15/25 回目での必須の懐疑的検証)には、サブエージェントとの境界が必要です。同時実行するエージェントは最大 N 個とし、キューベースで起動します。 - 解決後のフェーズ 3 — 親オーケストレーター(コーディネーターではありません)は、各コーディネーターから PHASE3_SUMMARY が返るたびに、必ず
/skill-updateと Slack を実行します(workflow.md のステップ 8 を参照)。
参考資料
- workflow.md — 認証情報、VPN、セットアップ、コーディネーターの起動を含むワークフローの概要
- spawning-recipes.md — コーディネーターエージェントの起動プロンプトテンプレート(エクスプロイト、フラグ送信、完了レポート、統計)
- 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 対応