docs(ko): improve translations for intro, cli, and commands (#13094)

1 files changed, 62 insertions, 62 deletions

diff --git a/packages/web/src/content/docs/ko/commands.mdx b/packages/web/src/content/docs/ko/commands.mdx
index 4001872d4..38ff73896 100644
--- a/packages/web/src/content/docs/ko/commands.mdx
+++ b/packages/web/src/content/docs/ko/commands.mdx
@@ -3,21 +3,23 @@ title: Commands
 description: Create custom commands for repetitive tasks.
 ---
 
-사용자 지정 명령은 TUI에서 실행될 때 실행할 때 실행해야 합니다.
+커스텀 명령을 사용하면 TUI에서 해당 명령이 실행될 때 사용할 프롬프트를 미리 정의할 수 있습니다.
 
 ```bash frame="none"
 /my-command
 ```
 
-사용자 정의 명령은 `/init`, `/undo`, `/redo`, `/share`, `/share`, `/help`와 같은 내장된 명령 이외에 있습니다. [더 알아보기](/docs/tui#commands).
+---
+
+커스텀 명령은 `/init`, `/undo`, `/redo`, `/share`, `/help` 같은 내장 명령과 별도로 추가됩니다. [더 알아보기](/docs/tui#commands).
 
 ---
 
-## 명령 파일 생성
+## 명령 파일 만들기
 
-사용자 지정 명령을 정의하려면 `commands/` 디렉토리의 Markdown 파일을 만듭니다.
+커스텀 명령은 `commands/` 디렉터리에 Markdown 파일을 만들어 정의합니다.
 
-`.opencode/commands/test.md` 만들기:
+예: `.opencode/commands/test.md`
 
 ```md title=".opencode/commands/test.md"
 ---
@@ -30,9 +32,9 @@ Run the full test suite with coverage report and show any failures.
 Focus on the failing tests and suggest fixes.
 ```
 
-frontmatter 명령 속성을 정의합니다. 콘텐츠는 템플릿이 됩니다.
+프런트매터(frontmatter)에는 명령 속성을 정의하고, 본문은 템플릿 프롬프트가 됩니다.
 
-명령명에 따라 `/`를 입력하여 명령을 사용하십시오.
+명령 이름 앞에 `/`를 붙여 실행합니다.
 
 ```bash frame="none"
 "/test"
@@ -42,13 +44,13 @@ frontmatter 명령 속성을 정의합니다. 콘텐츠는 템플릿이 됩니�
 
 ## 구성
 
-opencode config를 통해 사용자 지정 명령을 추가하거나 `commands/` 디렉토리에 있는 Markdown 파일을 만들 수 있습니다.
+커스텀 명령은 OpenCode 설정으로 추가하거나, `commands/` 디렉터리에 Markdown 파일을 만들어 추가할 수 있습니다.
 
 ---
 
-### JSON 태그
+### JSON
 
-opencode [config](/docs/config)에서 `command` 옵션을 사용하십시오:
+OpenCode [config](/docs/config)의 `command` 옵션을 사용합니다.
 
 ```json title="opencode.jsonc" {4-12}
 {
@@ -67,7 +69,7 @@ opencode [config](/docs/config)에서 `command` 옵션을 사용하십시오:
 }
 ```
 
-이제 TUI에서이 명령을 실행할 수 있습니다.
+이제 TUI에서 다음처럼 실행할 수 있습니다.
 
 ```bash frame="none"
 /test
@@ -77,10 +79,10 @@ opencode [config](/docs/config)에서 `command` 옵션을 사용하십시오:
 
 ### Markdown
 
-Markdown 파일을 사용하여 명령을 정의할 수 있습니다. 그들에 게:
+Markdown 파일로도 명령을 정의할 수 있습니다. 아래 경로 중 하나에 두면 됩니다.
 
-- 글로벌: `~/.config/opencode/commands/`
-- 프로젝트: `.opencode/commands/`
+- 전역: `~/.config/opencode/commands/`
+- 프로젝트별: `.opencode/commands/`
 
 ```markdown title="~/.config/opencode/commands/test.md"
 ---
@@ -93,8 +95,7 @@ Run the full test suite with coverage report and show any failures.
 Focus on the failing tests and suggest fixes.
 ```
 
-markdown 파일 이름은 명령 이름입니다. 예를 들어, `test.md` lets
-당신은 실행:
+Markdown 파일명이 명령 이름이 됩니다. 예를 들어 `test.md`라면 아래처럼 실행합니다.
 
 ```bash frame="none"
 /test
@@ -102,15 +103,15 @@ markdown 파일 이름은 명령 이름입니다. 예를 들어, `test.md` lets
 
 ---
 
-## Prompt 구성
+## 프롬프트 구성
 
-사용자 정의 명령에 대한 프롬프트는 몇 가지 특별한 placeholders 및 구문을 지원합니다.
+커스텀 명령 프롬프트는 몇 가지 특수 플레이스홀더(placeholder)와 문법을 지원합니다.
 
 ---
 
-#### 가격
+### 인수(Arguments)
 
-`$ARGUMENTS` placeholder를 사용하여 명령을 전달합니다.
+`$ARGUMENTS` 플레이스홀더로 명령 인수를 전달할 수 있습니다.
 
 ```md title=".opencode/commands/component.md"
 ---
@@ -121,22 +122,22 @@ Create a new React component named $ARGUMENTS with TypeScript support.
 Include proper typing and basic structure.
 ```
 
-인수로 명령을 실행:
+인수를 넣어 실행하면:
 
 ```bash frame="none"
 /component Button
 ```
 
-그리고 `$ARGUMENTS`는 `Button`로 대체될 것입니다.
+`$ARGUMENTS`가 `Button`으로 치환됩니다.
 
-위치 매개 변수를 사용하여 개별 인수에 액세스 할 수 있습니다.
+위치 인수도 사용할 수 있습니다.
 
 - `$1` - 첫 번째 인수
 - `$2` - 두 번째 인수
 - `$3` - 세 번째 인수
-- 그래서 ...
+- 이후 동일
 
-예를 들면:
+예시:
 
 ```md title=".opencode/commands/create-file.md"
 ---
@@ -147,25 +148,25 @@ Create a file named $1 in the directory $2
 with the following content: $3
 ```
 
-명령을 실행:
+실행:
 
 ```bash frame="none"
 /create-file config.json src "{ \"key\": \"value\" }"
 ```
 
-이렇게 대체됩니다:
+치환 결과:
 
-- `$1`는 `config.json`
-- `$2`는 `src`
-- `$3`는 `{ "key": "value" }`
+- `$1` -> `config.json`
+- `$2` -> `src`
+- `$3` -> `{ "key": "value" }`
 
 ---
 
-### 포탄 산출
+### 셸 출력
 
-사용 !`command` 는 [bash command](/docs/tui#bash-commands)를 프롬프트로 출력합니다.
+_!`command`_ 문법으로 [bash 명령](/docs/tui#bash-commands)의 출력 결과를 프롬프트에 주입할 수 있습니다.
 
-예를 들어, 테스트 범위를 분석하는 사용자 정의 명령을 만들려면:
+예를 들어 테스트 커버리지 분석 명령을 만들면:
 
 ```md title=".opencode/commands/analyze-coverage.md"
 ---
@@ -178,7 +179,7 @@ Here are the current test results:
 Based on these results, suggest improvements to increase coverage.
 ```
 
-또는 최근 변경 사항 :
+최근 변경 리뷰용으로는:
 
 ```md title=".opencode/commands/review-changes.md"
 ---
@@ -191,13 +192,13 @@ Recent git commits:
 Review these changes and suggest any improvements.
 ```
 
-명령은 프로젝트의 루트 디렉토리에서 실행하고 출력은 프롬프트의 일부가됩니다.
+명령은 프로젝트 루트 디렉터리에서 실행되며, 출력 결과는 프롬프트 본문에 포함됩니다.
 
 ---
 
-## 파일 참조
+### 파일 참조
 
-파일명에 따라 `@`를 사용하여 명령에 파일이 포함되어 있습니다.
+`@` 뒤에 파일명을 붙여 명령에 파일을 포함할 수 있습니다.
 
 ```md title=".opencode/commands/review-component.md"
 ---
@@ -208,19 +209,19 @@ Review the component in @src/components/Button.tsx.
 Check for performance issues and suggest improvements.
 ```
 
-파일 콘텐츠는 자동으로 프롬프트에 포함되어 있습니다.
+파일 내용은 자동으로 프롬프트에 포함됩니다.
 
 ---
 
 ## 옵션
 
-구성 옵션을 자세히 살펴봅시다.
+구성 옵션을 자세히 살펴봅니다.
 
 ---
 
-### 템플릿
+### Template
 
-`template` 옵션은 명령이 실행될 때 LLM에 전송될 프롬프트를 정의합니다.
+`template` 옵션은 명령 실행 시 LLM에 전달할 프롬프트를 정의합니다.
 
 ```json title="opencode.json"
 {
@@ -232,13 +233,13 @@ Check for performance issues and suggest improvements.
 }
 ```
 
-\*\* config 옵션이 필요합니다.
+이 옵션은 **필수**입니다.
 
 ---
 
-### 묘사
+### Description
 
-`description` 옵션을 사용하여 명령의 간단한 설명을 제공합니다.
+`description` 옵션으로 명령의 짧은 설명을 추가할 수 있습니다.
 
 ```json title="opencode.json"
 {
@@ -250,15 +251,15 @@ Check for performance issues and suggest improvements.
 }
 ```
 
-명령에 입력할 때 TUI의 설명으로 표시됩니다.
+이 설명은 TUI에서 명령을 입력할 때 표시됩니다.
 
 ---
 
-## 에이전트
+### Agent
 
-`agent` config를 선택적으로 지정합니다. [agent](/docs/agents)는 이 명령을 실행해야 합니다.
-이 경우 [subagent](/docs/agents/#subagents) 명령은 기본으로 시약을 트리거합니다.
-이 행동을 비활성화하려면 `subtask`를 `false`로 설정하십시오.
+`agent` 설정으로 이 명령을 실행할 [agent](/docs/agents)를 지정할 수 있습니다.
+지정한 값이 [subagent](/docs/agents/#subagents)면 기본적으로 subagent 호출이 실행됩니다.
+이 동작을 끄려면 `subtask`를 `false`로 설정하세요.
 
 ```json title="opencode.json"
 {
@@ -270,15 +271,14 @@ Check for performance issues and suggest improvements.
 }
 ```
 
-** 옵션** 설정 옵션입니다. 지정된 경우, 현재 에이전트에 기본값.
+이 옵션은 **선택**입니다. 지정하지 않으면 현재 에이전트가 기본값으로 사용됩니다.
 
 ---
 
-### 서브스크랩
+### Subtask
 
-`subtask` boolean을 사용하여 명령을 강제로 [subagent](/docs/agents/#subagents) 호출합니다.
-이것은 당신이 명령을 원하지 않는 경우 유용합니다 당신의 기본 컨텍스트를 pollute하고 \*\* 에이전트는 시약으로 행동하는,
-`mode`가 [시약](/docs/시약) 구성에 `primary`로 설정되는 경우에도.
+`subtask` 불리언(boolean)을 사용하면 명령이 [subagent](/docs/agents/#subagents) 호출을 강제로 트리거합니다.
+주 컨텍스트를 오염시키고 싶지 않을 때 유용하며, [agent](/docs/agents) 설정의 `mode`가 `primary`여도 subagent로 실행합니다.
 
 ```json title="opencode.json"
 {
@@ -290,13 +290,13 @@ Check for performance issues and suggest improvements.
 }
 ```
 
-** 옵션** 설정 옵션입니다.
+이 옵션은 **선택**입니다.
 
 ---
 
-### 모형
+### Model
 
-`model` config를 사용하여 이 명령의 기본 모델을 무시합니다.
+`model` 설정으로 이 명령의 기본 모델을 오버라이드할 수 있습니다.
 
 ```json title="opencode.json"
 {
@@ -308,16 +308,16 @@ Check for performance issues and suggest improvements.
 }
 ```
 
-** 옵션** 설정 옵션입니다.
+이 옵션은 **선택**입니다.
 
 ---
 
-## 내장
+## Built-in
 
-opencode는 `/init`, `/undo`, `/redo`, `/share`, `/help`, `/help`와 같은 몇몇 붙박이 명령을 포함합니다; [learn more](./tui#commands).
+OpenCode는 `/init`, `/undo`, `/redo`, `/share`, `/help` 등 여러 내장 명령을 제공합니다. [더 알아보기](/docs/tui#commands).
 
 :::note
-사용자 지정 명령은 내장 명령을 무시할 수 있습니다.
+커스텀 명령은 내장 명령을 덮어쓸 수 있습니다.
 :::
 
-같은 이름으로 사용자 정의 명령을 정의하면 내장 명령을 무시합니다.
+같은 이름으로 커스텀 명령을 정의하면 내장 명령보다 커스텀 명령이 우선합니다.