設定とカスタマイズ

Verdent for VS Code には、開発ワークフロー、コーディングの好み、チーム標準に合わせて調整できる豊富な設定オプションがあります。VS Code のネイティブ設定インターフェースから各種設定を構成し、キーボードショートカットをカスタマイズし、専用の動作を定義するルールやサブエージェントを作成できます。

このページで学べること

• Verdent 向けに VS Code の拡張機能設定を構成する
• 効率的なワークフローのためにキーボードショートカットをカスタマイズする
• エージェントの動作をパーソナライズするルールを作成・管理する
• 専門タスク向けのカスタムサブエージェントを構築する

前提条件

• Verdent for VS Code がインストールされ、認証済みであること
• VS Code の設定にアクセスできること（Cmd+, または Ctrl+,）
• ルールファイル用の JSON の基本的な理解（任意）

VS Code 拡張機能の設定

Verdent for VS Code の設定は、設定の種類とスコープに応じて複数の場所からアクセスします。

設定へのアクセス

拡張機能の設定（VS Code ネイティブ）:

1. VS Code の設定を開きます: Cmd+,（macOS）または Ctrl+,（Windows/Linux）
2. 設定の検索バーで「Verdent」を検索します
3. 拡張機能の設定を変更します（例: verdent.enableCheckpoints）

Verdent 固有の設定:

Verdent の上部バーにある Settings ボタンを選択すると、次にアクセスできます。

• Rules - User Rules、Project Rules、Plan Rules
• MCP Servers - Model Context Protocol の設定
• Subagents - カスタムサブエージェントの管理

チャット内のコントロール:

多くの設定は、Verdent パネル下部の入力ボックスから直接切り替えられます。

• Switch Permission - Manual Accept、Auto-Run、Plan、Skip Permissions
• Switch Mode - Agent、Plan、Chat の各モード
• Switch/Customize AI Model - Performance、Balance、Efficiency のプリセット
• Think Hard Mode - 複雑な推論のための最大思考予算
• Add Context - @メンションでファイルを添付
• Add Images or Files - スクリーンショットやドキュメントを追加
• Add Subagent - 専用サブエージェントに委任

設定の変更は VS Code を再起動することなく即座に反映されます。

利用可能な拡張機能の設定

Verdent for VS Code には、VS Code の設定インターフェースから構成できる 2 つの中核的な拡張機能設定 があります。

入力ボックスのコントロールリファレンス

Verdent パネル下部の入力ボックスからは、各種設定コントロールにすばやくアクセスできます。

権限モード

モデルプリセット

キーボードショートカットのカスタマイズ

デフォルトのショートカット

主要ショートカット:

• macOS: Cmd+L - Verdent パネルを開く/フォーカス
• Windows/Linux: Ctrl+L - Verdent パネルを開く/フォーカス
  • コマンド: verdent.addToChat
  • コマンドパレットおよびエディタのコンテキストから動作

これは、コーディングの流れを中断することなく、VS Code 内のどこからでもすばやく Verdent にアクセスするための必須ショートカットです。

追加コマンド:

コマンドパレットから利用可能（デフォルトのショートカットはカスタマイズ可能）:

• verdent.addFeedBack - フィードバックを送信
• verdent.addTerminalOutputToChat - ターミナル出力を Verdent に追加
• verdent.addToChatBySearch - 検索で Verdent に追加
• verdent.centerButtonClicked - ユーザーセンター
• verdent.historyButtonClicked - プロジェクト履歴
• verdent.mcpButtonClicked - MCP Server を追加
• verdent.openInNewTabByParams - 新しいタブで開く
• verdent.plusButtonClicked - 新しいセッション
• verdent.rulesButtonClicked - ルール設定
• verdent.SettingClicked - 設定メニュー
• verdent.subagentButtonClicked - サブエージェントを追加

ショートカットのカスタマイズ

Verdent のすべてのキーボードショートカットは、VS Code の標準的なキーバインドシステムでカスタマイズできます。

{
  "key": "cmd+shift+v",
  "command": "verdent.addToChat"
}

{
  "key": "ctrl+shift+v",
  "command": "verdent.addToChat"
}

カスタマイズの範囲:

• すべての Verdent コマンドを再割り当て可能
• 同じコマンドに複数のショートカットを割り当て可能
• デフォルトのショートカットを削除可能
• 変更は VS Code の Settings Sync で複数のマシン間で同期

プラットフォーム別のショートカット

Verdent は VS Code のプラットフォーム別キーボード規約に従います。

一般的なパターン:

• 設定: Cmd+,（macOS）vs Ctrl+,（Windows/Linux）
• コマンドパレット: Cmd+Shift+P（macOS）vs Ctrl+Shift+P（Windows/Linux）
• Keyboard Shortcuts: Cmd+K Cmd+S（macOS）vs Ctrl+K Ctrl+S（Windows/Linux）

カスタム指示とペルソナ

Verdent for VS Code は AI の動作をカスタマイズする 2 つの仕組みをサポートしています。好みやガイドラインを定義する Rules と、専門タスク向けのペルソナを定義する Subagents です。

ルールシステム

ルールは、コーディングセッション中に Verdent がどのように動作・応答するかを定義します。ルールは Markdown ファイルに保存され、会話を通じて継続的に適用されます。

3 種類のルール

1. User Rules（VERDENT.md）:

• 場所: ~/.verdent/（グローバル設定ディレクトリ）
• スコープ: すべてのプロジェクトのすべての会話に適用
• 目的: 個人のコーディングの好み、コミュニケーションスタイル、ドキュメント標準

2. Project Rules（AGENTS.md）:

• 場所: プロジェクトのルートディレクトリまたはワークスペース
• スコープ: 現在のプロジェクトにのみ適用
• バージョン管理: チーム全体の標準として git にコミット可能
• 目的: プロジェクト固有のコーディング標準、アーキテクチャパターン、テスト要件

3. Plan Rules（plan_rules.md）:

• 場所: ~/.verdent/（グローバル設定ディレクトリ）
• スコープ: すべてのプロジェクトで Plan Mode を使う際に適用
• 目的: 計画の内容、形式、詳細度をカスタマイズ

ルールの作成と編集

User Rules の例:

# Code Style Preferences
- Always use functional React components with hooks
- Prefer TypeScript over JavaScript
- Add JSDoc comments for all exported functions
- Provide explanations before showing code

Project Rules の例:

## Testing instructions
- Run `pnpm turbo run test --filter <project_name>` to run all checks
- Fix test and type errors until suite is green
- Add or update tests for code changes

## PR instructions
- Title format: [<project_name>] <Title>
- Always run `pnpm lint` and `pnpm test` before committing

ルールの保存と適用

設定の優先順位:

ルールが競合する場合、Verdent は次の優先順位で適用します。

1. Project Rules（AGENTS.md） - 最優先（プロジェクト固有）
2. User Rules（VERDENT.md） - グローバルなユーザー設定
3. デフォルトの動作 - Verdent の組み込みデフォルト

Subagents

サブエージェントは、特定のタスクを処理するためのカスタムシステムプロンプトと独立したコンテキストウィンドウを持つ専用 AI エージェントです。

組み込みサブエージェント

Verdent には、設定なしですぐに利用できる 3 つのデフォルトサブエージェントが含まれています。

カスタムサブエージェントの作成

サブエージェントのファイル形式:

---
name: security-reviewer
description: Security-focused code review specialist
---
# System Prompt

You are a security-focused code reviewer. When analyzing code:
- Prioritize security vulnerabilities (SQL injection, XSS, auth flaws)
- Use skeptical, critical tone - assume code is vulnerable until proven otherwise
- Provide specific remediation steps with code examples
- Reference OWASP Top 10 and security best practices
- Never approve code with unresolved security issues

Invocation policy (strict): Only run security-reviewer if user explicitly requests it.

When to use the security-reviewer agent:
- User requests security review of authentication/authorization logic
- User asks to audit code for vulnerabilities
- User needs security assessment before deployment

When NOT to use:
- General code review without security focus
- Opening or reading files without analysis

サブエージェントの管理

Settings → Subagents から次のことができます。

• Edit: システムプロンプト、ツール権限、設定を変更
• Copy: バリエーションやテンプレート用にサブエージェントを複製
• Delete: 使用していないサブエージェントを削除
• Enable/Disable: 削除せずに利用可否を切り替え

サブエージェントの使用

組み込みサブエージェント:

• @メンションで参照: @Verifier、@Explorer、@Code-reviewer
• 適切なタスクタイプが検出されると自動的に呼び出される

カスタムサブエージェント:

• 入力ボックスの Add Subagent ボタンを選択
• ドロップダウンから選択
• メインエージェントが適切なタスクを自動的に委任

サブエージェントとルールの違い

ワークフローの例:

1. User Rule: 「すべての新規関数にユニットテストを生成する」
2. メインエージェント: テスト生成の必要性を検出
3. Test Generator サブエージェントに委任: 専門的で包括的なテストアプローチ
4. サブエージェント: 独立したコンテキストで完全なテストスイートを生成
5. メインエージェント: 結果を受け取り、コンテキストを汚染せずに続行

FAQ（よくある質問）

関連項目