mcpField
H
hackthebox

hackthebox

github.com/transilienceaiセキュリティ598198 回インストール13 週間前に更新
リポジトリ

hackthebox について

Hack The Boxのコンペティションやチャレンジ向けのセキュリティワークフローです。環境準備、プラットフォームへのアクセス、ターゲットごとのエージェント調整、完了後の報告と通知を案内します。

主な機能

  1. 01認証情報とプラットフォームへのログイン
  2. 02マシンのVPNと接続確認
  3. 03チャレンジごとの作業ディレクトリ作成
  4. 04ターゲットごとの調整エージェント起動
  5. 05完了後のスキル更新とSlack通知

活用シーン

  1. 01Hack The Boxのマシンチャレンジ環境の準備
  2. 02複数ターゲットにまたがるエージェントの調整
  3. 03チャレンジ結果の整理と完了通知

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/transilienceai/communitytools --skill hackthebox

インストール後、Claude Code で/hacktheboxを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

reference/
logging-spec.md
platform-navigation.md
slack-notifications.md
vpn-pool-routing.md
vpn-setup.md
workflow.md

詳細

ワークフロー

  • workflow.md — コマンドを含む完全なワークフローです。各ステップで参照してください。
手順
  1. 認証情報を取得します — python3 .claude/tools/env-reader.py HTB_USER HTB_PASS HTB_TOKEN ANTHROPIC_API_KEY SLACK_BOT_TOKEN HTB_SLACK_CHANNEL_ID
  2. 「Machine」タイプのコンペティションの場合のみ → VPN が稼働していることを確認します。稼働していない場合は、プラットフォームから VPN ファイルをダウンロードし、有効化する方法をユーザーに案内してください。
  3. 出力ディレクトリを生成します — チャレンジごとに mkdir -p YYMMDD_<name>/{recon,findings,logs,artifacts,tools,reports} を実行します。オーケストレーターから attack-chain.md や experiments.md を初期生成しないでください — これらはコーディネーターサブエージェントの最初のアクションです(skills/coordination/reference/spawning-recipes.md を参照)。
  4. ユーザーから与えられたタスクを達成するには、可能な場合は HTB_TOKEN を使用し、それ以外の場合は https://account.hackthebox.com/login で playwright を使用してプラットフォームにログインし、HTB_USER と HTB_PASS をログインフォームに入力します。
  5. 必要に応じて、マシンを起動します。
  6. 必要に応じて、マシンへのネットワーク接続を確認します。
  7. ターゲットごとにコーディネーターサブエージェントを起動します — 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 個とし、キューベースで起動します。
  8. 解決後のフェーズ 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 の検出回避

コメント