콘텐츠로 이동
OpenCode
app.header.homeapp.header.docs

Commands

Create custom commands for repetitive tasks.

사용자 지정 명령은 TUI에서 실행될 때 실행할 때 실행해야 합니다.

/my-command

사용자 정의 명령은 /init, /undo, /redo, /share, /share, /help와 같은 내장된 명령 이외에 있습니다. 더 알아보기.

명령 파일 생성

사용자 지정 명령을 정의하려면 commands/ 디렉토리의 Markdown 파일을 만듭니다.

.opencode/commands/test.md 만들기:

.opencode/commands/test.md
---
description: Run tests with coverage
agent: build
model: anthropic/claude-3-5-sonnet-20241022
---


Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.

frontmatter 명령 속성을 정의합니다. 콘텐츠는 템플릿이 됩니다.

명령명에 따라 /를 입력하여 명령을 사용하십시오.

"/test"

구성

opencode config를 통해 사용자 지정 명령을 추가하거나 commands/ 디렉토리에 있는 Markdown 파일을 만들 수 있습니다.

JSON 태그

opencode config에서 command 옵션을 사용하십시오:

opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "command": {
    // This becomes the name of the command
    "test": {
      // This is the prompt that will be sent to the LLM
      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.",
      // This is shown as the description in the TUI
      "description": "Run tests with coverage",
      "agent": "build",
      "model": "anthropic/claude-3-5-sonnet-20241022"
    }
  }
}

이제 TUI에서이 명령을 실행할 수 있습니다.

/test

Markdown

Markdown 파일을 사용하여 명령을 정의할 수 있습니다. 그들에 게:

  • 글로벌: ~/.config/opencode/commands/
  • 프로젝트: .opencode/commands/
~/.config/opencode/commands/test.md
---
description: Run tests with coverage
agent: build
model: anthropic/claude-3-5-sonnet-20241022
---


Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.

markdown 파일 이름은 명령 이름입니다. 예를 들어, test.md lets 당신은 실행:

/test

Prompt 구성

사용자 정의 명령에 대한 프롬프트는 몇 가지 특별한 placeholders 및 구문을 지원합니다.

가격

$ARGUMENTS placeholder를 사용하여 명령을 전달합니다.

.opencode/commands/component.md
---
description: Create a new component
---


Create a new React component named $ARGUMENTS with TypeScript support.
Include proper typing and basic structure.

인수로 명령을 실행:

/component Button

그리고 $ARGUMENTS는 Button로 대체될 것입니다.

위치 매개 변수를 사용하여 개별 인수에 액세스 할 수 있습니다.

  • $1 - 첫 번째 인수
  • $2 - 두 번째 인수
  • $3 - 세 번째 인수
  • 그래서 …

예를 들면:

.opencode/commands/create-file.md
---
description: Create a new file with content
---


Create a file named $1 in the directory $2
with the following content: $3

명령을 실행:

/create-file config.json src "{ \"key\": \"value\" }"

이렇게 대체됩니다:

  • $1는 config.json
  • $2는 src
  • $3는 { "key": "value" }

포탄 산출

사용 !command 는 bash command를 프롬프트로 출력합니다.

예를 들어, 테스트 범위를 분석하는 사용자 정의 명령을 만들려면:

.opencode/commands/analyze-coverage.md
---
description: Analyze test coverage
---


Here are the current test results:
!`npm test`


Based on these results, suggest improvements to increase coverage.

또는 최근 변경 사항 :

.opencode/commands/review-changes.md
---
description: Review recent changes
---


Recent git commits:
!`git log --oneline -10`


Review these changes and suggest any improvements.

명령은 프로젝트의 루트 디렉토리에서 실행하고 출력은 프롬프트의 일부가됩니다.

파일 참조

파일명에 따라 @를 사용하여 명령에 파일이 포함되어 있습니다.

.opencode/commands/review-component.md
---
description: Review component
---


Review the component in @src/components/Button.tsx.
Check for performance issues and suggest improvements.

파일 콘텐츠는 자동으로 프롬프트에 포함되어 있습니다.

옵션

구성 옵션을 자세히 살펴봅시다.

템플릿

template 옵션은 명령이 실행될 때 LLM에 전송될 프롬프트를 정의합니다.

opencode.json
{
  "command": {
    "test": {
      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes."
    }
  }
}

** config 옵션이 필요합니다.

묘사

description 옵션을 사용하여 명령의 간단한 설명을 제공합니다.

opencode.json
{
  "command": {
    "test": {
      "description": "Run tests with coverage"
    }
  }
}

명령에 입력할 때 TUI의 설명으로 표시됩니다.

에이전트

agent config를 선택적으로 지정합니다. agent는 이 명령을 실행해야 합니다. 이 경우 subagent 명령은 기본으로 시약을 트리거합니다. 이 행동을 비활성화하려면 subtask를 false로 설정하십시오.

opencode.json
{
  "command": {
    "review": {
      "agent": "plan"
    }
  }
}

** 옵션** 설정 옵션입니다. 지정된 경우, 현재 에이전트에 기본값.

서브스크랩

subtask boolean을 사용하여 명령을 강제로 subagent 호출합니다. 이것은 당신이 명령을 원하지 않는 경우 유용합니다 당신의 기본 컨텍스트를 pollute하고 ** 에이전트는 시약으로 행동하는, mode가 시약 구성에 primary로 설정되는 경우에도.

opencode.json
{
  "command": {
    "analyze": {
      "subtask": true
    }
  }
}

** 옵션** 설정 옵션입니다.

모형

model config를 사용하여 이 명령의 기본 모델을 무시합니다.

opencode.json
{
  "command": {
    "analyze": {
      "model": "anthropic/claude-3-5-sonnet-20241022"
    }
  }
}

** 옵션** 설정 옵션입니다.

내장

opencode는 /init, /undo, /redo, /share, /help, /help와 같은 몇몇 붙박이 명령을 포함합니다; learn more.

같은 이름으로 사용자 정의 명령을 정의하면 내장 명령을 무시합니다.