LLM駆動のセキュリティテストエージェント。ターゲットに対して継続的なツール呼び出しループを実行し、160以上の偵察、Web、クラウド、AD、ポストエクスプロイト用ツールアダプターと永続化された実行レポートを備えています。
LLM駆動のセキュリティテストエージェント。段階的な偵察→悪用のパイプラインではなく、単一の連続したツール呼び出しループです。モデルが実際のターゲットに対して、ターンごとに次に何を実行するかを決定します。
免責事項: Tradecraft のツールは、適切に設定しないと恒久的な損害を与える可能性があります。所有しているターゲット、またはテストの明示的な許可を得ているターゲットに対してのみ使用してください。デフォルト設定に頼らず、最初のエンゲージメントの前に設定(
docs/tools.md、docs/policy.md、docs/profiles.md)を理解してください。
ツールとは、モデルが呼び出せるアクションのことです。各ツールは YAML 契約(何を行うか、どのような入力が必要か)と、実際のコマンドを実行してその出力を構造化データに解析するアダプターで構成されます。ツールの構築方法については docs/tools.md を、登録されているツールの完全なリスト(偵察、Web、クラウド、AD、Kubernetes、ポストエクスプロイトにわたる 160 以上のツール)については docs/tool-list.md を参照してください。
スキルとは、モデルにツール横断的なトレードクラフトの知識を与える助言的な markdown ノートです。あるツールを別のツールより優先すべき状況や、2 つのツールの出力がどのように連鎖するかなどを示します。これらは強制されるフェーズではなく、常に全体がレンダリングされます。詳細は docs/skills.md を参照してください。
すべてのエンゲージメント実行はディスクに永続化され、レポート(--report)に変換したり、後から Q&A コンソール(tradecraft chat)で調査したり、SFT/DPO ファインチューニングデータ(tradecraft dataset)としてエクスポートしたりできます。docs/report.md、docs/post-engagement.md、docs/finetune.md を参照してください。
config/tools/<id>.yaml model-facing contract (description, params, scope_param)
config/profiles/ curated tool sets per engagement shape (web, cloud, ad-network, ...)
tradecraft/domain.py pure shared types
tradecraft/adapters/<tool>/ execute.py (subprocess) + parse.py (pure parsing)
tradecraft/tools/ glues a YAML contract + adapter into one Tool.run()
tradecraft/memory/ append-only engagement log, facts, and evidence store
tradecraft/policy/ destructive-tool gate
tradecraft/skills/ advisory tradecraft markdown, rendered in full
tradecraft/execution/ the agentic loop + system-prompt assembly
tradecraft/reporting/ report generation + post-run investigation console
tradecraft/dataset/ offline SFT/DPO dataset extraction from persisted runs
tradecraft/cli.py entrypoint
依存関係の方向は一方向です: domain → adapters → tools → execution → cli。
python -m venv .venv && source .venv/bin/activate
pip install -e ".[test]"
cp .env.example .env # configure LLM_MODEL, LLM_BASE_URL, and LLM_API_KEY
LLM_MODEL には abliterated(安全性拒否を除去した)モデルを使用してください。標準的な安全性調整済みモデルは、このエージェントがエンゲージメント中に行う必要のある作業の大部分を拒否します。
各ツールに必要なバイナリ(各ツールの config/tools/<id>.yaml を参照)は PATH 上に存在している必要があります。バイナリが見つからない場合は、クラッシュではなくツールエラーとしてモデルに返されます。scripts/verify_container_tools.py は、登録済みツールのバイナリのうちどれが存在するかを確認します。すべてを自分でインストールせずに、動作確認済みの完全なツールセットを用意するには、Docker イメージのビルドと実行について docs/setup.md を参照してください。
tradecraft 10.0.0.5 --profile web
--profile はエンゲージメントの形態に合わせて厳選されたツールセットを選択します(web、ad-network、cloud、kubernetes、post-exploitation、または登録済みのすべてのツールを対象とする full)。--tools を指定すると、明示的なリストでこれを上書きします。破壊的ツールはデフォルトで無効になっています — 有効にするには --allow-destructive を渡してください。フラグの完全な一覧については tradecraft --help を実行するか、すべてのサブコマンド(chat、report、dataset、memory)を一覧で確認するには docs/cli.md を参照してください。
ネットワークルーティング/イグレス(VPN、SOCKS/TUN ゲートウェイ、またはコンテナの network_mode)はアダプター内部ではなく環境レイヤーで処理されます。HTTP_PROXY/HTTPS_PROXY を設定する場合は、LLM_BASE_URL のホストを NO_PROXY に追加してください。
pytest
docs/cli.md — すべての tradecraft サブコマンドとフラグを一覧で確認できます。docs/setup.md — Docker イメージのビルド/実行、ログの取得、実行データの抽出。docs/tools.md — ツール、アダプター。docs/tool-list.md — 登録されているすべてのツールを一覧で確認できます。docs/policy.md — 破壊的ツールのゲーティング、影響範囲のカテゴリ、アカウントロックアウトの予算。docs/skills.md — スキルとは何か、いつ・どのように追加するか。docs/profiles.md — エンゲージメント形態のプロファイル、重複、追加方法。docs/report.md — 実行からレポートを生成する方法。docs/post-engagement.md — 実行後の Q&A コンソール。docs/finetune.md — エンゲージメント実行を SFT/DPO ファインチューニングデータに変換する方法。CONTRIBUTING.md — 新しいツールを追加する方法。