EnterpriseAI/ClosedCode
1
0
Fork 0
Code Issues Pull Requests Actions 33 Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
Jun
2026-02-11 04:37:52 -06:00
committed by GitHub
parent b523998329
commit 567e094e6c
3 changed files with 359 additions and 374 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/web/src/content/docs/ko/commands.mdx
+62 -62
View File
@@ -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
사용자 지정 명령은 내장 명령을 무시할 수 있습니다.
커스텀 명령은 내장 명령을 덮어쓸 수 있습니다.
:::
같은 이름으로 사용자 정의 명령을 정의하면 내장 명령을 무시합니다.
같은 이름으로 커스텀 명령을 정의하면 내장 명령보다 커스텀 명령이 우선합니다.