On this page

カスタムエージェント

独自のシステムプロンプト、モデル、権限を持つカスタムエージェントを作成します。エージェントはYAMLフロントマターを含むMarkdownファイルです。

📸 SCREENSHOT: custom-agent-config.png

カスタムエージェント設定ファイル

ファイルと配置場所

カスタムエージェントは、任意の .cyberstrike/ フォルダー（プロジェクトまたは ~/.cyberstrike/）内の agent/ または agents/ ディレクトリに置かれた *.md ファイルです。エージェントのIDはファイル名です。

.cyberstrike/
└── agents/
    ├── api-security.md
    └── compliance-audit.md

フロントマター

---
description: Specialized agent for REST and GraphQL API testing
mode: primary
model: anthropic/claude-sonnet-4-20250514
permission:
  bash: { "*": "ask", "rm -rf *": "deny" }
  edit: allow
---

You are an expert API security tester specializing in REST and GraphQL APIs.
Follow the OWASP API Security Top 10 …

本文（フロントマターの後）がシステムプロンプトになります。

フィールド	型	説明
`description`	string	エージェントの用途
`mode`	`primary` \| `subagent` \| `all`	`primary` エージェントは直接実行可能。`subagent` エージェントはタスクツール経由で委任される
`model`	string	`provider/model` のオーバーライド
`temperature`, `top_p`	number	サンプリング制御
`steps`	number	エージェントの最大反復回数
`color`	string	16進数またはテーマカラー
`permission`	object	ツールごとの権限（権限を参照）
`hidden`, `disable`	boolean	ピッカーから非表示 / 無効化

Caution

permission フィールドでツールを制限してください。旧 tools: マップは非推奨であり、allowedCommands フィールドはありません — コマンド制限は permission.bash のglobルール（例：bash: { "nmap *": "allow" }）です。

プライマリ vs サブエージェント

プライマリエージェントのみが --agent や default_agent で選択できます。エージェントを直接実行可能にしたい場合は mode: primary を設定してください。それ以外の場合は、cyberstrike エージェントが委任できるサブエージェントとして動作します。

---
description: Read-only auditor
mode: primary
permission:
  edit: deny
  bash: deny
  read: allow
  glob: allow
  grep: allow
---

You are a read-only security auditor …