From 4c1d534093c8dd972f7fdbec2bb21293a079f248 Mon Sep 17 00:00:00 2001 From: YeonGyu-Kim Date: Fri, 5 Dec 2025 15:52:04 +0900 Subject: [PATCH] docs: simplify agent configuration, add OpenCode doc links --- README.ko.md | 89 ++++++-------------------------------------- README.md | 102 ++++++--------------------------------------------- 2 files changed, 24 insertions(+), 167 deletions(-) diff --git a/README.ko.md b/README.ko.md index f50b24f..d0de806 100644 --- a/README.ko.md +++ b/README.ko.md @@ -96,76 +96,9 @@ OpenCode 가 낭만이 사라진것같은 오늘날의 시대에, 당신에게 ### Agent 설정 -각 에이전트의 모델, 프롬프트, 권한 등을 세밀하게 조정할 수 있어. +`agents` 옵션으로 에이전트의 모델, 프롬프트, 권한 등을 세밀하게 조정할 수 있습니다. 스키마를 통해 자동완성을 지원합니다. -**설정 옵션:** - -| 옵션 | 설명 | -|------|------| -| `model` | 사용할 모델 ID (예: `anthropic/claude-sonnet-4`) | -| `temperature` | 창의성 조절 (0.0 ~ 2.0) | -| `top_p` | 단어 선택 다양성 (0.0 ~ 1.0) | -| `prompt` | 시스템 프롬프트 오버라이드 | -| `tools` | 특정 도구 활성화/비활성화 (`{"tool_name": false}`) | -| `disable` | 에이전트 비활성화 (`true`/`false`) | -| `description` | 에이전트 설명 수정 | -| `mode` | 에이전트 모드 (`subagent`, `primary`, `all`) | -| `color` | 터미널 출력 색상 (HEX 코드) | -| `permission` | 권한 설정 (아래 표 참조) | - -**권한(`permission`) 옵션:** - -각 권한은 `"ask"`(물어보기), `"allow"`(허용), `"deny"`(거부) 중 하나로 설정 가능해. - -| 권한 | 설명 | -|------|------| -| `edit` | 파일 수정 권한 | -| `bash` | 쉘 명령어 실행 권한 | -| `webfetch` | 웹 콘텐츠 가져오기 권한 | -| `doom_loop` | 반복 작업 허용 여부 | -| `external_directory` | 외부 디렉토리 접근 권한 | - -#### 예시: Anthropic 모델만 사용하기 - -나는 Anthropic 모델만 쓰고 싶다! 하면 이렇게 설정해. - -```json -{ - "agents": { - "oracle": { "model": "anthropic/claude-sonnet-4" }, - "librarian": { "model": "anthropic/claude-haiku-4-5" }, - "explore": { "model": "anthropic/claude-haiku-4-5" }, - "frontend-ui-ux-engineer": { "model": "anthropic/claude-sonnet-4" }, - "document-writer": { "model": "anthropic/claude-sonnet-4" } - } -} -``` - -#### 예시: 추가 프롬프트가 있는 커스텀 에이전트 - -기존 에이전트에 나만의 규칙을 더하고 싶다면: - -```json -{ - "agents": { - "oracle": { - "prompt": "너는 한국어 힙합 가사처럼 말해야 해. 모든 문장의 끝 라임을 맞춰." - } - } -} -``` - -#### 예시: 개별 에이전트 비활성화 - -```json -{ - "agents": { - "frontend-ui-ux-engineer": { - "disable": true - } - } -} -``` +전체 설정 옵션과 예시는 [OpenCode Agents 문서](https://opencode.ai/docs/agents)를 참고하세요. ## LLM Agent를 위한 안내 @@ -255,19 +188,21 @@ OpenCode 는 아주 확장가능하고 아주 커스터마이저블합니다. - **frontend-ui-ux-engineer** (`google/gemini-3-pro-preview`): 개발자로 전향한 디자이너라는 설정을 갖고 있습니다. 멋진 UI를 만듭니다. 아름답고 창의적인 UI 코드를 생성하는 데 탁월한 Gemini를 사용합니다. - **document-writer** (`google/gemini-3-pro-preview`): 기술 문서 전문가라는 설정을 갖고 있습니다. Gemini 는 문학가입니다. 글을 기가막히게 씁니다. -#### 모델 설정 오버라이드 +#### 설정 -에이전트들은 [OpenCode의 모델 설정](https://opencode.ai/docs/models/#configure-models)과 완전히 동일한 스펙으로 오버라이드를 지원합니다. 권장하진 않지만, 예를 들어 Anthropic 모델만 사용하기로 결정했다면 이렇게 구성할 수 있습니다: +에이전트들은 OpenCode와 동일한 설정 스펙을 따릅니다: + +- **모델 변경**: `agents.{name}.model`로 에이전트 모델 오버라이드. [OpenCode Models](https://opencode.ai/docs/models/#configure-models) 참고. +- **MCP 비활성화**: `disabled_mcps`로 내장 MCP 끄기. [OpenCode MCP Servers](https://opencode.ai/docs/mcp-servers) 참고. +- **에이전트 비활성화**: `disabled_agents` 또는 `agents.{name}.disable` 사용. [OpenCode Agents](https://opencode.ai/docs/agents) 참고. + +권장하진 않지만(이 플러그인은 멀티 모델 오케스트레이션용), Anthropic만 사용하는 경우 예시: ```json { "agents": { - "explore": { - "model": "anthropic/claude-haiku-4-5" - }, - "frontend-ui-ux-engineer": { - "model": "anthropic/claude-opus-4" - } + "explore": { "model": "anthropic/claude-haiku-4-5" }, + "frontend-ui-ux-engineer": { "model": "anthropic/claude-opus-4" } } } ``` diff --git a/README.md b/README.md index 9e78839..9c2e77d 100644 --- a/README.md +++ b/README.md @@ -146,89 +146,9 @@ Available agents: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, ` ### Agent Configuration -You can override the configuration of any built-in agent using the `agents` option. This allows you to change models, adjust creativity, modify permissions, or disable agents individually. +You can override any built-in agent's model, prompt, permissions, and more using the `agents` option. Configuration uses autocomplete via schema. -#### Configuration Options - -| Option | Type | Description | -|--------|------|-------------| -| `model` | string | Override the default model (e.g., "anthropic/claude-sonnet-4") | -| `temperature` | number (0-2) | Controls randomness (0 = deterministic, 2 = creative) | -| `top_p` | number (0-1) | Nucleus sampling parameter | -| `prompt` | string | Additional system prompt to append | -| `tools` | object | Enable/disable specific tools (e.g., `{"websearch_exa": false}`) | -| `disable` | boolean | Completely disable the agent | -| `description` | string | Override agent description | -| `mode` | "subagent" | "primary" | "all" | When agent is available | -| `color` | string | Hex color code for terminal output (e.g., "#FF0000") | -| `permission` | object | Permission settings for sensitive operations | - -#### Permission Options - -| Option | Values | Description | -|--------|--------|-------------| -| `edit` | "ask" | "allow" | "deny" | File modification permissions | -| `bash` | "ask" | "allow" | "deny" | object | Shell command execution permissions | -| `webfetch` | "ask" | "allow" | "deny" | Web access permissions | -| `doom_loop` | "ask" | "allow" | "deny" | Infinite loop prevention | -| `external_directory` | "ask" | "allow" | "deny" | Access outside project root | - -#### Examples - -**Using Only Anthropic Models** - -This configuration forces all agents to use Anthropic models, suitable for users with only Anthropic API access. - -```json -{ - "agents": { - "oracle": { - "model": "anthropic/claude-sonnet-4" - }, - "librarian": { - "model": "anthropic/claude-haiku-4-5" - }, - "explore": { - "model": "anthropic/claude-haiku-4-5" - }, - "frontend-ui-ux-engineer": { - "model": "anthropic/claude-sonnet-4" - }, - "document-writer": { - "model": "anthropic/claude-sonnet-4" - } - } -} -``` - -**Custom Agent with Additional Prompt** - -Inject custom instructions into an agent's system prompt. - -```json -{ - "agents": { - "frontend-ui-ux-engineer": { - "prompt": "ALWAYS use Tailwind CSS. NEVER use inline styles. Prefer dark mode defaults.", - "temperature": 0.8 - } - } -} -``` - -**Disable Agents Individually** - -You can also disable agents using the `disable` property within the agent config. - -```json -{ - "agents": { - "explore": { - "disable": true - } - } -} -``` +For full configuration options and examples, see the [OpenCode Agents documentation](https://opencode.ai/docs/agents). ## Why OpenCode & Why Oh My OpenCode @@ -265,19 +185,21 @@ I believe in the right tool for the job. For your wallet's sake, use CLIProxyAPI - **frontend-ui-ux-engineer** (`google/gemini-3-pro-preview`): A designer turned developer. Creates stunning UIs. Uses Gemini because its creativity and UI code generation are superior. - **document-writer** (`google/gemini-3-pro-preview`): A technical writing expert. Gemini is a wordsmith; it writes prose that flows naturally. -#### Model Configuration Override +#### Configuration -Agents follow the exact same model configuration spec as [OpenCode's model configuration](https://opencode.ai/docs/models/#configure-models). While not generally recommended, if you decide to use only Anthropic models, you could configure like this: +Agents follow the same configuration spec as OpenCode: + +- **Change models**: Override any agent's model via `agents.{name}.model`. See [OpenCode Models](https://opencode.ai/docs/models/#configure-models). +- **Disable MCPs**: Use `disabled_mcps` to turn off built-in MCPs. See [OpenCode MCP Servers](https://opencode.ai/docs/mcp-servers). +- **Disable agents**: Use `disabled_agents` or `agents.{name}.disable`. See [OpenCode Agents](https://opencode.ai/docs/agents). + +While not generally recommended (this plugin is designed for multi-model orchestration), here's an example for Anthropic-only users: ```json { "agents": { - "explore": { - "model": "anthropic/claude-haiku-4-5" - }, - "frontend-ui-ux-engineer": { - "model": "anthropic/claude-opus-4" - } + "explore": { "model": "anthropic/claude-haiku-4-5" }, + "frontend-ui-ux-engineer": { "model": "anthropic/claude-opus-4" } } } ```