mcpField
O
opencode-expert

opencode-expert

github.com/s-hiraokuエージェントワークフロー17295 回インストール2 週間前に更新
リポジトリ

opencode-expert について

オープンソースの AI コーディングエージェント OpenCode の操作ガイドです。エージェントモード、CLI コマンド、ツール、設定を扱い、利用者が作業手順を確認できます。

主な機能

  1. 01Build と Plan の使い分け
  2. 02対話型・非対話型 CLI コマンド
  3. 03組み込みツールとサブエージェント
  4. 04スキルの検出と設定
  5. 05セッションの取り消し、やり直し、再開

活用シーン

  1. 01コード変更前にエージェントモードを選択
  2. 02プロンプトの実行やコーディングセッションの再開
  3. 03エージェント、スキル、API キーの設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/s-hiraoku/synapse-a2a --skill opencode-expert

インストール後、Claude Code で/opencode-expertを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
agents.md
cli.md
tools.md

詳細

OpenCode エキスパートガイド

オープンソースの AI コーディングエージェントである OpenCode の包括的なガイドです。

クイックリファレンス

タスクコマンド／操作
TUI を起動opencode
セッションを続行opencode -c または opencode --continue
非対話モードで実行opencode run "message"
ヘッドレスサーバーを起動opencode serve
ウェブインターフェースopencode web
エージェントを切り替えTab キー
ファイルを検索@ を入力してからファイル名を入力
変更を元に戻す/undo
変更をやり直す/redo
会話を共有/share
プロジェクトを初期化/init
API キーを設定/connect

エージェント

OpenCode には、Tab で切り替えられる 2 つの主要なエージェントがあります。

Build エージェント（デフォルト）
  • すべてのツールにフルアクセスできます
  • ファイルの編集、コマンドの実行、変更を行えます
  • 開発作業に使用します
Plan エージェント
  • 分析と調査のための読み取り専用モードです
  • ファイルの編集と bash コマンドの実行には承認が必要です（ask モード）
  • 変更を加える前に、実装方針のレビューに使用します
サブエージェント

@ メンションでサブエージェントを呼び出します。

  • @general - ツールへのフルアクセスを使った、複雑な調査や複数ステップのタスク
  • @explore - コードベースをすばやく読み取り専用で検索したり、コードに関する質問に回答したりします

キーボードショートカット

キー操作
TabBuild エージェントと Plan エージェントを切り替え
@あいまい検索でファイルを検索
Ctrl+C現在の操作をキャンセル

スラッシュコマンド

コマンド説明
/connectLLM プロバイダーの API キーを設定
/initプロジェクトを初期化し、AGENTS.md を作成
/undo最近の変更を元に戻す（連続して実行可能）
/redo元に戻した変更を復元
/share共有可能な会話リンクを作成

CLI コマンド

対話モード
# Start TUI in current directory
opencode

# Start in specific project
opencode /path/to/project

# Continue previous session
opencode --continue
opencode -c

# Use specific session
opencode --session <id>
opencode -s <id>

# Start with specific model
opencode --model <model>
opencode -m <model>

# Start with specific agent
opencode --agent build
opencode --agent plan
非対話モード
# Run single prompt
opencode run "Fix the bug in auth.py"

# Run with file attachment
opencode run "Review this" --file README.md
opencode run "Review this" -f README.md

# Run and share result
opencode run "Explain this code" --share

# Run specific command
opencode run --command "npm test"
サーバーモード
# Start headless API server
opencode serve

# With custom port
opencode serve --port 3000

# With mDNS discovery
opencode serve --mdns

# Web interface
opencode web
管理コマンド
# Authentication
opencode auth login
opencode auth list
opencode auth logout

# Models
opencode models              # List available models
opencode models --refresh    # Refresh model cache

# Agents
opencode agent create        # Create custom agent
opencode agent list          # List agents

# MCP servers
opencode mcp add <server>
opencode mcp list
opencode mcp auth
opencode mcp debug

# Sessions
opencode session list
opencode session list -n 10  # Last 10 sessions

# Statistics
opencode stats
opencode stats --days 7
opencode stats --tools
opencode stats --models

# Export/Import
opencode export <sessionID>
opencode import <file>

# Upgrade
opencode upgrade
opencode upgrade <version>

組み込みツール

OpenCode はエージェントに次のツールを提供します。

ツール説明
read必要に応じて行範囲を指定し、ファイルの内容を読み取ります
write新しいファイルを作成するか、既存のファイルを上書きします
edit文字列を完全一致で置換してファイルを変更します
patchパッチファイルを適用します
grep正規表現でファイルの内容を検索します
globパターン（**/*.js）でファイルを検索します
listファイルとディレクトリを一覧表示します
bashシェルコマンドを実行します
lspLanguage Server Protocol との連携（実験的機能）
todowriteタスクリストを作成／更新します
todoread現在の TODO の状態を読み取ります
skillスキルファイルを会話に読み込みます
webfetchウェブページを取得して読み取ります
questionユーザーに確認の質問をします

スキル

ファイルの場所

スキルは次の場所から順に検出されます。

  1. .agents/skills/<name>/SKILL.md（プロジェクト用、Codex と共有）
  2. .claude/skills/<name>/SKILL.md（Claude 互換のプロジェクト用）
  3. ~/.config/opencode/skills/<name>/SKILL.md（グローバル）
  4. ~/.claude/skills/<name>/SKILL.md（Claude 互換のグローバル）
スキルの形式
---
name: my-skill
description: Description of what this skill does and when to use it.
---

# Skill Content

Instructions and documentation here...
名前のルール
  • 小文字の英数字を使い、ハイフンは単独で使用します
  • ハイフンで始めたり終えたりすることはできません
  • ハイフンを連続して使用することはできません（--）
  • ディレクトリ名と一致する必要があります

設定

設定ファイルの場所
  • プロジェクト：.opencode/ または opencode.json
  • グローバル：~/.config/opencode/
環境変数
変数説明
OPENCODE_CONFIGカスタム設定ファイルのパス
OPENCODE_PERMISSION権限モード
OPENCODE_SERVER_PASSWORDサーバー認証パスワード
OPENCODE_DISABLE_AUTOUPDATE自動更新を無効化
OPENCODE_EXPERIMENTAL実験的機能を有効化
OPENCODE_ENABLE_EXAExa 検索を有効化
カスタムエージェント

opencode agent create でエージェントを作成するか、次の場所で定義します。

  • opencode.json
  • ~/.config/opencode/agents/
  • .opencode/agents/

エージェントの設定項目：説明、temperature、モデル、ツールの権限、システムプロンプト。

ベストプラクティス

まず Plan モードを使用する

変更を加える前に、Plan エージェント（Tab）に切り替えて実装方針を確認します。

ファイル参照

プロンプト内でファイルをあいまい検索して参照するには、@filenameを使用します。

元に戻すスタック

/undoは気軽に使用してください。変更はスタックに追加され、/redoで元に戻せます。

セッション管理

--continueまたは-cを使用すると、以前のセッションを再開してコンテキストを維持できます。

参考資料

詳細なドキュメントについては、以下を参照してください。

  • references/cli.md - CLI の完全なリファレンス
  • references/tools.md - ツールの詳細と権限
  • references/agents.md - エージェント設定ガイド

コメント

Markdown 対応