docs(ko): polish Korean phrasing in acp, agents, config, and custom-tools docs (#13446)

packages/web/src/content/docs/ko/custom-tools.mdx

@@ -1,30 +1,30 @@
 ---
-title: 사용자 정의 도구
-description: OpenCode에서 LLM이 호출할 수 있는 도구를 만듭니다.
+title: Custom Tools
+description: Create tools the LLM can call in OpenCode.
 ---
 
-사용자 정의 도구는 LLM이 대화 중에 호출 할 수있는 기능을 만듭니다. 그들은 `read`, `write` 및 `bash`와 같은 opencode의 [붙박이 도구](./tools)와 함께 작동합니다.
+custom tool은 대화 중 LLM이 호출할 수 있도록 사용자가 직접 만든 함수입니다. `read`, `write`, `bash` 같은 OpenCode의 [built-in tools](/docs/tools)와 함께 동작합니다.
 
 ---
 
 ## 도구 만들기
 
-도구는 **TypeScript** 또는 **JavaScript** 파일로 정의됩니다. 그러나 도구 정의는 ** 어떤 언어로 작성된 스크립트를 호출 할 수 있습니다 ** - TypeScript 또는 JavaScript는 도구 정의 자체에서만 사용됩니다.
+tool은 **TypeScript** 또는 **JavaScript** 파일로 정의합니다. 다만 tool 정의에서 호출하는 스크립트는 **어떤 언어든** 사용할 수 있습니다. 즉, TypeScript/JavaScript는 tool 정의 자체에만 필요합니다.
 
 ---
 
-## 위치
+### 위치
 
-그들은 정의 할 수 있습니다:
+tool은 다음 위치에 둘 수 있습니다.
 
-- 프로젝트의 `.opencode/tools/` 디렉토리에 배치하여 로컬.
-- 또는 전 세계적으로 `~/.config/opencode/tools/`에 배치하여.
+- 프로젝트의 `.opencode/tools/` 디렉토리(로컬)
+- `~/.config/opencode/tools/` 디렉토리(전역)
 
 ---
 
-## 구조
+### 구조
 
-도구를 만드는 가장 쉬운 방법은 `tool()` helper를 사용하여 유형 안전 및 검증을 제공합니다.
+tool을 가장 쉽게 만드는 방법은 타입 안정성과 validation을 제공하는 `tool()` helper를 사용하는 것입니다.
 
 ```ts title=".opencode/tools/database.ts" {1}
 import { tool } from "@opencode-ai/plugin"
@@ -41,13 +41,13 @@ export default tool({
 })
 ```
 
-**파일 이름**는 **tool name**가 됩니다. 위는 `database` 공구를 만듭니다.
+**파일 이름**이 **tool 이름**이 됩니다. 위 예시는 `database` tool을 생성합니다.
 
 ---
 
-### 파일당 여러 도구
+#### 파일 하나에 여러 tool 정의
 
-단일 파일에서 여러 도구를 수출할 수 있습니다. 각 수출은 ** 별도의 도구 ** 이름 ** `<filename>_<exportname>`**:
+하나의 파일에서 여러 tool을 export할 수도 있습니다. 각 export는 **별도의 tool**이 되며 이름은 **`<filename>_<exportname>`** 형식을 사용합니다.
 
 ```ts title=".opencode/tools/math.ts"
 import { tool } from "@opencode-ai/plugin"
@@ -75,13 +75,13 @@ export const multiply = tool({
 })
 ```
 
-이것은 2개의 공구를 만듭니다: `math_add`와 `math_multiply`.
+이 경우 `math_add`, `math_multiply` 두 tool이 생성됩니다.
 
 ---
 
-#### 스키마
+### 인자
 
-`tool.schema`를 사용할 수 있습니다, 그냥 [Zod](https://zod.dev), 인수 유형을 정의합니다.
+인자 타입은 `tool.schema`로 정의할 수 있습니다. `tool.schema`는 [Zod](https://zod.dev) 기반입니다.
 
 ```ts "tool.schema"
 args: {
@@ -89,7 +89,7 @@ args: {
 }
 ```
 
-[Zod](https://zod.dev)를 직접 가져오고 일반 객체를 반환할 수 있습니다.
+[Zod](https://zod.dev)를 직접 import해서 일반 객체를 반환하는 방식도 사용할 수 있습니다.
 
 ```ts {6}
 import { z } from "zod"
@@ -108,9 +108,9 @@ export default {
 
 ---
 
-### 컨텍스트
+### Context
 
-도구는 현재 세션에 대한 컨텍스트를받습니다.
+tool은 현재 세션의 context 정보를 전달받습니다.
 
 ```ts title=".opencode/tools/project.ts" {8}
 import { tool } from "@opencode-ai/plugin"
@@ -126,18 +126,18 @@ export default tool({
 })
 ```
 
-세션 작업 디렉토리에 `context.directory`를 사용합니다.
-git worktree 루트에 `context.worktree`를 사용합니다.
+세션 작업 디렉토리는 `context.directory`를 사용하세요.
+git worktree 루트는 `context.worktree`를 사용하세요.
 
 ---
 
-## 예제
+## 예시
 
-### Python 도구 작성
+### Python으로 tool 작성
 
-원하는 모든 언어로 도구를 쓸 수 있습니다. 여기에 Python을 사용하여 두 개의 숫자를 추가하는 예입니다.
+tool은 원하는 언어로 작성할 수 있습니다. 아래는 Python으로 두 숫자를 더하는 예시입니다.
 
-먼저 Python 스크립트로 도구를 만듭니다.
+먼저 Python 스크립트로 tool을 만듭니다.
 
 ```python title=".opencode/tools/add.py"
 import sys
@@ -147,7 +147,7 @@ b = int(sys.argv[2])
 print(a + b)
 ```
 
-그런 다음 도구 정의를 만듭니다.
+그다음 이 스크립트를 호출하는 tool 정의를 만듭니다.
 
 ```ts title=".opencode/tools/python-add.ts" {10}
 import { tool } from "@opencode-ai/plugin"
@@ -167,4 +167,4 @@ export default tool({
 })
 ```
 
-여기에 우리는 [`Bun.$`](https://bun.com/docs/runtime/shell) 유틸리티를 사용하여 Python 스크립트를 실행합니다.
+여기서는 Python 스크립트를 실행하기 위해 [`Bun.$`](https://bun.com/docs/runtime/shell) 유틸리티를 사용합니다.