# Oh My Zsh 業務運用マニュアル

## 目次

**【基本操作】**
1. [システム概要](#1-システム概要)
2. [インストール・アンインストール手順](#2-インストールアンインストール手順)
3. [基本的な操作（omzコマンド）](#3-基本的な操作omzコマンド)

**【業務フローに沿った機能】**
4. [【STEP1】プラグイン管理（機能の有効化・設定）](#4-step1プラグイン管理機能の有効化設定)
5. [【STEP2-3】テーマ管理（外観のカスタマイズ）](#5-step2-3テーマ管理外観のカスタマイズ)
6. [【STEP3-4】日常操作（ショートカット・エイリアス活用）](#6-step3-4日常操作ショートカットエイリアス活用)
7. [【STEP4-5】更新・メンテナンス（管理者向け）](#7-step4-5更新メンテナンス管理者向け)

**【サポート機能】**
8. [Git統合機能](#8-git統合機能)
9. [ユーティリティ機能](#9-ユーティリティ機能)
10. [診断・トラブルシューティング機能](#10-診断トラブルシューティング機能)

**【運用ガイド】**
11. [日常業務の流れ](#11-日常業務の流れ)
12. [よくある質問と対処法](#12-よくある質問と対処法)
13. [トラブルシューティング](#13-トラブルシューティング)

---

## 1. システム概要

### 1.1 Oh My Zshとは

Oh My Zshは、Zshシェルの設定を管理するためのオープンソースのコミュニティ主導フレームワークです。ターミナル（コマンドライン）での作業効率を大幅に向上させるツールであり、以下の特徴を持ちます。

- 355以上のプラグインによる機能拡張
- 143以上のテーマによる外観カスタマイズ
- 高度な自動補完機能
- Git統合によるリポジトリ情報の視覚化
- クロスプラットフォーム対応（Linux、macOS、Windows WSL2）

### 1.2 本システムで行う主要業務

本システムは、主に以下の業務を支援します。

| 業務カテゴリ | 具体的な業務内容 |
|------------|----------------|
| **環境構築** | Oh My Zshのインストール、設定ファイルの初期化、デフォルトシェルの変更 |
| **プラグイン管理** | プラグインの有効化・無効化、プラグイン情報の確認、動的ロード |
| **テーマ管理** | テーマの一覧表示、テーマの適用・設定、外観カスタマイズ |
| **日常操作** | コマンド補完、履歴検索、エイリアス活用、ディレクトリ移動 |
| **Git操作** | ブランチ情報の表示、ステータスの確認、リモートとの差分表示 |
| **メンテナンス** | 更新チェック、システム更新、診断情報の出力 |

### 1.3 業務フロー概要

Oh My Zshを使った業務は、以下の流れで進行します。

```
┌─────────────────────────────────────────────────────────────────┐
│                        業務フロー                                │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  【STEP 1】プラグインの有効化・設定                              │
│      ↓     必要な機能（Git、Docker、AWS等）を有効化              │
│                                                                 │
│  【STEP 2】テーマの選択・適用                                    │
│      ↓     作業環境に合わせた外観をカスタマイズ                  │
│                                                                 │
│  【STEP 3】日常操作での活用                                      │
│      ↓     補完、エイリアス、Git統合機能を活用                   │
│                                                                 │
│  【STEP 4】定期的な更新・メンテナンス                            │
│      ↓     最新版への更新、問題の診断                            │
│                                                                 │
│  【STEP 5】カスタム設定の追加（上級者向け）                       │
│            独自プラグイン・テーマの作成                          │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

**役割別の業務概要：**

| 役割 | 主な業務 |
|------|---------|
| **一般ユーザー** | プラグイン・テーマの選択、日常的なターミナル操作、Git作業 |
| **上級ユーザー** | カスタムプラグイン・テーマの作成、設定のチューニング |
| **システム管理者** | 環境構築、更新管理、トラブルシューティング |

### 1.4 主な機能

| 機能 | 説明 | 業務フローでの位置 |
|------|------|------------------|
| プラグイン管理 | 355以上の機能拡張プラグインの有効化・無効化 | STEP 1 |
| テーマ管理 | 143以上のテーマによる外観カスタマイズ | STEP 2 |
| 自動補完 | コマンド・ファイル名・オプションの自動補完 | STEP 3 |
| Git統合 | プロンプトへのGit情報表示、Gitエイリアス | STEP 3 |
| 自動更新 | 定期的な更新チェックと自動更新 | STEP 4 |
| 診断機能 | 環境情報の出力、トラブルシューティング | 随時利用 |

### 1.5 ユーザー種別

システムには以下のユーザー種別があります。

| ユーザー種別 | 説明 |
|-------------|------|
| 一般ユーザー | ターミナルを日常的に使用する開発者・エンジニア |
| 上級ユーザー | カスタム設定やプラグイン作成を行う上級者 |
| システム管理者 | 環境構築や更新管理を担当する管理者 |

### 1.6 対応環境

**対応OS：**
- Linux（各ディストリビューション）
- macOS
- Windows（WSL2）
- FreeBSD
- Android（Termux）

**必要条件：**
- Zsh v4.3.9以上（推奨: v5.0.8以上）
- Git v2.4.11以上（推奨）
- curl または wget

---

## 2. インストール・アンインストール手順

### 2.1 インストール方法

#### 自動インストール（推奨）

1. ターミナルを開きます
2. 以下のコマンドを実行します

**curlを使用する場合：**
```sh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
```

**wgetを使用する場合：**
```sh
sh -c "$(wget -O- https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
```

3. インストールが完了すると、自動的にzshが起動します

**インストール時のオプション：**

| 環境変数 | 説明 | デフォルト値 |
|---------|------|-------------|
| `CHSH` | デフォルトシェルを変更するか | yes |
| `RUNZSH` | インストール後にzshを起動するか | yes |
| `KEEP_ZSHRC` | 既存の.zshrcを保持するか | no |

例：既存の.zshrcを保持してインストール
```sh
KEEP_ZSHRC=yes sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
```

#### 手動インストール

1. リポジトリをクローンします
```sh
git clone https://github.com/ohmyzsh/ohmyzsh.git ~/.oh-my-zsh
```

2. 既存の.zshrcをバックアップします
```sh
cp ~/.zshrc ~/.zshrc.orig
```

3. テンプレートから新しい.zshrcを作成します
```sh
cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc
```

4. デフォルトシェルをzshに変更します
```sh
chsh -s $(which zsh)
```

5. ターミナルを再起動します

### 2.2 アンインストール方法

1. ターミナルで以下のコマンドを実行します
```sh
uninstall_oh_my_zsh
```

2. 確認メッセージが表示されたら「y」を入力します

3. 以前の設定が復元されます
   - `.zshrc.pre-oh-my-zsh`が`.zshrc`に復元されます
   - 以前のデフォルトシェルが復元されます

### 2.3 インストールの確認

インストールが正常に完了したか確認するには、以下のコマンドを実行します。

```sh
omz version
```

バージョン情報が表示されれば、インストールは成功しています。

---

## 3. 基本的な操作（omzコマンド）

### 3.1 omzコマンドの概要

`omz`コマンドは、Oh My Zshを管理するための統合CLIインターフェースです。

**ヘルプの表示：**
```sh
omz help
```

**利用可能なサブコマンド：**

| サブコマンド | 説明 |
|------------|------|
| `omz help` | ヘルプを表示 |
| `omz changelog` | 変更履歴を表示 |
| `omz plugin` | プラグインを管理 |
| `omz theme` | テーマを管理 |
| `omz update` | Oh My Zshを更新 |
| `omz reload` | zshセッションを再読み込み |
| `omz version` | バージョンを表示 |
| `omz pr` | Pull Requestをテスト（開発者向け） |
| `omz shop` | 公式ショップを開く |

### 3.2 セッションの再読み込み

プラグインやテーマの設定を変更した後は、セッションを再読み込みして変更を反映します。

```sh
omz reload
```

このコマンドは以下の処理を行います。
1. 補完キャッシュを削除
2. zshセッションを再起動

### 3.3 バージョンの確認

```sh
omz version
```

出力例：
```
master (abc1234)
```

---

## 4. 【STEP1】プラグイン管理（機能の有効化・設定）

> **業務フローでの位置**: 必要な機能（Git、Docker、AWS等）のプラグインを有効化し、作業効率を向上させるステップです。

### 4.1 プラグイン一覧の表示

利用可能なすべてのプラグインを表示します。

```sh
omz plugin list
```

有効なプラグインのみを表示する場合：
```sh
omz plugin list --enabled
```

### 4.2 プラグイン情報の確認

特定のプラグインの詳細情報（README）を表示します。

```sh
omz plugin info <プラグイン名>
```

例：gitプラグインの情報を表示
```sh
omz plugin info git
```

### 4.3 プラグインの有効化

プラグインを有効化して、機能を追加します。

```sh
omz plugin enable <プラグイン名>
```

例：docker と aws プラグインを有効化
```sh
omz plugin enable docker aws
```

**処理内容：**
1. `.zshrc`の`plugins`配列にプラグイン名を追加
2. zshセッションを自動で再読み込み

### 4.4 プラグインの無効化

不要になったプラグインを無効化します。

```sh
omz plugin disable <プラグイン名>
```

例：awsプラグインを無効化
```sh
omz plugin disable aws
```

**処理内容：**
1. `.zshrc`の`plugins`配列からプラグイン名を削除
2. zshセッションを自動で再読み込み

### 4.5 プラグインの動的ロード

現在のセッションにのみプラグインをロードします（永続化されません）。

```sh
omz plugin load <プラグイン名>
```

これは試用やテスト時に便利です。

### 4.6 人気のプラグイン

| プラグイン名 | 説明 |
|-------------|------|
| `git` | Gitのエイリアスと関数を提供 |
| `docker` | Dockerコマンドの補完を提供 |
| `aws` | AWS CLIの補完を提供 |
| `npm` | npmコマンドの補完とエイリアスを提供 |
| `kubectl` | Kubernetesコマンドの補完を提供 |
| `zsh-autosuggestions` | コマンド履歴に基づく自動提案 |
| `zsh-syntax-highlighting` | コマンドのシンタックスハイライト |

### 4.7 手動でのプラグイン設定

`.zshrc`ファイルを直接編集してプラグインを設定することも可能です。

```sh
# ~/.zshrc
plugins=(
  git
  docker
  aws
  npm
)
```

編集後は`omz reload`で変更を反映します。

---

## 5. 【STEP2-3】テーマ管理（外観のカスタマイズ）

> **業務フローでの位置**: プロンプトの外観をカスタマイズし、作業環境を視覚的に整えるステップです。

### 5.1 テーマ一覧の表示

利用可能なテーマの一覧を表示します。

```sh
omz theme list
```

現在適用中のテーマも確認できます。

### 5.2 テーマの一時適用（プレビュー）

テーマを一時的に適用して、外観を確認します（セッション終了後は元に戻ります）。

```sh
omz theme use <テーマ名>
```

例：agnosterテーマを試す
```sh
omz theme use agnoster
```

### 5.3 テーマの永続設定

気に入ったテーマを永続的に設定します。

```sh
omz theme set <テーマ名>
```

例：robbyrussellテーマを設定
```sh
omz theme set robbyrussell
```

**処理内容：**
1. `.zshrc`の`ZSH_THEME`変数を更新
2. zshセッションを自動で再読み込み

### 5.4 対話的テーマ選択ツール

複数のテーマを対話的にプレビューして選択できます。

```sh
~/.oh-my-zsh/tools/theme_chooser.sh
```

### 5.5 人気のテーマ

| テーマ名 | 説明 |
|---------|------|
| `robbyrussell` | デフォルトテーマ。シンプルで軽量 |
| `agnoster` | Powerline風のモダンなテーマ |
| `powerlevel10k` | 高機能でカスタマイズ性の高いテーマ（別途インストール要） |
| `avit` | 2行表示のミニマルなテーマ |
| `bira` | ユーザー情報とパスを表示 |

### 5.6 手動でのテーマ設定

`.zshrc`ファイルを直接編集してテーマを設定することも可能です。

```sh
# ~/.zshrc
ZSH_THEME="robbyrussell"
```

編集後は`omz reload`で変更を反映します。

---

## 6. 【STEP3-4】日常操作（ショートカット・エイリアス活用）

> **業務フローでの位置**: 日常的なターミナル操作で補完、履歴検索、エイリアスを活用するステップです。

### 6.1 コマンド補完機能

TABキーでコマンド、ファイル名、オプションを補完できます。

**基本的な補完：**
- コマンド入力後にTABキーを押す
- 複数の候補がある場合はリストが表示される
- 再度TABキーを押すと候補を選択できる

**補完の動作オプション（.zshrcで設定）：**

| オプション | 説明 |
|-----------|------|
| `CASE_SENSITIVE="true"` | 大文字小文字を区別する |
| `HYPHEN_INSENSITIVE="true"` | ハイフンとアンダースコアを区別しない |
| `COMPLETION_WAITING_DOTS="true"` | 補完処理中に「...」を表示 |

### 6.2 コマンド履歴検索

矢印キーまたはキーバインドで履歴を検索できます。

**履歴の操作：**

| キー | 動作 |
|-----|------|
| 上矢印 | 入力中の文字から始まるコマンドを上方向に検索 |
| 下矢印 | 入力中の文字から始まるコマンドを下方向に検索 |
| Ctrl+R | インクリメンタル履歴検索 |

**コマンド履歴の統計：**
```sh
zsh_stats
```
最も頻繁に使用したコマンドのTop20が表示されます。

### 6.3 便利なディレクトリ操作

| コマンド/エイリアス | 説明 |
|-------------------|------|
| `...` | 2つ上のディレクトリに移動（`cd ../..`） |
| `....` | 3つ上のディレクトリに移動（`cd ../../..`） |
| `cd -` | 直前のディレクトリに移動 |
| `d` | ディレクトリスタックを表示 |
| `1` - `9` | ディレクトリスタックの該当番号に移動 |
| `md <dir>` | ディレクトリを作成（`mkdir -p`） |
| `rd <dir>` | ディレクトリを削除（`rmdir`） |

### 6.4 ディレクトリ作成と移動

ディレクトリを作成して即座に移動する便利な関数があります。

```sh
mkcd <ディレクトリ名>
```

または

```sh
take <ディレクトリ名>
```

`take`関数はさらに以下の機能も持っています。
- URLを指定するとtarballをダウンロード・展開
- GitリポジトリURLを指定するとclone

### 6.5 クリップボード操作

クロスプラットフォーム対応のクリップボード関数を使用できます。

| 関数 | 説明 |
|-----|------|
| `clipcopy` | データをクリップボードにコピー |
| `clippaste` | クリップボードからデータを貼り付け |

例：ファイル内容をクリップボードにコピー
```sh
clipcopy < file.txt
```

例：クリップボードの内容をファイルに保存
```sh
clippaste > output.txt
```

### 6.6 ファイル/URL を開く

クロスプラットフォーム対応でファイルやURLを開くことができます。

```sh
open_command <ファイルまたはURL>
```

これはOSに応じて適切なコマンド（macOS: `open`、Linux: `xdg-open`、Windows: `start`）を使用します。

---

## 7. 【STEP4-5】更新・メンテナンス（管理者向け）

> **業務フローでの位置**: Oh My Zshを最新の状態に保ち、問題が発生した場合に対処するステップです。

### 7.1 手動更新

Oh My Zshを最新版に更新します。

```sh
omz update
```

**処理内容：**
1. GitHubから最新のコードを取得（git pull --rebase）
2. 変更履歴を表示
3. セッションを再読み込み

### 7.2 自動更新の設定

`.zshrc`で自動更新の動作を設定できます。

**更新モードの設定：**
```sh
zstyle ':omz:update' mode auto      # 自動更新
zstyle ':omz:update' mode prompt    # 更新前に確認
zstyle ':omz:update' mode reminder  # リマインダーのみ
zstyle ':omz:update' mode disabled  # 自動更新を無効化
```

**更新頻度の設定：**
```sh
zstyle ':omz:update' frequency 7    # 7日ごとにチェック
```

デフォルトは13日ごとです。

### 7.3 変更履歴の確認

特定のバージョンまでの変更履歴を確認できます。

```sh
omz changelog
```

または特定のバージョンを指定：
```sh
omz changelog <バージョン>
```

### 7.4 Pull Requestのテスト（開発者向け）

GitHubのPull Requestをローカルでテストできます。

```sh
omz pr test <PR番号>
```

テスト用にフェッチしたブランチを削除：
```sh
omz pr clean
```

### 7.5 診断情報の出力

トラブルシューティング用の診断情報を出力します。

```sh
omz_diagnostic_dump
```

出力される情報：
- Zshバージョン
- Oh My Zsh設定
- 有効なプラグイン・テーマ
- 環境変数
- キーバインド設定

---

## 8. Git統合機能

### 8.1 プロンプトでのGit情報表示

Oh My Zshは多くのテーマでGit情報をプロンプトに表示します。

**表示される情報：**
- 現在のブランチ名
- ダーティ/クリーン状態
- 未追跡ファイルの有無
- ahead/behind 状態

### 8.2 Git情報を取得する関数

プロンプトやスクリプトで使用できるGit関数があります。

| 関数 | 説明 |
|-----|------|
| `git_current_branch` | 現在のブランチ名を取得 |
| `git_previous_branch` | 直前のブランチ名を取得 |
| `git_prompt_info` | ブランチ名とステータスをフォーマット |
| `git_prompt_status` | ステータスアイコンを取得 |
| `parse_git_dirty` | ダーティ/クリーン状態を判定 |
| `git_commits_ahead` | リモートより先行しているコミット数 |
| `git_commits_behind` | リモートより遅れているコミット数 |

### 8.3 gitプラグインのエイリアス

gitプラグインを有効にすると、多数の便利なエイリアスが使用可能になります。

| エイリアス | コマンド |
|-----------|---------|
| `g` | `git` |
| `ga` | `git add` |
| `gaa` | `git add --all` |
| `gc` | `git commit -v` |
| `gco` | `git checkout` |
| `gd` | `git diff` |
| `gl` | `git pull` |
| `gp` | `git push` |
| `gst` | `git status` |
| `glog` | `git log --oneline --decorate --graph` |

すべてのエイリアスは`omz plugin info git`で確認できます。

---

## 9. ユーティリティ機能

### 9.1 URLエンコード・デコード

URLの安全なエンコード・デコードができます。

```sh
# エンコード
omz_urlencode "hello world"
# 出力: hello%20world

# デコード
omz_urldecode "hello%20world"
# 出力: hello world
```

### 9.2 変数のデフォルト値設定

変数が未定義の場合にデフォルト値を設定する関数があります。

```sh
default MY_VAR "default_value"
env_default MY_ENV_VAR "default_value"
```

### 9.3 256色パレットの確認

ターミナルで使用可能な256色を確認できます。

```sh
# フォアグラウンドカラーを表示
spectrum_ls

# バックグラウンドカラーを表示
spectrum_bls
```

### 9.4 ターミナルタイトルの設定

ターミナルのタイトルバーに情報を表示できます。この機能はデフォルトで有効です。

無効にする場合は`.zshrc`に以下を追加：
```sh
DISABLE_AUTO_TITLE="true"
```

---

## 10. 診断・トラブルシューティング機能

### 10.1 補完ファイルのセキュリティチェック

Oh My Zshは起動時に補完ファイルの権限を検証します。不正な権限がある場合は警告が表示されます。

警告を無効にする場合は`.zshrc`に以下を追加：
```sh
ZSH_DISABLE_COMPFIX=true
```

### 10.2 補完キャッシュのクリア

補完に問題がある場合は、キャッシュをクリアしてください。

```sh
omz reload
```

または手動でキャッシュを削除：
```sh
rm ~/.zcompdump*
```

---

## 11. 日常業務の流れ

本セクションでは、業務フローに沿った日常業務の流れを説明します。

```
業務フロー概要（再掲）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【STEP 1】プラグインの有効化・設定 → 4章参照
    ↓
【STEP 2】テーマの選択・適用 → 5章参照
    ↓
【STEP 3】日常操作での活用 → 6章参照
    ↓
【STEP 4】定期的な更新・メンテナンス → 7章参照
    ↓
【STEP 5】カスタム設定の追加（上級者向け）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

### 11.1 【一般ユーザー】STEP1: 必要なプラグインの有効化

業務開始時（初回セットアップ時）に、必要なプラグインを有効化します。

**やるべきこと：**
1. 使用するツール（Git、Docker、AWS等）を確認
2. 対応するプラグインを有効化

**システムでの操作手順：**
```sh
# 1. 利用可能なプラグインを確認
omz plugin list

# 2. 使用するプラグインの情報を確認
omz plugin info git
omz plugin info docker

# 3. プラグインを有効化
omz plugin enable git docker npm
```

### 11.2 【一般ユーザー】STEP2: テーマの選択

作業環境に合わせたテーマを選択・適用します。

**やるべきこと：**
1. 利用可能なテーマを確認
2. 好みのテーマを試してみる
3. 気に入ったテーマを設定

**システムでの操作手順：**
```sh
# 1. テーマ一覧を表示
omz theme list

# 2. テーマをプレビュー
omz theme use agnoster

# 3. 気に入ったテーマを永続設定
omz theme set agnoster
```

### 11.3 【一般ユーザー】STEP3: 日常操作での活用

日々のターミナル操作でOh My Zshの機能を活用します。

**活用シーン：**

**コマンド入力時：**
- TABキーで補完を活用
- 矢印キーで履歴を検索
- エイリアスで入力を省略

**Git作業時：**
- プロンプトでブランチ・ステータスを確認
- gitプラグインのエイリアスを活用

**ディレクトリ移動時：**
- `...`で2つ上に移動
- `d`でスタックを確認
- `take`で新規ディレクトリを作成して移動

### 11.4 【管理者】STEP4: 定期的な更新

定期的にOh My Zshを更新して最新の状態を保ちます。

**やるべきこと：**
1. 更新があるか確認
2. 更新を実行
3. 変更履歴を確認

**システムでの操作手順：**
```sh
# 1. 更新を実行
omz update

# 2. 変更履歴を確認
omz changelog
```

---

## 12. よくある質問と対処法

### 12.1 インストール・セットアップに関するQ&A

**Q: インストール後にプロンプトが変わらない**

A: 以下を確認してください。
1. デフォルトシェルがzshに変更されているか確認
   ```sh
   echo $SHELL
   ```
2. `.zshrc`が正しく設定されているか確認
3. ターミナルを完全に閉じて再起動

**Q: 既存の.zshrcを保持してインストールしたい**

A: 以下のコマンドを使用してください。
```sh
KEEP_ZSHRC=yes sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
```

### 12.2 プラグイン・テーマに関するQ&A

**Q: プラグインを有効化しても反映されない**

A: 以下を試してください。
1. `omz reload`でセッションを再読み込み
2. `.zshrc`の`plugins`配列に正しく追加されているか確認
3. プラグイン名のスペルを確認

**Q: テーマが正しく表示されない（文字化け）**

A: 以下を確認してください。
1. 対応フォント（Nerd Fonts、Powerline Fonts）がインストールされているか
2. ターミナルの文字コード設定がUTF-8になっているか

### 12.3 日常操作に関するQ&A

**Q: 補完が遅い**

A: 以下を試してください。
1. 有効なプラグイン数を減らす
2. 補完キャッシュをクリア
   ```sh
   rm ~/.zcompdump*
   omz reload
   ```

**Q: コマンド履歴が保存されない**

A: `.zshrc`で履歴設定を確認してください。
```sh
HISTFILE=~/.zsh_history
HISTSIZE=50000
SAVEHIST=10000
```

---

## 13. トラブルシューティング

### 13.1 エラーメッセージと対処法

| エラーメッセージ | 原因 | 対処法 |
|----------------|------|--------|
| `zsh: command not found: omz` | Oh My Zshが正しく読み込まれていない | `.zshrc`の`source $ZSH/oh-my-zsh.sh`を確認 |
| `Insecure completion-dependent directories detected` | 補完ディレクトリの権限が不正 | `compaudit`で確認し、権限を修正するか`ZSH_DISABLE_COMPFIX=true`を設定 |
| `plugin not found: xxx` | 指定したプラグインが存在しない | `omz plugin list`でプラグイン名を確認 |
| `theme not found: xxx` | 指定したテーマが存在しない | `omz theme list`でテーマ名を確認 |

### 13.2 よくあるトラブルと解決方法

**トラブル: zshの起動が遅い**

解決方法:
1. 有効なプラグイン数を確認し、不要なものを無効化
2. NVMなどの遅延初期化を設定
3. 非同期プロンプトを有効化
   ```sh
   zstyle ':omz:alpha:lib:git' async-prompt yes
   ```

**トラブル: Gitプロンプトが表示されない**

解決方法:
1. 現在のディレクトリがGitリポジトリか確認
2. テーマがGit情報を表示するか確認
3. gitプラグインが有効か確認

**トラブル: 更新後に問題が発生した**

解決方法:
1. 以前のバージョンに戻す
   ```sh
   cd $ZSH
   git reflog  # 以前のコミットを確認
   git checkout <コミットSHA>
   ```
2. 問題を報告（GitHub Issues）

### 13.3 サポートへの連絡方法

**GitHubでのサポート：**
- Issues: https://github.com/ohmyzsh/ohmyzsh/issues
- Discussions: https://github.com/ohmyzsh/ohmyzsh/discussions

**問題報告時に含める情報：**
1. `omz version`の出力
2. `zsh --version`の出力
3. 使用しているOS
4. 問題の再現手順
5. `omz_diagnostic_dump`の出力（可能であれば）

---

## 改訂履歴

| 版数 | 改訂日 | 改訂内容 |
|-----|--------|---------|
| 1.0 | 2026-02-18 | 初版作成 |

---

*本マニュアルは、Oh My Zshのエンドユーザー向け業務運用マニュアルです。*
*システムの更新により、コマンドや動作が変更される場合があります。*
