OpenCode 명령어: 사용자 명령어, 인수와 안전한 재사용

OpenCode에는 /init, /undo, /redo, /share, /help가 포함됩니다. Shell 별칭도 아니고 package.json에 넣는 스크립트도 아닙니다. OpenCode 입력창에서 실행한 뒤 결과나 확인 메시지를 읽으세요.

설치한 버전의 목록이 확실하지 않다면 /help부터 확인합니다. /undo와 /redo는 Git 커밋을 대신하지 않습니다. /share는 비공개 코드에서 사용하기 전에 공개되는 세션 데이터를 확인하세요. 기본 목록은 버전에 따라 달라질 수 있습니다.

1. 프로젝트 루트에 .opencode/commands/review.md를 만듭니다.
2. 짧은 설명과 범위가 분명한 작업을 작성합니다.
3. 작은 브랜치에서 실행하고 프롬프트와 diff를 검토합니다.

---
description: Review the current changes
---
Review the current Git changes. Explain risky behavior,
missing tests, and the smallest safe follow-up.
Do not edit files until I approve the plan.

파일 이름이 명령어 이름이 되므로 /review로 실행합니다. 개인용 전역 흐름은 ~/.config/opencode/commands/, 프로젝트 경로·테스트·팀 규칙을 포함하는 명령어는 .opencode/commands/가 적합합니다. “변경 사항을 검토하고 계획을 제안하라”가 “전부 수정하라”보다 검증하기 쉽습니다.

JSON 또는 JSONC 설정의 command 객체에서도 사용자 명령어를 정의할 수 있습니다. 특정 agent나 model을 선택해야 할 때 유용합니다. 경로, Schema와 우선순위는 opencode.jsonc 설정 가이드에서 확인하세요.

{
  "$schema": "https://opencode.ai/config.json",
  "command": {
    "test-review": {
      "template": "Review the latest test output and list the first three fixes.",
      "description": "Review test output",
      "agent": "plan"
    }
  }
}

설정 파일은 비밀 저장소가 아닙니다. API key와 token은 Provider의 인증 경로에 보관하세요. 파일이나 Shell 출력을 사용하는 명령어는 짧아도 스크립트처럼 검토해야 합니다.

---
description: Create a file with supplied values
---
Create a file named $1 in directory $2.
Use this content: $3
Show the proposed path before writing.

/create-file config.json src "{ \"key\": \"value\" }"는 세 값을 전달합니다. 템플릿에는 각 값의 사용처와 쓰기 전 표시할 경로를 적습니다. 자유로운 한 문장만 필요하면 $ARGUMENTS가 더 간단합니다.

@src/components/Button.tsx로 파일을 참조하고, !`npm test` 또는 !`git log --oneline -10`으로 Shell 출력을 프롬프트에 넣을 수 있습니다. 프로젝트 루트에서 실행되므로 파괴적인 작업이나 비밀을 재사용 템플릿에 넣지 마세요.

인수는 입력이지 권한이 아닙니다. 먼저 읽기 전용으로 확인하고 작은 수정만 승인한 뒤 신뢰할 수 있는 저장소에서 자동화하세요.

기본 명령어와 같은 이름의 사용자 명령어는 기본 동작을 덮어쓸 수 있습니다. 의도한 변경이 아니라면 help, undo, share를 피하고 review-tests처럼 결과가 드러나는 이름을 사용하세요.

명령어 파일도 코드처럼 검토합니다. 프롬프트 diff, 결과, 참조 파일과 제안된 Shell을 확인하세요. agent와 model은 Agents 가이드, Skills와 MCP 범위는 Skills 가이드와 MCP 가이드를 참고합니다.

1. 범위: 입력과 출력을 한 문장으로 정합니다.
2. 위치: 프로젝트용인지 전역용인지 선택하고 기록합니다.
3. 입력: 정상, 누락, 따옴표, 경로 값을 시험합니다.
4. 컨텍스트: 수정 전에 파일 참조와 Shell 출력을 확인합니다.
5. 권한: ask 또는 읽기에서 시작하고 작은 변경만 승인합니다.
6. 되돌리기: Git에 남기고 비활성화·이름 변경 방법을 기록합니다.

이 순서를 지키면 명령어 누락은 경로, 잘못된 결과는 프롬프트나 인수, 수정 거부는 권한, model 실패는 Provider 문제로 분리할 수 있습니다.