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 を入れないでください。ファイル参照や 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 と切り分けられます。