Hermes用のエージェント型ペンテストプロファイル:認可済み偵察、Web/アクセス制御攻撃、安全なエクスプロイト検証、およびガードゲート付きの証拠基盤型レポート作成のための31のプレイブック。
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/50022/55f1c11f1fa53cb32838b487d5b5b6f1745b609c7123ce0a2b28ff21108c765b.png" alt="Violin" width="256"/>
</p>
<h1 align="center">Violin ☤ — 監督型エージェント型Hermesペネトレーションテストプロファイル</h1>
<p align="center">
<a href="https://github.com/Strategic-Automation/violin"><img src="https://img.shields.io/badge/Status-Release%20Ready-2ea44f?style=for-the-badge" alt="Release Ready"></a>
<a href="https://github.com/Strategic-Automation/violin/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License: MIT"></a>
<a href="https://hermes-agent.nousresearch.com/"><img src="https://img.shields.io/badge/Hermes-%3E=0.21.5-FFD700?style=for-the-badge" alt="Hermes >=0.21.5"></a>
<a href="https://www.kali.org/"><img src="https://img.shields.io/badge/Kali%20Linux-557C94?style=for-the-badge&logo=kali-linux&logoColor=white" alt="Kali Linux"></a>
<a href="https://www.parrotsec.org/"><img src="https://img.shields.io/badge/Parrot%20OS-2E8B57?style=for-the-badge" alt="Parrot OS"></a>
<a href="https://strategic-automation.github.io/violin/"><img src="https://img.shields.io/badge/Site-Landing%20page-FF3B4A?style=for-the-badge" alt="Landing page"></a>
<a href="https://github.com/Strategic-Automation/violin/stargazers"><img src="https://img.shields.io/github/stars/Strategic-Automation/violin?style=for-the-badge&color=FFD166" alt="GitHub stars"></a>
</p>
<p align="center">
<b>35個のプレイブック · 19個のリファレンス · 14個のテンプレート · 必須の実行ガード · Hermesネイティブ</b>
</p>
Violinは、監督下で許可されたペネトレーションテスト向けの**Hermesネイティブなエージェント型ペネトレーションテストプロファイル**です。偵察から安全なエクスプロイト検証、そして報告までをカバーします。Hermesに組み込まれたツールセット、7つのルーティングされたスキル、そしてターゲット実行境界で必須となる`violin_guard`プラグインを使用します。スタンドアロンCLIはリリースチェック、診断、および管理上のリカバリをサポートし、ターゲットコマンドはプラグイン経由で実行されます。Violinはプロファイル固有の認証情報を追加せず、Hermesですでに設定されているプロバイダーおよびツールバックエンドを継承します。
<p align="center">
<a href="#quick-start">クイックスタート</a> ·
<a href="#engagement-lifecycle">ワークフロー</a> ·
<a href="#guard-tools">ガードツール</a> ·
<a href="#benchmarks">ベンチマーク</a> ·
<a href="https://strategic-automation.github.io/violin/">ランディングページ</a> ·
<a href="https://github.com/Strategic-Automation/violin/discussions">ディスカッション</a> ·
<a href="#development">開発</a>
</p>
<p align="center">
<strong>Violinをフォローしていますか?</strong>
<a href="https://github.com/Strategic-Automation/violin/stargazers">リポジトリにスターを付けて</a>
見つけやすくし、他のセキュリティエンジニアが監督型エージェント型ペネトレーションテストを発見できるようにご協力ください。
</p>
### コミュニティでの発見
Violinは、以下を含むコミュニティがキュレーションしたコレクションに掲載されています:
[awesome-ai-security](https://github.com/gmh5225/awesome-ai-security)、
[awesome-hermes-skills](https://github.com/ZeroPointRepo/awesome-hermes-skills)、
[awesome-hermes-agent](https://github.com/Anil-matcha/awesome-hermes-agent)、および
[awesome-infosec](https://github.com/onlurking/awesome-infosec)。
第三者による報道:
[Starlogの技術分析](https://starlog.is/articles/cybersecurity/strategic-automation-violin) および
[「Violin: Supervised Agentic Penetration Testing Profile for Hermes Agent」](https://hamradio.my/violin-supervised-agentic-pentest-profile-hermes/)。
独立した評価には、
[レビュアーキット](https://strategic-automation.github.io/violin/review.html)をご利用ください。これは
ベンチマークのパス、既知の制限、レビューのコンテキスト、および自律型ペネトレーションテストエージェント設計との事実に基づく比較をまとめたものです。
---
<table>
<tr><td width="240"><strong>保護されたターゲット実行</strong></td><td>スコープ、フェーズ、PTT、スキル、仮説、履歴、同期のチェックがターゲットコマンドの開始前に実行されます。</td></tr>
<tr><td><strong>永続的なエンゲージメント状態</strong></td><td>PTTタスク、仮説、コマンド履歴、チェックポイント、証拠、レポートはコンテキスト圧縮後も保持されます。</td></tr>
<tr><td><strong>証拠に基づく発見事項</strong></td><td>型付きの提出により、各検証済みの発見事項が認証済みの実行レシートに紐付けられます。</td></tr>
<tr><td><strong>ルーティングされた方法論</strong></td><td>ペネトレーションテストオーケストレーターが、Web、ID、API、ビジネスロジック、LLMセキュリティ、設定不備に特化したプレイブックを選択します。</td></tr>
<tr><td><strong>制限付き実行</strong></td><td>単一コマンド、コマンドバースト、バックグラウンドプロセス、バッチレビュー、ハートビートチェック、キャンセルが単一の状態モデルを共有します。</td></tr>
<tr><td><strong>検証可能なリリース</strong></td><td>プラグイン登録、スキーマ、スキルスナップショット、ドキュメント契約、lint、フォーマット、および完全なテストスイートがリリースゲートとして管理されます。</td></tr>
</table>
## クイックスタート
### プロファイルのインストール
```bash
hermes profile install https://github.com/Strategic-Automation/violin
hermes -p violin plugins disable violin_guard
hermes -p violin plugins enable violin_guard --no-allow-tool-override
hermes -p violin
```
Guard の依存関係は `plugins/violin_guard/plugin.yaml` で宣言されています。プラグイン名、ディレクトリ、および有効化設定はすべて `violin_guard` を使用しているため、Hermes はディレクトリの回避策なしで依存関係を解決できます。開発用の `.venv` に依存関係をインストールしても、それらは Hermes にはインストールされません。上記の無効化/有効化のサイクルにより、プロファイル設定で既にプラグインが有効になっている場合でも依存関係の承認が強制されます。インストール後に登録を確認してください:
```bash
hermes -p violin plugins doctor ~/.hermes/profiles/violin/plugins/violin_guard --ci
hermes -p violin tools list
```
Plugin Doctor は 12 個のツールと 5 個のフックを報告し、`violin_guard` が有効なツールセットとして表示されるはずです。エンゲージメントを開始する前に、インストール後に Hermes を再起動してください。古い `violin-guard` インストールを移行するには、プロファイルを再インストールしてください。
次に、許可されたターゲットを指定して開始し、ターゲットとのやり取りを行う前に Violin にスコープを収集させます:
```text
Run an authorized penetration test against example.com.
```
### 要件
- [Hermes Agent](https://hermes-agent.nousresearch.com/) 0.21.5 以降(コンテナは `v2026.9.24` リリースコミットを固定)
- ローカル開発用の Python 3.11 と `uv`
- 想定されるセキュリティツール環境として Kali Linux または Parrot OS
- 書面による許可と承認済みのスコープ
Violin はモデルやプロバイダーを選択しません。それらは Hermes で設定してください。有能なデフォルトとしては、ローカルで **Qwen3.8 27B** を、またはホスト型プロバイダー経由で **DeepSeek V4 Flash** を使用してください。
## エンゲージメントのライフサイクル
```mermaid
flowchart LR
S[Scope] --> R[Recon]
R --> V[Vulnerability research]
V --> E[Exploit validation]
E --> P[Reporting]
P --> X[Retrospective]
G[Violin Guard] -. validates .-> R
G -. validates .-> V
G -. validates .-> E
```
1. エンゲージメントを初期化し、`scope/scope.yaml` を承認します。
2. `violin_record_ptt` で1つのアクティブな PTT タスクと、それにルーティングされたスキルを選択します。
3. `violin_exec` または `violin_exec_burst` でターゲットコマンドを実行します。
4. 証拠によってステータスが変化するたびに仮説を更新します。
5. `violin_review_batch` で各バウンドされたコマンドバッチをレビューします。
6. 検証済みの所見を提出し、最終レポートを生成します。
7. 振り返りを完了します。
完全なフェーズモデルは次のとおりです:
```text
SCOPING → RECON → VULN_RESEARCH → EXPLOITATION
→ POST_EXPLOITATION / PRIVESC / FLAGS
→ REPORTING → RETROSPECTIVE
```
新しいフェーズで作業を開始するには、そのフェーズ配下に PTT タスクが必要です。既存のタスクはフェーズセクション間で移動されません。
## ガードツール
プラグインは、単一の型付きレジストリから 12 個の Hermes ツールを登録します:
| ツール | 目的 |
|---|---|
| `violin_record_ptt` | PTT タスクの作成、開始、更新、クローズ、またはキャンセル |
| `violin_record_hypothesis` | スコープ付き仮説の作成または更新 |
| `violin_submit_finding` | 署名済み実行レシートに紐付けられた検証済みの検出事項を送信 |
| `violin_exec` | ガード付きコマンドを 1 つ実行 |
| `violin_exec_burst` | 境界付きコマンドファイルを実行 |
| `violin_exec_status` | バックグラウンド実行のステータスを読み取り |
| `violin_exec_cancel` | 追跡中のバックグラウンド実行をキャンセル |
| `violin_review_batch` | 完了したバッチをレビューし状態を確定 |
| `violin_rebind_pending_batch` | 確認後に保留中のバッチを再バインド |
| `violin_heartbeat_done` | 完了したハートビートレビューをクリア |
| `violin_target` | 承認済みの評価対象を解決 |
| `violin_status` | 現在のタスク、スキル、ブロッカーを説明 |
`violin_exec` は汎用的な対象コマンド境界です。ツール固有の実行アダプターやバイナリ許可リストはありません。インストール済みの非対話型ツールは、エンゲージメントゲートを通過した後にのみ実行できます。
生のターミナルフックはベストエフォートのセーフティネットであり、ネットワーク封じ込めではありません。`terminal` はホストローカルの準備と管理にのみ使用してください。
## セーフティモデル
```mermaid
flowchart LR
A[Written authorization] --> B[Approved scope]
B --> C[Active phase task]
C --> D[Skill and hypothesis gates]
D --> E[Guarded execution]
E --> F[Evidence receipt]
F --> G[Batch review]
```
- スコープ承認とブートストラップ検証の前に、対象への操作は行わない。
- 対象コマンドのために生のシェルを実行しない。
- 明示的な書面による承認なしに、破壊的、妨害的、資格情報、永続化、ステルス、または第三者への操作を行わない。
- 生の証拠は `$ENG_DIR/evidence/<phase>/` の下に保持する。
- シークレット、ダンプ、およびプルーフ出力は `$ENG_DIR/state/` の外に保持する。
- コンテキスト圧縮は、現在の Hermes 会話内のエンゲージメントファイルから再開する。
詳細なポリシーは
[`skills/pentest/references/standards.md`](https://github.com/strategic-automation/violin/blob/master/skills/pentest/references/standards.md) に記載されています。
## エンゲージメント状態
`init-engagement` は標準的な作業構造を作成します:
```text
$ENG_DIR/
├── scope/
│ └── scope.yaml
├── state/
│ ├── ptt.md
│ ├── history.md
│ └── checkpoint.json
├── hypotheses.md
├── evidence/
├── reporting/
└── retrospective/
```
### Violin 3.3 からのアップグレード
Violin 4.0 はエグゼキュータの状態を `state/runtime.json` に保存し、3.3 の `sync.json`、`counts.json`、`heartbeat.json` ファイルは移行しません。新しいディレクトリで新しいエンゲージメントを開始してください。3.3 のディレクトリは履歴記録として保持してください。そのディレクトリを再利用するとレガシーな状態ファイルが残るため、Violin 4.0 はそれを拒否します。
### スキルの配信
スキルはオンデマンドで読み込まれます。ルーティングされたスキルに対する最初の `violin_record_ptt` 呼び出しは、PTT を変更せずに `skill_prepared` を返す場合があります。Hermes がスキルコンテンツを配信した後、レシートをバインドしてタスク変更を適用するためにトランジションを繰り返してください。`violin_status` は正確なリカバリアクションを報告します。
`.skill-loaded-*` のようなマーカーファイルは、スキルの配信を証明するものではありません。
## ルーティングされたスキル
| スキル | 対象範囲 |
|---|---|
| `pentest` | スコープ、ライフサイクル、偵察、エクスプロイト、レポーティング、クローズアウト |
| `web-app` | インジェクション、SSRF、トラバーサル、デシリアライゼーション、クライアント側の脆弱性 |
| `identity-auth` | 認証、認可、IDOR、JWT、CSRF、暗号 |
| `api-testing` | REST、SOAP、GraphQL、WebSocket |
| `business-logic` | ワークフロー、価格設定、クーポン、クォータ、リファラル、競合状態 |
| `llm-security` | プロンプトインジェクション、MCP、JSON-RPC |
| `misconfig` | デプロイ、エラーハンドリング、可観測性、秘匿性 |
オーケストレーターは、現在のタスクに必要なフェーズ資料とスペシャリストのプレイブックのみを読み込みます。
## 管理用 CLI
CLI はガード付きのターゲット実行を置き換えるものではありません。
```bash
python scripts/violin_guard.py --help
python scripts/violin_guard.py init-engagement engagements/example --host example.com
python scripts/violin_guard.py check-bootstrap --eng-dir engagements/example
python scripts/violin_guard.py status --eng-dir engagements/example
python scripts/violin_guard.py generate-closeout --eng-dir engagements/example
python scripts/violin_guard.py check-release
```
`check-command` は診断用のアドミッションチェックを公開し、指定されたコマンドを実行しません。
## アーキテクチャ
```text
plugins/violin_guard/
├── core/
│ ├── commands/ shell parsing, targets, HTTP proof
│ ├── engagement/ state, PTT, phases, hypotheses, bootstrap
│ ├── evidence/ findings, history, receipts, redaction
│ └── skills/ skill policy and receipts
├── gates/ command, scope, hypothesis, terminal policies
├── engine/ execution, runtime backend, code audit, release checks
├── handlers/ public Hermes tool handlers
├── hooks.py Hermes lifecycle hooks
└── registry.py registered tool definitions
skills/ orchestrator, routed skills, playbooks, references
benchmark/ runner, scorer, proof checks, calibration fixtures
scripts/ administrative CLI and platform smoke tests
tests/ runtime, integration, documentation, release tests
```
## ベンチマーク
このリポジトリには、Escape Duck Store の定義に加えて、既知の良好なスコアラーフィクスチャと既知の不良なスコアラーフィクスチャが含まれています。キャリブレーションは、スコアラーがそれらのフィクスチャを処理できることを証明しますが、ライブエージェントの再現率、ワークフローの完了、またはレポートの品質を確立するものではありません。
```bash
uv run python -m benchmark.score --calibrate known-good
uv run python -m benchmark.score --calibrate known-bad
uv run python -m benchmark.run \
--target http://localhost:<published-port> \
--provider <provider> \
--api-base <openai-compatible-base-url> \
--model <model-id> \
--target-isolation-id escape-duck-store-2026-04:<image-digest-or-reset-id>
```
スコアを公開する前に、[ベンチマーク手法](https://github.com/strategic-automation/violin/blob/master/docs/BENCHMARKS.md)をお読みください。
そこには、信頼できる結果を得るための証明、再現性、非公開評価、および開示に関する要件が定義されています。
## 開発
```bash
uv sync --dev
uv run pytest
uv run ruff check .
uv run ruff format --check .
uv run python scripts/violin_guard.py check-release
```
リリースゲートでは、バージョン表示、分離されたプラグインのインポート、登録済みツール、生成されたスキーマ、スキルスナップショット、ドキュメント契約、Ruff、およびテストスイート全体をチェックします。
プラットフォームのスモークテスト:
- `scripts/smoke-test.sh` — Linux および Kali/Parrot のリリーススモークテスト
- `scripts/smoke-test.ps1` — Windows のブートストラップ、スコープ、ターゲット解決のスモークテスト。スキル配信とターゲット実行には Hermes が必要
貢献ルールについては [CONTRIBUTING.md](https://github.com/strategic-automation/violin/blob/master/CONTRIBUTING.md) を、非公開での脆弱性報告については [SECURITY.md](https://github.com/strategic-automation/violin/blob/master/SECURITY.md) を参照してください。
## 責任ある使用
Violin は許可されたセキュリティ評価のためのものです。スコープ、承認、ターゲットの所有権、データの取り扱い、および現地の法律については、運用者が責任を負います。
## Violin を支援する
Violin は Strategic Automation Ltd. によって維持されているオープンソースプロジェクトです。
Violin があなたやあなたの組織にとって有用であるなら、
[継続的な開発をスポンサー](https://github.com/sponsors/Strategic-Automation)できます。
スポンサーシップは、継続的な開発、テスト、ドキュメント、互換性作業、およびリリースを支援します。
Violin は引き続き MIT ライセンスの下で利用可能です。スポンサーシップには、保証されたサポート、機能の優先順位、またはセキュリティポリシーへの影響力は含まれません。
## ライセンス
MIT — [LICENSE](https://github.com/strategic-automation/violin/blob/master/LICENSE) を参照してください。