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` 에이전트는 task 도구를 통해 위임됨
`model`	string	`provider/model` 재정의
`temperature`, `top_p`	number	샘플링 제어
`steps`	number	최대 에이전트 반복 횟수
`color`	string	Hex 또는 테마 색상
`permission`	object	도구별 권한 (권한 참조)
`hidden`, `disable`	boolean	피커에서 숨기기 / 비활성화

Caution

permission 필드로 도구를 제한하세요. 이전의 tools: 맵은 지원 중단되었으며, allowedCommands 필드는 없습니다 — 명령 제한은 permission.bash 글로브 규칙(예: bash: { "nmap *": "allow" })입니다.

Primary vs Subagent

primary 에이전트만 --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 …