@neurocode-ai/web 1.18.8

package/src/content/docs/ko/server.mdx

@@ -0,0 +1,287 @@
+---
+title: 서버
+description: HTTP를 통해 OpenCode 서버와 상호 작용합니다.
+---
+
+import config from "../../../../config.mjs"
+export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts`
+
+`opencode serve` 명령은 opencode 클라이언트가 사용할 수 있는 OpenAPI 엔드포인트를 노출하는 headless HTTP 서버를 실행합니다.
+
+---
+
+### 사용법
+
+```bash
+opencode serve [--port <number>] [--hostname <string>] [--cors <origin>]
+```
+
+#### 옵션
+
+| 플래그          | 설명                                  | 기본값           |
+| --------------- | ------------------------------------- | ---------------- |
+| `--port`        | 수신 대기할 포트                      | `4096`           |
+| `--hostname`    | 수신 대기할 호스트명                  | `127.0.0.1`      |
+| `--mdns`        | mDNS 탐지 활성화                      | `false`          |
+| `--mdns-domain` | mDNS 서비스의 사용자 지정 도메인 이름 | `opencode.local` |
+| `--cors`        | 허용할 추가 브라우저 origin           | `[]`             |
+
+`--cors`는 다수 시간을 통과될 수 있습니다:
+
+```bash
+opencode serve --cors http://localhost:5173 --cors https://app.example.com
+```
+
+---
+
+### 인증
+
+`OPENCODE_SERVER_PASSWORD`를 설정하여 서버를 HTTP Basic auth로 보호합니다. `opencode` 또는 `OPENCODE_SERVER_USERNAME`를 오버라이드로 설정하는 사용자의 기본값. 이것은 `opencode serve`와 `opencode web` 둘 다에 적용합니다.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve
+```
+
+---
+
+### 작동 방식
+
+`opencode`를 실행하면 TUI와 서버를 시작합니다. TUI는 어디에 있습니까?
+서버와 대화하는 클라이언트. 서버는 OpenAPI 3.1 spec을 노출
+끝점. 이 엔드포인트는 [SDK](/docs/sdk)을 생성하는 데도 사용됩니다.
+
+:::tip
+opencode 서버를 사용하여 opencode programmatically와 상호 작용합니다.
+:::
+
+이 아키텍처는 opencode 지원 여러 클라이언트를 허용하고 opencode programmatically와 상호 작용 할 수 있습니다.
+
+독립 서버를 시작하려면 `opencode serve`를 실행할 수 있습니다. 당신이 있는 경우에
+opencode TUI 실행, `opencode serve` 새로운 서버를 시작합니다.
+
+---
+
+#### 기존 서버에 연결
+
+TUI를 시작하면 무작위로 포트와 호스트 이름을 할당합니다. 대신 `--hostname`와 `--port` [flags](/docs/cli)에서 전달할 수 있습니다. 그런 다음 서버에 연결하십시오.
+
+[`/tui`](#tui) 엔드포인트는 서버를 통해 TUI를 구동하는 데 사용될 수 있습니다. 예를 들어 미리 작성하거나 프롬프트를 실행할 수 있습니다. 이 설정은 opencode [IDE](/docs/ide) 플러그인에 의해 사용됩니다.
+
+---
+
+## 사양
+
+서버는 OpenAPI 3.1 spec을 게시합니다.
+
+```
+http://<hostname>:<port>/doc
+```
+
+예를 들어, `http://localhost:4096/doc`. 클라이언트를 생성하거나 요청 및 응답 유형을 검사하는 spec를 사용하십시오. 또는 Swagger 탐험가에서 볼 수 있습니다.
+
+---
+
+## API
+
+opencode 서버는 다음과 같은 API를 노출합니다.
+
+---
+
+## 글로벌
+
+| 방법  | 경로             | 설명                      | 응답                                 |
+| ----- | ---------------- | ------------------------- | ------------------------------------ |
+| `GET` | `/global/health` | 서버 건강 및 버전         | `{ healthy: true, version: string }` |
+| `GET` | `/global/event`  | 글로벌 이벤트(SSE 스트림) | 이벤트 스트림                        |
+
+---
+
+## 프로젝트
+
+| 방법  | 경로               | 설명                    | 응답                                          |
+| ----- | ------------------ | ----------------------- | --------------------------------------------- |
+| `GET` | `/project`         | 모든 프로젝트 보기      | <a href={typesUrl}><code>Project[]</code></a> |
+| `GET` | `/project/current` | 현재 프로젝트 가져 오기 | <a href={typesUrl}><code>프로젝트</code></a>  |
+
+---
+
+### 경로 & VCS
+
+| 방법  | 경로    | 설명                          | 응답                                        |
+| ----- | ------- | ----------------------------- | ------------------------------------------- |
+| `GET` | `/path` | 현재 경로 받기                | <a href={typesUrl}><code>Path</code></a>    |
+| `GET` | `/vcs`  | 현재 프로젝트의 VCS 정보 받기 | <a href={typesUrl}><code>VcsInfo</code></a> |
+
+---
+
+### 인스턴스
+
+| 방법   | 경로                | 설명                 | 응답      |
+| ------ | ------------------- | -------------------- | --------- |
+| `POST` | `/instance/dispose` | 현재 인스턴스를 해제 | `boolean` |
+
+---
+
+### 구성
+
+| 방법    | 경로                | 설명                       | 응답                                                                                     |
+| ------- | ------------------- | -------------------------- | ---------------------------------------------------------------------------------------- |
+| `GET`   | `/config`           | 구성정보                   | <a href={typesUrl}><code>Config</code></a>                                               |
+| `PATCH` | `/config`           | 업데이트 구성              | <a href={typesUrl}><code>Config</code></a>                                               |
+| `GET`   | `/config/providers` | 목록 제공업체 및 기본 모델 | `{ providers: `<a href={typesUrl}> 사이트 맵</a>`, default: { [key: string]: string } }` |
+
+---
+
+## 공급자
+
+| 방법   | 경로                             | 설명                        | 응답                                                                                |
+| ------ | -------------------------------- | --------------------------- | ----------------------------------------------------------------------------------- |
+| `GET`  | `/provider`                      | 모든 공급자 목록            | `{ all: `<a href={typesUrl}>Provider[]</a>`, default: {...}, connected: string[] }` |
+| `GET`  | `/provider/auth`                 | 공급자 인증 메서드 가져오기 | `{ [providerID: string]: `<a href={typesUrl}>ProviderAuthMethod[]</a>` }`           |
+| `POST` | `/provider/{id}/oauth/authorize` | OAuth를 사용한 공급자 허가  | <a href={typesUrl}><code>ProviderAuthAuthorization</code></a>                       |
+| `POST` | `/provider/{id}/oauth/callback`  | 공급자를 위한 OAuth 콜백    | `boolean`                                                                           |
+
+---
+
+## 세션
+
+| 메서드   | 경로                                     | 설명                               | 비고                                                                          |
+| -------- | ---------------------------------------- | ---------------------------------- | ----------------------------------------------------------------------------- |
+| `GET`    | `/session`                               | 모든 세션 일람표                   | 반환 <a href={typesUrl}><code>Session[]</code></a>                            |
+| `POST`   | `/session`                               | 새 세션 만들기                     | 몸: `{ parentID?, title? }`, 반환 <a href={typesUrl}><code>Session</code></a> |
+| `GET`    | `/session/status`                        | 모든 세션의 세션 상태를 가져옵니다 | `{ [sessionID: string]: `<a href={typesUrl}>SessionStatus</a>` }`             |
+| `GET`    | `/session/:id`                           | 세션 상세보기                      | 반품 <a href={typesUrl}><code>Session</code></a>                              |
+| `DELETE` | `/session/:id`                           | 세션 삭제 및 모든 데이터           | `boolean`                                                                     |
+| `PATCH`  | `/session/:id`                           | 업데이트 세션 속성                 | 본체: `{ title? }`, 반환 <a href={typesUrl}><code>Session</code></a>          |
+| `GET`    | `/session/:id/children`                  | 세션의 하위 세션                   | 리턴 <a href={typesUrl}><code>Session[]</code></a>                            |
+| `GET`    | `/session/:id/todo`                      | 세션의 할 일(Todo) 목록 받기       | <a href={typesUrl}><code>Todo[]</code></a>                                    |
+| `POST`   | `/session/:id/init`                      | 앱 초기화 및 `AGENTS.md` 분석      | 몸: `{ messageID, providerID, modelID }`, 반환 `boolean`                      |
+| `POST`   | `/session/:id/fork`                      | 메시지의 기존 세션                 | 몸: `{ messageID? }`, 반환 <a href={typesUrl}><code>Session</code></a>        |
+| `POST`   | `/session/:id/abort`                     | 운영 중인 세션                     | 반품 `boolean`                                                                |
+| `POST`   | `/session/:id/share`                     | 세션 공유                          | <a href={typesUrl}><code>Session</code></a>                                   |
+| `DELETE` | `/session/:id/share`                     | 세션 공유                          | <a href={typesUrl}><code>Session</code></a>                                   |
+| `GET`    | `/session/:id/diff`                      | `/session/:id/diff`                | `messageID?`, 반환 <a href={typesUrl}><code>FileDiff[]</code></a>             |
+| `POST`   | `/session/:id/summarize`                 | 세션을 요약                        | 본체: `{ providerID, modelID }`, `boolean` 반환                               |
+| `POST`   | `/session/:id/revert`                    | 메시지 재생                        | 몸: `{ messageID, partID? }`, 반환 `boolean`                                  |
+| `POST`   | `/session/:id/unrevert`                  | 메시지 되돌리기 취소               | 반품 `boolean`                                                                |
+| `POST`   | `/session/:id/permissions/:permissionID` | 허가 요청 대응                     | 본체: `{ response, remember? }`, `boolean`                                    |
+
+---
+
+## 메시지
+
+| 방법   | 경로                              | 설명                                   | 주                                                                                                                                                               |
+| ------ | --------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `GET`  | `/session/:id/message`            | 세션의 목록 메시지                     | 쿼리: `limit?`, `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}[]`                                                            |
+| `POST` | `/session/:id/message`            | 응답을 위해 메시지를 보내고 기다립니다 | 몸: `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`, 반환 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}` |
+| `GET`  | `/session/:id/message/:messageID` | 메시지 보내기                          | `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                                                              |
+| `POST` | `/session/:id/prompt_async`       | 비동기적으로 메시지 보내기             | 몸: `/session/:id/message`와 동일, `204 No Content`를 반환                                                                                                       |
+| `POST` | `/session/:id/command`            | 슬래시 명령어 실행                     | 본체: `{ messageID?, agent?, model?, command, arguments }`, 반환 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`             |
+| `POST` | `/session/:id/shell`              | shell 명령 실행                        | 체: `{ agent, model?, command }`, 반환 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                       |
+
+---
+
+## 명령
+
+| 방법  | 경로       | 설명      | 응답                                          |
+| ----- | ---------- | --------- | --------------------------------------------- |
+| `GET` | `/command` | 모든 명령 | <a href={typesUrl}><code>Command[]</code></a> |
+
+---
+
+## 파일
+
+| 방법  | 경로                     | 설명                         | 응답                                                                                    |
+| ----- | ------------------------ | ---------------------------- | --------------------------------------------------------------------------------------- |
+| `GET` | `/find?pattern=<pat>`    | 파일에서 텍스트 검색         | `path`, `lines`, `line_number`, `absolute_offset`, `submatches`가 포함된 일치 객체 배열 |
+| `GET` | `/find/file?query=<q>`   | 이름으로 파일/디렉터리 찾기  | `string[]` (경로)                                                                       |
+| `GET` | `/find/symbol?query=<q>` | 워크스페이스 심볼 찾기       | <a href={typesUrl}><code>Symbol[]</code></a>                                            |
+| `GET` | `/file?path=<path>`      | 파일 및 디렉터리 목록        | <a href={typesUrl}><code>FileNode[]</code></a>                                          |
+| `GET` | `/file/content?path=<p>` | 파일 읽기                    | <a href={typesUrl}><code>FileContent</code></a>                                         |
+| `GET` | `/file/status`           | 추적 중인 파일 상태 가져오기 | <a href={typesUrl}><code>File[]</code></a>                                              |
+
+#### `/find/file` 쿼리 매개 변수
+
+- `query` (required) - 검색 문자열 (fuzzy 일치)
+- `type` (선택 사항) - `"file"` 또는 `"directory"`에 제한 결과
+- `directory` (선택 사항) - 검색에 대한 프로젝트 루트를 무시
+- (선택) `limit` - 최대 결과 (1-200)
+- `dirs` (옵션) - 레거시 플래그 (`"false"`는 파일만 반환)
+
+---
+
+## 도구 (실험적)
+
+| 방법  | 경로                                        | 설명                    | 응답                                          |
+| ----- | ------------------------------------------- | ----------------------- | --------------------------------------------- |
+| `GET` | `/experimental/tool/ids`                    | 모든 도구 ID            | <a href={typesUrl}><code>도구</code></a>      |
+| `GET` | `/experimental/tool?provider=<p>&model=<m>` | 모델용 JSON 스키마 목록 | <a href={typesUrl}><code>도구 목록</code></a> |
+
+---
+
+### LSP, 포매터 & MCP
+
+| 방법   | 경로         | 설명                   | 응답                                                     |
+| ------ | ------------ | ---------------------- | -------------------------------------------------------- |
+| `GET`  | `/lsp`       | LSP 서버 상태          | <a href={typesUrl}><code>LSPStatus[]</code></a>          |
+| `GET`  | `/formatter` | 형식의 상태를 확인     | <a href={typesUrl}><code>FormatterStatus[]</code></a>    |
+| `GET`  | `/mcp`       | MCP 서버 상태를 얻는다 | `{ [name: string]: `<a href={typesUrl}>MCPStatus</a>` }` |
+| `POST` | `/mcp`       | MCP 서버가 동적        | 본체: `{ name, config }`, MCP 상태 객체를 반환           |
+
+---
+
+## 에이전트
+
+| 방법  | 경로     | 설명                      | 응답                                            |
+| ----- | -------- | ------------------------- | ----------------------------------------------- |
+| `GET` | `/agent` | 이용 가능한 모든 에이전트 | <a href={typesUrl}><code> 에이전트[]</code></a> |
+
+---
+
+### 로깅
+
+| 방법   | 경로   | 설명                                                  | 응답      |
+| ------ | ------ | ----------------------------------------------------- | --------- |
+| `POST` | `/log` | 로그 입력 바디: `{ service, level, message, extra? }` | `boolean` |
+
+---
+
+### TUI
+
+| 방법   | 경로                    | 설명                                      | 응답           |
+| ------ | ----------------------- | ----------------------------------------- | -------------- |
+| `POST` | `/tui/append-prompt`    | 프롬프트에 텍스트를 부여                  | `boolean`      |
+| `POST` | `/tui/open-help`        | 도움말 대화 열기                          | `boolean`      |
+| `POST` | `/tui/open-sessions`    | 세션 선택 안내                            | `boolean`      |
+| `POST` | `/tui/open-themes`      | 테마 선택 안내                            | `boolean`      |
+| `POST` | `/tui/open-models`      | 모델 선택 안내                            | `boolean`      |
+| `POST` | `/tui/submit-prompt`    | 현재 프롬프트 제출                        | `boolean`      |
+| `POST` | `/tui/clear-prompt`     | 시프트 클리어                             | `boolean`      |
+| `POST` | `/tui/execute-command`  | 명령어 실행(`{ command }`)                | `boolean`      |
+| `POST` | `/tui/show-toast`       | 쇼 토스트(`{ title?, message, variant }`) | `boolean`      |
+| `GET`  | `/tui/control/next`     | 다음 컨트롤 요청 시 기다리고              | 제어 요청 개체 |
+| `POST` | `/tui/control/response` | 통제 요청(`{ body }`) 대응                | `boolean`      |
+
+---
+
+### 인증
+
+| 방법  | 경로        | 설명                                                | 응답      |
+| ----- | ----------- | --------------------------------------------------- | --------- |
+| `PUT` | `/auth/:id` | 인증 자격 증명 몸은 공급자 스키마를 일치해야 합니다 | `boolean` |
+
+---
+
+## 이벤트
+
+| 방법  | 경로     | 설명                                                                            | 응답                     |
+| ----- | -------- | ------------------------------------------------------------------------------- | ------------------------ |
+| `GET` | `/event` | 서버 전송 이벤트 스트림. 첫 번째 이벤트는 `server.connected`, 그 후 버스 이벤트 | Server-sent event stream |
+
+---
+
+### 문서
+
+| 방법  | 경로   | 설명             | 응답                     |
+| ----- | ------ | ---------------- | ------------------------ |
+| `GET` | `/doc` | OpenAPI 3.1 사양 | HTML 페이지 OpenAPI 사양 |

package/src/content/docs/ko/share.mdx

@@ -0,0 +1,128 @@
+---
+title: 공유
+description: OpenCode 대화를 공유하세요.
+---
+
+opencode의 공유 기능은 opencode 대화에 대한 공개 링크를 만들 수 있으므로 Teammates와 협업하거나 다른 곳에서 도움을받을 수 있습니다.
+
+:::note
+공유 대화는 링크를 통해 누구나 쉽게 접근할 수 있습니다.
+:::
+
+---
+
+## 작동 방식
+
+대화를 공유할 때, opencode:
+
+1. 세션에 대한 독특한 공개 URL 만들기
+2. 우리의 서버에 대화 기록 동기화
+3. 공유 가능한 링크를 통해 접근 할 수있는 대화 만들기 — `opncd.ai/s/<share-id>`
+
+---
+
+## 공유
+
+opencode는 대화가 공유되는 방법을 제어하는 세 가지 공유 모드를 지원합니다.
+
+---
+
+## 수동 (기본)
+
+기본적으로 opencode는 수동 공유 모드를 사용합니다. 세션은 자동으로 공유되지 않지만 `/share` 명령을 사용하여 수동으로 공유 할 수 있습니다.
+
+```
+/share
+```
+
+클립보드에 복사할 수 있는 독특한 URL을 생성합니다.
+
+[config 파일](/docs/config)에서 수동 모드를 명시적으로 설정하려면:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "manual"
+}
+```
+
+---
+
+## 자동 공유
+
+`share` 옵션을 설정하여 모든 새로운 대화에 대한 자동 공유를 활성화 할 수 있습니다 `"auto"` 당신의 [config 파일](/docs/config):
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "auto"
+}
+```
+
+자동 공유 활성화로 모든 새로운 대화는 자동으로 공유되고 링크가 생성됩니다.
+
+---
+
+#### 비활성화
+
+`share` 옵션을 설정하여 완전히 공유할 수 있습니다. `"disabled"`에 [config file](/docs/config):
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "disabled"
+}
+```
+
+주어진 프로젝트를 위해 팀 전반에 걸쳐 이것을 시행하려면 프로젝트에 `opencode.json`에 추가하고 Git로 확인하십시오.
+
+---
+
+## 공유 취소
+
+대화를 중지하고 공공 액세스에서 제거 :
+
+```
+/unshare
+```
+
+이 공유 링크를 제거하고 대화와 관련된 데이터를 삭제합니다.
+
+---
+
+## 개인 정보
+
+대화를 나누면 마음이 유지되는 몇 가지가 있습니다.
+
+---
+
+## 데이터 보유
+
+공유 대화는 명시적으로 그들을 공유 할 때까지 접근 할 수 있습니다. 이름 \*
+다음:
+
+- 전체 대화 기록
+- 모든 메시지 및 응답
+- 세션 메타데이터
+
+---
+
+### 추천
+
+- 민감한 정보를 포함하지 않는 대화 만 공유합니다.
+- 공유하기 전에 대화 내용을 검토하십시오.
+- 협업이 완료되면 Unshare 대화.
+- 독점 코드 또는 기밀 데이터와 대화를 공유하지 마십시오.
+- 민감한 프로젝트를 위해, 완전히 공유할 수 있습니다.
+
+---
+
+## 기업용
+
+기업 배포를 위해, 공유 기능은:
+
+- ** 보안 준수를 위해 완전히 비활성화 **
+- **SSO를 통해 인증된 사용자에 대한 제한 **
+- ** 자체 인프라 **
+
+[Learn more](/docs/enterprise) 귀하의 조직에서 opencode를 사용하여.

package/src/content/docs/ko/skills.mdx

@@ -0,0 +1,222 @@
+---
+title: "에이전트 스킬"
+description: "SKILL.md 정의를 통해 재사용 가능한 동작을 정의합니다."
+---
+
+Agent Skill let opencode discover reusable instruction from your repo 또는 홈 디렉토리.
+Skills are loaded on-demand via native `skill` tool-agents see available skills and can loaded full content when needed.
+
+---
+
+## 파일 위치
+
+기술 이름 당 하나의 폴더를 만들고 내부 `SKILL.md`를 넣어.
+opencode 이 위치를 검색:
+
+- 프로젝트 구성: `.opencode/skills/<name>/SKILL.md`
+- 글로벌 구성: `~/.config/opencode/skills/<name>/SKILL.md`
+- 프로젝트 클로드 호환 : `.claude/skills/<name>/SKILL.md`
+- 글로벌 클로드 호환 : `~/.claude/skills/<name>/SKILL.md`
+- 프로젝트 에이전트 호환 : `.agents/skills/<name>/SKILL.md`
+- 글로벌 에이전트 호환 : `~/.agents/skills/<name>/SKILL.md`
+
+---
+
+## 검색 이해
+
+Project-local paths의 경우, opencode는 git worktree에 도달 할 때까지 현재 작업 디렉토리에서 걷습니다.
+그것은 `skills/*/SKILL.md`에 있는 어떤 어울리는 `.opencode/` 및 어떤 어울리는 `.claude/skills/*/SKILL.md` 또는 `.agents/skills/*/SKILL.md`를 방법 적재합니다.
+
+세계적인 정의는 또한 `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` 및 `~/.agents/skills/*/SKILL.md`에서 적재됩니다.
+
+---
+
+## Frontmatter 작성
+
+각 `SKILL.md`는 YAML frontmatter로 시작해야 합니다.
+이 필드는 인식됩니다:
+
+- `name` (필수)
+- `description` (필수)
+- (선택) `license`
+- (선택) `compatibility`
+- `metadata` (선택 사항, 문자열에 문자열 맵)
+
+알려진 frontmatter 필드는 무시됩니다.
+
+---
+
+## 유효한 이름
+
+`name`는 해야 합니다:
+
+- 1–64자
+- 단 하나 hyphen 분리기를 가진 더 낮은 케이스 alphanumeric가 있으십시오
+- `-`로 시작 또는 끝 아닙니다
+- 연속 `--` 포함하지
+- `SKILL.md`를 포함하는 디렉토리 이름을 일치
+
+동등한 regex:
+
+```text
+^[a-z0-9]+(-[a-z0-9]+)*$
+```
+
+---
+
+## 길이 규칙 준수
+
+`description`는 1-1024 특성이어야 합니다.
+제대로 선택하기 위해 에이전트에 대해 충분히 유지하십시오.
+
+---
+
+## 사용 예제
+
+이처럼 `.opencode/skills/git-release/SKILL.md` 만들기:
+
+```markdown
+---
+name: git-release
+description: Create consistent releases and changelogs
+license: MIT
+compatibility: opencode
+metadata:
+  audience: maintainers
+  workflow: github
+---
+
+## What I do
+
+- Draft release notes from merged PRs
+- Propose a version bump
+- Provide a copy-pasteable `gh release create` command
+
+## When to use me
+
+Use this when you are preparing a tagged release.
+Ask clarifying questions if the target versioning scheme is unclear.
+```
+
+---
+
+## 도구 설명 인식
+
+opencode는 `skill` 도구 설명에서 사용할 수있는 기술을 나열합니다.
+각 항목에는 기술 이름 및 설명이 포함됩니다.
+
+```xml
+<available_skills>
+  <skill>
+    <name>git-release</name>
+    <description>Create consistent releases and changelogs</description>
+  </skill>
+</available_skills>
+```
+
+에이전트는 도구를 호출하여 기술을로드 :
+
+```
+skill({ name: "git-release" })
+```
+
+---
+
+## 권한 구성
+
+기술 에이전트가 `opencode.json`의 패턴 기반 권한을 사용하여 액세스 할 수있는 제어 :
+
+```json
+{
+  "permission": {
+    "skill": {
+      "*": "allow",
+      "pr-review": "allow",
+      "internal-*": "deny",
+      "experimental-*": "ask"
+    }
+  }
+}
+```
+
+| 권한    | 동작                              |
+| ------- | --------------------------------- |
+| `allow` | 기술이 즉시 로드됨                |
+| `deny`  | 에이전트에서 기술 숨김, 접근 거부 |
+| `ask`   | 로드 전에 사용자에게 승인 요청    |
+
+패턴 지원 와일드 카드: `internal-*` 경기 `internal-docs`, `internal-tools`, 등.
+
+---
+
+## 에이전트별 재정의
+
+글로벌 디폴트보다 특정 에이전트 다른 권한을 부여합니다.
+
+**사용자 지정 에이전트 ** ( 에이전트 frontmatter):
+
+```yaml
+---
+permission:
+  skill:
+    "documents-*": "allow"
+---
+```
+
+** 내장 에이전트 ** (`opencode.json`에서):
+
+```json
+{
+  "agent": {
+    "plan": {
+      "permission": {
+        "skill": {
+          "internal-*": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+## 스킬 도구 비활성화
+
+그들을 사용하지 않는 에이전트을위한 완전히 비활성화 된 기술 :
+
+**사용자 지정 에이전트**:
+
+```yaml
+---
+tools:
+  skill: false
+---
+```
+
+** 내장 에이전트 **:
+
+```json
+{
+  "agent": {
+    "plan": {
+      "tools": {
+        "skill": false
+      }
+    }
+  }
+}
+```
+
+비활성화 할 때, `<available_skills>` 섹션은 완전히 부유합니다.
+
+---
+
+## 로딩 문제 해결
+
+기술이 나타나지 않는 경우:
+
+1. `SKILL.md`는 모든 모자에서 spelled
+2. `name`와 `description`를 포함하는 검사
+3. 기술 이름은 모든 위치에서 독특합니다.
+4. `deny`를 가진 허가를 검사하십시오 에이전트에서 숨겨집니다