feat(i18n): Add Japanese (ja/) translation (#105)

- Translate all 101 markdown files: P1 core, all 10 modules, examples, auxiliary docs (CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, CLAUDE.md, etc.), peripheral docs (.github/, docs/, resources/, scripts/) - Translate comments and user-facing messages in 06-hooks/*.sh examples - Copy 05-mcp/*.json examples (standard JSON, no comments) - Update root README.md language switcher to include 日本語 - Add ja/TRANSLATION_NOTES.md (glossary + style guide) All translations pass pre-commit quality gates (markdown-lint, cross-references, mermaid-syntax, link-check, build-epub).
2026-04-30 07:16:46 +09:00
parent 32212292df
commit 1d1df9235b
118 changed files with 30380 additions and 3 deletions
--- a/ja/01-slash-commands/README.md
+++ b/ja/01-slash-commands/README.md
@@ -0,0 +1,618 @@
+<!-- i18n-source: 01-slash-commands/README.md -->
+<!-- i18n-source-sha: d17d515 -->
+<!-- i18n-date: 2026-04-27 -->
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="../../resources/logos/claude-howto-logo-dark.svg">
+  <img alt="Claude How To" src="../../resources/logos/claude-howto-logo.svg">
+</picture>
+
+# スラッシュコマンド
+
+## 概要
+
+スラッシュコマンドは、対話セッション中に Claude の動作を制御するためのショートカットである。次のようないくつかの種類がある:
+
+- **組み込みコマンド**: Claude Code が提供する（`/help`、`/clear`、`/model`）
+- **スキル**: ユーザーが `SKILL.md` ファイルとして定義するコマンド（`/optimize`、`/pr`）
+- **プラグインコマンド**: インストール済みプラグインから提供されるコマンド（`/frontend-design:frontend-design`）
+- **MCP プロンプト**: MCP サーバーから提供されるコマンド（`/mcp__github__list_prs`）
+
+> **注意**: カスタムスラッシュコマンドはスキルに統合された。`.claude/commands/` のファイルは引き続き動くが、現在は `.claude/skills/` のスキル方式が推奨である。どちらも `/command-name` のショートカットを作る。完全なリファレンスは [スキルガイド](../03-skills/) を参照。
+
+## 組み込みコマンドリファレンス
+
+組み込みコマンドはよく使うアクションのショートカットである。**60 種類以上の組み込みコマンド**と **5 つの同梱スキル**が利用できる。Claude Code 上で `/` をタイプすると一覧が出る。`/` の後に文字を続けるとフィルタできる。
+
+| コマンド | 用途 |
+|---------|------|
+| `/add-dir <path>` | 作業ディレクトリを追加 |
+| `/agents` | エージェント設定を管理 |
+| `/branch [name]` | 会話を分岐させて新しいセッションにする（エイリアス: `/fork`）。注: `/fork` は v2.1.77 で `/branch` に改名 |
+| `/btw <question>` | Claude がメインタスクを進めている間に、メイン会話のコンテキストを汚さず一時的なサイド質問をする |
+| `/chrome` | Chrome ブラウザ統合を設定 |
+| `/clear` | 会話をクリア（エイリアス: `/reset`、`/new`） |
+| `/color [color\|default]` | プロンプトバーの色を設定 |
+| `/compact [instructions]` | 任意のフォーカス指示を付けて会話を圧縮 |
+| `/config` | 設定を開く（エイリアス: `/settings`） |
+| `/context` | コンテキスト使用量をカラーグリッドで可視化 |
+| `/copy [N]` | アシスタントの応答をクリップボードにコピー。`w` でファイル書き出し |
+| `/cost` | `/usage` のタイピング用エイリアス — コストタブを開く（v2.1.118+） |
+| `/desktop` | Desktop アプリで継続（エイリアス: `/app`） |
+| `/diff` | 未コミット変更のインタラクティブ差分ビューア |
+| `/doctor` | インストール状態を診断 — Claude が応答中でも開ける。ステータスアイコンを表示。`f` で問題を自動修正（v2.1.116 で強化） |
+| `/effort [low\|medium\|high\|xhigh\|max\|auto]` | 矢印キーのスライダーで思考量を設定。レベル: `low` → `medium` → `high` → `xhigh`（v2.1.111 で追加）→ `max`。Opus 4.7 のデフォルトは `xhigh`、`max` は Opus 4.7 が必要 |
+| `/exit` | REPL を終了（エイリアス: `/quit`） |
+| `/export [filename]` | 現在の会話をファイルまたはクリップボードにエクスポート |
+| `/extra-usage` | レート制限の追加使用量を設定 |
+| `/fast [on\|off]` | 高速モードを切り替え |
+| `/feedback` | フィードバックを送信（エイリアス: `/bug`） |
+| `/focus` | フォーカスビューを切り替え（v2.1.110 で追加。フォーカス切替は `Ctrl+O` から本コマンドへ移行） |
+| `/help` | ヘルプを表示 |
+| `/hooks` | フック設定を表示 |
+| `/ide` | IDE 統合を管理 |
+| `/init` | `CLAUDE.md` を初期化。インタラクティブフローには `CLAUDE_CODE_NEW_INIT=1` を設定 |
+| `/insights` | セッション分析レポートを生成 |
+| `/install-github-app` | GitHub Actions アプリをセットアップ |
+| `/install-slack-app` | Slack アプリをインストール |
+| `/keybindings` | キーバインド設定を開く |
+| `/less-permission-prompts` | 直近の Bash／MCP ツール呼び出しを分析し、優先度の高い許可リストを `.claude/settings.json` に追加して権限プロンプトを減らす（v2.1.111 で追加） |
+| `/login` | Anthropic アカウントを切り替え |
+| `/logout` | Anthropic アカウントからサインアウト |
+| `/mcp` | MCP サーバーと OAuth を管理 |
+| `/memory` | `CLAUDE.md` を編集、自動メモリを切り替え |
+| `/mobile` | モバイルアプリの QR コード（エイリアス: `/ios`、`/android`） |
+| `/model [model]` | モデル選択。左右キーで思考量を変更 |
+| `/passes` | Claude Code 無料 1 週間を共有 |
+| `/permissions` | 権限を表示／更新（エイリアス: `/allowed-tools`） |
+| `/plan [description]` | プランモードに入る |
+| `/plugin` | プラグインを管理 |
+| `/proactive` | `/loop` のエイリアス（v2.1.105 で追加） |
+| `/powerup` | アニメーション付きデモのインタラクティブレッスンで機能を発見 |
+| `/privacy-settings` | プライバシー設定（Pro／Max のみ） |
+| `/release-notes` | 変更履歴を表示 |
+| `/recap` | セッションへ戻ってきた際にセッションのおさらい／要約を表示（v2.1.108 で追加） |
+| `/reload-plugins` | アクティブなプラグインをリロード |
+| `/remote-control` | claude.ai からのリモート制御（エイリアス: `/rc`） |
+| `/remote-env` | デフォルトのリモート環境を設定 |
+| `/rename [name]` | セッションをリネーム |
+| `/resume [session]` | 会話を再開（エイリアス: `/continue`） |
+| `/review` | **非推奨** — 代わりに `code-review` プラグインを導入する |
+| `/rewind` | 会話やコードを巻き戻す（エイリアス: `/checkpoint`） |
+| `/sandbox` | サンドボックスモードを切り替え |
+| `/schedule [description]` | クラウドのスケジュールタスクを作成／管理 |
+| `/security-review` | ブランチをセキュリティ脆弱性の観点で分析 |
+| `/skills` | 利用可能なスキルを一覧表示 |
+| `/stats` | `/usage` のタイピング用エイリアス — 統計タブ（日次使用量、セッション、ストリーク）を開く（v2.1.118+） |
+| `/stickers` | Claude Code のステッカーを注文 |
+| `/status` | バージョン、モデル、アカウントを表示 |
+| `/statusline` | ステータスラインを設定 |
+| `/tasks` | バックグラウンドタスクを一覧／管理 |
+| `/team-onboarding` | プロジェクトの Claude Code 設定からチームメイト向けランプアップガイドを生成（v2.1.101 で新規） |
+| `/terminal-setup` | ターミナルのキーバインドを設定 |
+| `/theme` | テーマピッカーを開く／カスタムテーマを管理（v2.1.118）。カスタムテーマは `~/.claude/themes/<name>.json` に JSON で定義 |
+| `/tui` | ちらつきのないフルスクリーン TUI（テキストユーザーインターフェース）モードを切り替え（v2.1.110 で追加） |
+| `/ultraplan <prompt>` | ultraplan セッションでプランを下書きし、ブラウザでレビュー |
+| `/ultrareview` | マルチエージェント分析による包括的なクラウドベースのコードレビュー（v2.1.111 で追加） |
+| `/undo` | `/rewind` のエイリアス（v2.1.108 で追加） |
+| `/upgrade` | 上位プランへのアップグレードページを開く |
+| `/usage` | 正式な使用状況ダッシュボード（v2.1.118）— プラン使用量制限、レート制限、コスト、日次セッション統計を統合。`/cost` と `/stats` は特定のタブを開くタイピング用エイリアス |
+| `/voice` | プッシュトゥトーク音声入力を切り替え |
+
+### 同梱スキル
+
+これらのスキルは Claude Code に同梱され、スラッシュコマンドのように呼び出せる:
+
+| スキル | 用途 |
+|-------|------|
+| `/batch <instruction>` | ワークツリーを使った大規模並列変更をオーケストレートする |
+| `/claude-api` | プロジェクトの言語に応じた Claude API リファレンスを読み込む |
+| `/debug [description]` | デバッグログを有効化 |
+| `/loop [interval] <prompt>` | プロンプトを定期的に繰り返し実行 |
+| `/simplify [focus]` | 変更されたファイルをコード品質の観点でレビュー |
+
+### 非推奨コマンド
+
+| コマンド | ステータス |
+|---------|----------|
+| `/review` | 非推奨 — `code-review` プラグインに置き換え |
+| `/output-style` | v2.1.73 から非推奨 |
+| `/fork` | `/branch` に改名（エイリアスは引き続き有効、v2.1.77） |
+| `/pr-comments` | v2.1.91 で削除 — Claude に直接 PR コメントを見るよう依頼する |
+| `/vim` | v2.1.92 で削除 — /config → エディタモードを使う |
+
+### 直近の変更点
+
+- `/fork` を `/branch` に改名し、`/fork` はエイリアスとして残置（v2.1.77）
+- `/output-style` を非推奨化（v2.1.73）
+- `/review` を非推奨化、`code-review` プラグインを推奨
+- `/effort` コマンドを追加。`max` レベルは Opus 4.7 が必要（当初は Opus 4.6 限定）
+- プッシュトゥトーク音声入力の `/voice` コマンドを追加
+- スケジュールタスクの作成／管理用の `/schedule` コマンドを追加
+- プロンプトバーをカスタマイズする `/color` コマンドを追加
+- /pr-comments を v2.1.91 で削除 — Claude に直接 PR コメントを見るよう依頼する
+- /vim を v2.1.92 で削除 — /config → エディタモードを使う
+- ブラウザベースのプランレビューと実行を行う /ultraplan を追加
+- インタラクティブな機能レッスン用に /powerup を追加
+- サンドボックスモード切替用に /sandbox を追加
+- `/model` ピッカーが、生のモデル ID ではなく可読ラベル（例: "Sonnet 4.6"）を表示するようになった
+- `/resume` が `/continue` エイリアスに対応
+- MCP プロンプトが `/mcp__<server>__<prompt>` コマンドとして利用可能（[MCP プロンプトをコマンドとして使う](#mcp-プロンプトをコマンドとして使う) を参照）
+- チームメイト向けランプアップガイドを自動生成する `/team-onboarding` を追加（v2.1.101）
+- ちらつきのないフルスクリーン TUI 描画用に `/tui` コマンドを追加（v2.1.110）
+- フォーカスビュー切替用に `/focus` コマンドを追加。`Ctrl+O` は詳細トランスクリプトの切替のみに（v2.1.110）
+- セッションコンテキストのおさらいを手動で発火する `/recap` コマンドを追加（v2.1.108）
+- `/undo` を `/rewind` のエイリアスとして追加（v2.1.108）
+- `/proactive` を `/loop` のエイリアスとして追加（v2.1.105）
+- `/effort` がインタラクティブな矢印キースライダーを獲得し、`high` と `max` の間に新しい `xhigh` レベルを追加。Opus 4.7 プランではデフォルト思考量が `xhigh` に引き上げられた（v2.1.111）
+- 包括的なクラウドベースのマルチエージェントコードレビュー用に `/ultrareview` を追加（v2.1.111）
+- Bash／MCP ツール呼び出しを分析し、`.claude/settings.json` の許可リストで権限プロンプトを減らす `/less-permission-prompts` を追加（v2.1.111）
+- Opus 4.7 を利用する Max サブスクライバについて、Auto モードに `--enable-auto-mode` フラグが不要になった（v2.1.112）
+
+### `/team-onboarding` — チームメイト向けランプアップガイド
+
+> **v2.1.101 で新規追加**
+
+`/team-onboarding` を使うと、プロジェクトのローカルな Claude Code 利用状況からチームメイト向けランプアップガイドを生成できる。コマンドは `CLAUDE.md`、インストール済みのスキル、サブエージェント、フック、最近のワークフローを点検し、新しい開発者がすぐに生産的になれるオンボーディングドキュメントを作成する。
+
+組み込みコマンドであり、インストール作業は不要である。
+
+**使い方:**
+
+```bash
+claude /team-onboarding
+```
+
+生成されるガイドは次の内容を要約する:
+
+- [`CLAUDE.md`](../02-memory/README.md) からのプロジェクトの目的と主な慣習
+- 利用可能な [スキル](../03-skills/README.md) と自動起動の条件
+- 設定済みの [サブエージェント](../04-subagents/README.md) とその責務
+- 一般的なイベントで実行される [フック](../06-hooks/README.md)
+- 新規参加者が知っておくべき共通ワークフロー
+
+**提供開始:** Claude Code v2.1.101（2026 年 4 月 11 日）に同梱。
+
+## カスタムコマンド（現在はスキル）
+
+カスタムスラッシュコマンドは **スキルに統合された**。どちらの方式でも `/command-name` で呼び出せるコマンドを作成できる:
+
+| 方式 | 配置場所 | ステータス |
+|------|---------|----------|
+| **スキル（推奨）** | `.claude/skills/<name>/SKILL.md` | 現行標準 |
+| **レガシーコマンド** | `.claude/commands/<name>.md` | 引き続き動作 |
+
+スキルとコマンドが同じ名前で存在する場合、**スキルが優先される**。例えば `.claude/commands/review.md` と `.claude/skills/review/SKILL.md` の両方が存在すれば、スキル版が使われる。
+
+### 移行パス
+
+既存の `.claude/commands/` のファイルは、変更なしで動作し続ける。スキルへ移行するには:
+
+**変更前（コマンド）:**
+```
+.claude/commands/optimize.md
+```
+
+**変更後（スキル）:**
+```
+.claude/skills/optimize/SKILL.md
+```
+
+### なぜスキルなのか
+
+スキルはレガシーコマンドにはない次の機能を提供する:
+
+- **ディレクトリ構造**: スクリプト、テンプレート、参照ファイルをまとめられる
+- **自動起動**: 関連性があるとき Claude が自動でスキルを発動できる
+- **起動制御**: ユーザー、Claude、両者のうち誰が起動できるかを選べる
+- **サブエージェント実行**: `context: fork` で隔離されたコンテキストでスキルを実行できる
+- **段階的開示**: 必要なときだけ追加ファイルをロードする
+
+### スキルとしてカスタムコマンドを作成する
+
+`SKILL.md` を含むディレクトリを作る:
+
+```bash
+mkdir -p .claude/skills/my-command
+```
+
+**ファイル:** `.claude/skills/my-command/SKILL.md`
+
+```yaml
+---
+name: my-command
+description: What this command does and when to use it
+---
+
+# My Command
+
+Instructions for Claude to follow when this command is invoked.
+
+1. First step
+2. Second step
+3. Third step
+```
+
+### フロントマターリファレンス
+
+| フィールド | 用途 | デフォルト |
+|----------|------|----------|
+| `name` | コマンド名（`/name` になる） | ディレクトリ名 |
+| `description` | 簡単な説明（Claude がいつ使うか判断する材料） | 最初の段落 |
+| `argument-hint` | 自動補完用の想定引数 | なし |
+| `allowed-tools` | 権限なしで使えるツール | 継承 |
+| `model` | 使用する特定のモデル | 継承 |
+| `disable-model-invocation` | `true` ならユーザーのみ起動可（Claude は不可） | `false` |
+| `user-invocable` | `false` なら `/` メニューから隠す | `true` |
+| `context` | `fork` に設定すると隔離サブエージェントで実行 | なし |
+| `agent` | `context: fork` 利用時のエージェント種別 | `general-purpose` |
+| `hooks` | スキルスコープのフック（PreToolUse、PostToolUse、Stop） | なし |
+
+### 引数
+
+コマンドは引数を受け取れる:
+
+**`$ARGUMENTS` で全引数を受ける:**
+
+```yaml
+---
+name: fix-issue
+description: Fix a GitHub issue by number
+---
+
+Fix issue #$ARGUMENTS following our coding standards
+```
+
+使い方: `/fix-issue 123` → `$ARGUMENTS` は "123" になる
+
+**個別引数を `$0`、`$1` などで受ける:**
+
+```yaml
+---
+name: review-pr
+description: Review a PR with priority
+---
+
+Review PR #$0 with priority $1
+```
+
+使い方: `/review-pr 456 high` → `$0`="456"、`$1`="high"
+
+### シェルコマンドによる動的コンテキスト
+
+プロンプトの前に `!`command`` で bash コマンドを実行する:
+
+```yaml
+---
+name: commit
+description: Create a git commit with context
+allowed-tools: Bash(git *)
+---
+
+## Context
+
+- Current git status: !`git status`
+- Current git diff: !`git diff HEAD`
+- Current branch: !`git branch --show-current`
+- Recent commits: !`git log --oneline -5`
+
+## Your task
+
+Based on the above changes, create a single git commit.
+```
+
+### ファイル参照
+
+`@` でファイル内容を埋め込む:
+
+```markdown
+Review the implementation in @src/utils/helpers.js
+Compare @src/old-version.js with @src/new-version.js
+```
+
+## プラグインコマンド
+
+プラグインはカスタムコマンドを提供できる:
+
+```
+/plugin-name:command-name
+```
+
+または、名前衝突がない場合はシンプルに `/command-name`。
+
+**例:**
+```bash
+/frontend-design:frontend-design
+/commit-commands:commit
+```
+
+## MCP プロンプトをコマンドとして使う
+
+MCP サーバーはプロンプトをスラッシュコマンドとして公開できる:
+
+```
+/mcp__<server-name>__<prompt-name> [arguments]
+```
+
+**例:**
+```bash
+/mcp__github__list_prs
+/mcp__github__pr_review 456
+/mcp__jira__create_issue "Bug title" high
+```
+
+### MCP 権限の構文
+
+権限設定で MCP サーバーへのアクセスを制御する:
+
+- `mcp__github` — GitHub MCP サーバー全体にアクセス
+- `mcp__github__*` — すべてのツールにワイルドカードアクセス
+- `mcp__github__get_issue` — 特定のツールにアクセス
+
+## コマンドアーキテクチャ
+
+```mermaid
+graph TD
+    A["User Input: /command-name"] --> B{"Command Type?"}
+    B -->|Built-in| C["Execute Built-in"]
+    B -->|Skill| D["Load SKILL.md"]
+    B -->|Plugin| E["Load Plugin Command"]
+    B -->|MCP| F["Execute MCP Prompt"]
+
+    D --> G["Parse Frontmatter"]
+    G --> H["Substitute Variables"]
+    H --> I["Execute Shell Commands"]
+    I --> J["Send to Claude"]
+    J --> K["Return Results"]
+```
+
+## コマンドのライフサイクル
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant Claude as Claude Code
+    participant FS as File System
+    participant CLI as Shell/Bash
+
+    User->>Claude: Types /optimize
+    Claude->>FS: Searches .claude/skills/ and .claude/commands/
+    FS-->>Claude: Returns optimize/SKILL.md
+    Claude->>Claude: Parses frontmatter
+    Claude->>CLI: Executes !`command` substitutions
+    CLI-->>Claude: Command outputs
+    Claude->>Claude: Substitutes $ARGUMENTS
+    Claude->>User: Processes prompt
+    Claude->>User: Returns results
+```
+
+## このフォルダで提供するコマンド
+
+これらのサンプルコマンドは、スキルとしても、レガシーコマンドとしてもインストールできる。
+
+### 1. `/optimize` — コード最適化
+
+パフォーマンス上の問題、メモリリーク、最適化の余地を分析する。
+
+**使い方:**
+```
+/optimize
+[Paste your code]
+```
+
+### 2. `/pr` — プルリクエスト準備
+
+リント、テスト、コミットメッセージのフォーマットなど、PR 準備チェックリストを案内する。
+
+**使い方:**
+```
+/pr
+```
+
+**スクリーンショット:**
+![/pr](pr-slash-command.png)
+
+### 3. `/generate-api-docs` — API ドキュメント生成
+
+ソースコードから網羅的な API ドキュメントを生成する。
+
+**使い方:**
+```
+/generate-api-docs
+```
+
+### 4. `/commit` — コンテキスト付き git コミット
+
+リポジトリの動的コンテキストを含めて git コミットを作成する。
+
+**使い方:**
+```
+/commit [optional message]
+```
+
+### 5. `/push-all` — ステージ・コミット・push
+
+全変更をステージングし、コミットを作成し、安全性チェックを行ってリモートへ push する。
+
+**使い方:**
+```
+/push-all
+```
+
+**安全性チェック:**
+- シークレット: `.env*`、`*.key`、`*.pem`、`credentials.json`
+- API キー: 実キーかプレースホルダかを判別
+- 大きなファイル: Git LFS なしの `>10MB`
+- ビルド成果物: `node_modules/`、`dist/`、`__pycache__/`
+
+### 6. `/doc-refactor` — ドキュメント再構成
+
+プロジェクトドキュメントを明瞭性とアクセシビリティの観点で再構成する。
+
+**使い方:**
+```
+/doc-refactor
+```
+
+### 7. `/setup-ci-cd` — CI/CD パイプライン設定
+
+品質保証のために pre-commit フックと GitHub Actions を導入する。
+
+**使い方:**
+```
+/setup-ci-cd
+```
+
+### 8. `/unit-test-expand` — テストカバレッジ拡充
+
+未テストの分岐とエッジケースを狙ってテストカバレッジを高める。
+
+**使い方:**
+```
+/unit-test-expand
+```
+
+## インストール
+
+### スキルとして（推奨）
+
+スキルディレクトリにコピーする:
+
+```bash
+# skills ディレクトリを作成
+mkdir -p .claude/skills
+
+# 各コマンドファイルごとにスキルディレクトリを作成
+for cmd in optimize pr commit; do
+  mkdir -p .claude/skills/$cmd
+  cp 01-slash-commands/$cmd.md .claude/skills/$cmd/SKILL.md
+done
+```
+
+### レガシーコマンドとして
+
+commands ディレクトリにコピーする:
+
+```bash
+# プロジェクト全体（チーム向け）
+mkdir -p .claude/commands
+cp 01-slash-commands/*.md .claude/commands/
+
+# 個人利用
+mkdir -p ~/.claude/commands
+cp 01-slash-commands/*.md ~/.claude/commands/
+```
+
+## 自前のコマンドを作る
+
+### スキルテンプレート（推奨）
+
+`.claude/skills/my-command/SKILL.md` を作成する:
+
+```yaml
+---
+name: my-command
+description: What this command does. Use when [trigger conditions].
+argument-hint: [optional-args]
+allowed-tools: Bash(npm *), Read, Grep
+---
+
+# Command Title
+
+## Context
+
+- Current branch: !`git branch --show-current`
+- Related files: @package.json
+
+## Instructions
+
+1. First step
+2. Second step with argument: $ARGUMENTS
+3. Third step
+
+## Output Format
+
+- How to format the response
+- What to include
+```
+
+### ユーザーのみが起動可能なコマンド（自動起動なし）
+
+副作用があり、Claude に自動で発火させたくないコマンド向け:
+
+```yaml
+---
+name: deploy
+description: Deploy to production
+disable-model-invocation: true
+allowed-tools: Bash(npm *), Bash(git *)
+---
+
+Deploy the application to production:
+
+1. Run tests
+2. Build application
+3. Push to deployment target
+4. Verify deployment
+```
+
+## ベストプラクティス
+
+| やる | やらない |
+|------|---------|
+| 動詞中心の明確な名前を使う | 一回限りのタスクをコマンドにする |
+| 起動条件付きの `description` を含める | コマンド内に複雑なロジックを組む |
+| 単一タスクに絞ったコマンドにする | 機微情報をハードコードする |
+| 副作用がある場合は `disable-model-invocation` を使う | description フィールドを省く |
+| 動的コンテキストには `!` プレフィックスを使う | Claude が現在の状態を知っている前提にする |
+| 関連ファイルはスキルディレクトリで整理する | すべてを 1 ファイルに詰め込む |
+
+## トラブルシューティング
+
+### コマンドが見つからない
+
+**対処:**
+- ファイルが `.claude/skills/<name>/SKILL.md` または `.claude/commands/<name>.md` に置かれているか確認
+- フロントマターの `name` フィールドが期待するコマンド名と一致するか確認
+- Claude Code セッションを再起動
+- `/help` で利用可能なコマンドを確認
+
+### コマンドが期待通りに動かない
+
+**対処:**
+- 指示をより具体的にする
+- スキルファイルに例を含める
+- bash コマンドを使う場合は `allowed-tools` を確認
+- まずは単純な入力でテストする
+
+### スキルとコマンドが衝突する
+
+同じ名前で両方が存在する場合、**スキルが優先される**。どちらかを削除またはリネームする。
+
+## 関連ガイド
+
+- **[スキル](../03-skills/)** — スキルの完全リファレンス（自動起動される機能）
+- **[メモリ](../02-memory/)** — CLAUDE.md による永続コンテキスト
+- **[サブエージェント](../04-subagents/)** — 委任型 AI エージェント
+- **[プラグイン](../07-plugins/)** — まとめられたコマンド集
+- **[フック](../06-hooks/)** — イベント駆動の自動化
+
+## 追加のリソース
+
+- [公式インタラクティブモードドキュメント](https://code.claude.com/docs/en/interactive-mode) — 組み込みコマンドリファレンス
+- [公式スキルドキュメント](https://code.claude.com/docs/en/skills) — スキルの完全リファレンス
+- [CLI リファレンス](https://code.claude.com/docs/en/cli-reference) — コマンドラインオプション
+
+---
+
+**Last Updated**: April 24, 2026
+**Claude Code Version**: 2.1.119
+**Sources**:
+- https://code.claude.com/docs/en/slash-commands
+- https://code.claude.com/docs/en/interactive-mode
+- https://code.claude.com/docs/en/changelog
+- https://github.com/anthropics/claude-code/releases/tag/v2.1.118
+- https://github.com/anthropics/claude-code/releases/tag/v2.1.116
+**Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5
+
+*[Claude How To](../) ガイドシリーズの一部*
--- a/ja/01-slash-commands/commit.md
+++ b/ja/01-slash-commands/commit.md
@@ -0,0 +1,33 @@
+<!-- i18n-source: 01-slash-commands/commit.md -->
+<!-- i18n-source-sha: 7f2e773 -->
+<!-- i18n-date: 2026-04-27 -->
+
+---
+allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*), Bash(git diff:*)
+argument-hint: [message]
+description: コンテキスト付きで git コミットを作成する
+---
+
+## コンテキスト
+
+- 現在の git ステータス: !`git status`
+- 現在の git 差分: !`git diff HEAD`
+- 現在のブランチ: !`git branch --show-current`
+- 直近のコミット: !`git log --oneline -10`
+
+## タスク
+
+上記の変更内容に基づいて、単一の git コミットを作成する。
+
+引数でメッセージが指定された場合はそれを使う: $ARGUMENTS
+
+そうでない場合は、変更内容を分析し、Conventional Commits 形式に従って適切なコミットメッセージを作成する:
+- `feat:` 新機能
+- `fix:` バグ修正
+- `docs:` ドキュメント変更
+- `refactor:` コードのリファクタリング
+- `test:` テスト追加
+- `chore:` メンテナンスタスク
+
+---
+**Last Updated**: April 9, 2026
--- a/ja/01-slash-commands/doc-refactor.md
+++ b/ja/01-slash-commands/doc-refactor.md
@@ -0,0 +1,31 @@
+<!-- i18n-source: 01-slash-commands/doc-refactor.md -->
+<!-- i18n-source-sha: 7f2e773 -->
+<!-- i18n-date: 2026-04-27 -->
+
+---
+name: Documentation Refactor
+description: プロジェクトドキュメントを再構成して明瞭性とアクセシビリティを高める
+tags: documentation, refactoring, organization
+---
+
+# ドキュメントリファクタリング
+
+プロジェクトの種類に合わせてドキュメント構造をリファクタリングする:
+
+1. **プロジェクトを分析**: 種類（ライブラリ／API／Web アプリ／CLI／マイクロサービス）、アーキテクチャ、ユーザーペルソナを特定する
+2. **ドキュメントを集約**: 技術ドキュメントを `docs/` に移動し、適切な相互参照を整える
+3. **ルート README.md**: 概要、クイックスタート、モジュール／コンポーネントのサマリ、ライセンス、連絡先を含むエントリーポイントとして整理する
+4. **コンポーネント別ドキュメント**: モジュール／パッケージ／サービス単位の README ファイルを追加し、セットアップとテスト手順を記載する
+5. **`docs/` を関連カテゴリで整理する**:
+   - Architecture、API Reference、Database、Design、Troubleshooting、Deployment、Contributing（プロジェクトの必要に応じて調整）
+6. **ガイドを作成する**（該当するものを選ぶ）:
+   - User Guide: アプリケーションのエンドユーザー向けドキュメント
+   - API Documentation: API のエンドポイント、認証、サンプル
+   - Development Guide: セットアップ、テスト、コントリビューションのワークフロー
+   - Deployment Guide: サービス／アプリの本番デプロイ
+7. **すべての図に Mermaid を使う**（アーキテクチャ、フロー、スキーマ）
+
+ドキュメントは簡潔に、流し読みしやすく、プロジェクトの種類に即した内容に保つ。
+
+---
+**Last Updated**: April 9, 2026
--- a/ja/01-slash-commands/generate-api-docs.md
+++ b/ja/01-slash-commands/generate-api-docs.md
@@ -0,0 +1,26 @@
+<!-- i18n-source: 01-slash-commands/generate-api-docs.md -->
+<!-- i18n-source-sha: 7f2e773 -->
+<!-- i18n-date: 2026-04-27 -->
+
+---
+description: ソースコードから網羅的な API ドキュメントを生成する
+---
+
+# API ドキュメント生成
+
+次の手順で API ドキュメントを生成する:
+
+1. `/src/api/` 配下の全ファイルをスキャンする
+2. 関数シグネチャと JSDoc コメントを抽出する
+3. エンドポイント／モジュール単位で整理する
+4. サンプル付きの Markdown を作成する
+5. リクエスト／レスポンスのスキーマを含める
+6. エラーに関するドキュメントを追加する
+
+出力形式:
+- `/docs/api.md` に Markdown ファイルとして出力
+- 全エンドポイントについて curl のサンプルを含める
+- TypeScript の型定義を追加する
+
+---
+**Last Updated**: April 9, 2026
--- a/ja/01-slash-commands/optimize.md
+++ b/ja/01-slash-commands/optimize.md
@@ -0,0 +1,26 @@
+<!-- i18n-source: 01-slash-commands/optimize.md -->
+<!-- i18n-source-sha: 7f2e773 -->
+<!-- i18n-date: 2026-04-27 -->
+
+---
+description: コードのパフォーマンス上の問題を分析し、最適化案を提示する
+---
+
+# コード最適化
+
+提示されたコードについて、優先度の高い順に以下の項目をレビューする:
+
+1. **パフォーマンスのボトルネック** — O(n²) の処理や非効率なループを特定する
+2. **メモリリーク** — 解放されていないリソースや循環参照を発見する
+3. **アルゴリズムの改善** — より良いアルゴリズムやデータ構造を提案する
+4. **キャッシュ可能な箇所** — 繰り返される計算を特定する
+5. **並行性の問題** — 競合状態やスレッディングの問題を発見する
+
+回答は次の形式でまとめる:
+- 問題の重大度（Critical／High／Medium／Low）
+- コード上の該当箇所
+- 説明
+- 推奨される修正案とコード例
+
+---
+**Last Updated**: April 9, 2026
--- a/ja/01-slash-commands/pr.md
+++ b/ja/01-slash-commands/pr.md
@@ -0,0 +1,33 @@
+<!-- i18n-source: 01-slash-commands/pr.md -->
+<!-- i18n-source-sha: 7f2e773 -->
+<!-- i18n-date: 2026-04-27 -->
+
+---
+description: コードを整え、変更をステージングし、プルリクエストを準備する
+allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git diff:*), Bash(npm test:*), Bash(npm run lint:*)
+---
+
+# プルリクエスト準備チェックリスト
+
+PR を作成する前に、以下のステップを実行する:
+
+1. リンタ実行: `prettier --write .`
+2. テスト実行: `npm test`
+3. git 差分のレビュー: `git diff HEAD`
+4. 変更をステージング: `git add .`
+5. Conventional Commits に従ったコミットメッセージを作成する:
+   - `fix:` バグ修正
+   - `feat:` 新機能
+   - `docs:` ドキュメント
+   - `refactor:` コード再構成
+   - `test:` テスト追加
+   - `chore:` メンテナンス
+
+6. PR サマリを生成する。次の項目を含める:
+   - 何を変更したか
+   - なぜ変更したか
+   - 実施したテスト
+   - 想定される影響
+
+---
+**Last Updated**: April 9, 2026
--- a/ja/01-slash-commands/push-all.md
+++ b/ja/01-slash-commands/push-all.md
@@ -0,0 +1,160 @@
+<!-- i18n-source: 01-slash-commands/push-all.md -->
+<!-- i18n-source-sha: 7f2e773 -->
+<!-- i18n-date: 2026-04-27 -->
+
+---
+description: 全変更をステージング、コミット、リモートへ push する（取り扱い注意）
+allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*), Bash(git push:*), Bash(git diff:*), Bash(git log:*), Bash(git pull:*)
+---
+
+# すべてをコミット・push する
+
+⚠️ **注意**: すべての変更をステージング・コミットし、リモートへ push する。すべての変更がひとまとまりであると確信できる場合のみ使うこと。
+
+## ワークフロー
+
+### 1. 変更を分析
+
+並列で実行する:
+- `git status` — 変更／追加／削除／追跡外ファイルを表示
+- `git diff --stat` — 変更統計を表示
+- `git log -1 --oneline` — メッセージスタイル参考のため直近のコミットを表示
+
+### 2. 安全性チェック
+
+**❌ 検出時は STOP し WARN を出すべき項目:**
+- シークレット: `.env*`、`*.key`、`*.pem`、`credentials.json`、`secrets.yaml`、`id_rsa`、`*.p12`、`*.pfx`、`*.cer`
+- API キー: `*_API_KEY`、`*_SECRET`、`*_TOKEN` などの変数で実値が入っているもの（`your-api-key`、`xxx`、`placeholder` などのプレースホルダではないもの）
+- 大きなファイル: Git LFS なしの `>10MB`
+- ビルド成果物: `node_modules/`、`dist/`、`build/`、`__pycache__/`、`*.pyc`、`.venv/`
+- 一時ファイル: `.DS_Store`、`thumbs.db`、`*.swp`、`*.tmp`
+
+**API キー検証:**
+変更ファイルに以下のようなパターンがないか確認する:
+```bash
+OPENAI_API_KEY=sk-proj-xxxxx  # ❌ 実キーを検出！
+AWS_SECRET_KEY=AKIA...         # ❌ 実キーを検出！
+STRIPE_API_KEY=sk_live_...    # ❌ 実キーを検出！
+
+# ✅ 許容されるプレースホルダ:
+API_KEY=your-api-key-here
+SECRET_KEY=placeholder
+TOKEN=xxx
+API_KEY=<your-key>
+SECRET=${YOUR_SECRET}
+```
+
+**✅ 確認事項:**
+- `.gitignore` が適切に設定されている
+- マージ競合がない
+- 正しいブランチである（main／master の場合は警告）
+- API キーはプレースホルダのみ
+
+### 3. 確認を求める
+
+サマリを提示する:
+```
+📊 Changes Summary:
+- X files modified, Y added, Z deleted
+- Total: +AAA insertions, -BBB deletions
+
+🔒 Safety: ✅ No secrets | ✅ No large files | ⚠️ [warnings]
+🌿 Branch: [name] → origin/[name]
+
+I will: git add . → commit → push
+
+Type 'yes' to proceed or 'no' to cancel.
+```
+
+**明示的な "yes" を待ってから先へ進む。**
+
+### 4. 実行（確認後）
+
+順番に実行する:
+```bash
+git add .
+git status  # ステージングを確認
+```
+
+### 5. コミットメッセージを生成
+
+変更を分析し、Conventional Commits 形式のコミットを作成する:
+
+**形式:**
+```
+[type]: Brief summary (max 72 characters)
+
+- Key change 1
+- Key change 2
+- Key change 3
+```
+
+**Types:** `feat`、`fix`、`docs`、`style`、`refactor`、`test`、`chore`、`perf`、`build`、`ci`
+
+**例:**
+```
+docs: Update concept README files with comprehensive documentation
+
+- Add architecture diagrams and tables
+- Include practical examples
+- Expand best practices sections
+```
+
+### 6. コミットと push
+
+```bash
+git commit -m "$(cat <<'EOF'
+[Generated commit message]
+EOF
+)"
+git push  # 失敗時: git pull --rebase && git push
+git log -1 --oneline --decorate  # 確認
+```
+
+### 7. 成功を通知
+
+```
+✅ Successfully pushed to remote!
+
+Commit: [hash] [message]
+Branch: [branch] → origin/[branch]
+Files changed: X (+insertions, -deletions)
+```
+
+## エラーハンドリング
+
+- **git add 失敗**: 権限、ロックされたファイル、リポジトリ初期化済みかを確認
+- **git commit 失敗**: pre-commit フックを修正、git config（user.name／email）を確認
+- **git push 失敗**:
+  - non-fast-forward: `git pull --rebase && git push`
+  - リモートブランチなし: `git push -u origin [branch]`
+  - 保護ブランチ: PR ワークフローを使う
+
+## 使うべきとき
+
+✅ **適している場面:**
+- 複数ファイルにまたがるドキュメント更新
+- テストとドキュメントを伴う機能追加
+- 複数ファイルにまたがるバグ修正
+- プロジェクト全体のフォーマット／リファクタリング
+- 設定変更
+
+❌ **避けるべき場面:**
+- 何をコミットするか不明確
+- シークレット／機密データを含む
+- レビューなしの保護ブランチ
+- マージ競合がある
+- 粒度の細かいコミット履歴を残したい
+- pre-commit フックが失敗している
+
+## 代替案
+
+ユーザーがより細かく制御したい場合は次を提案する:
+1. **選択的ステージング**: 特定ファイルをレビュー／ステージング
+2. **インタラクティブステージング**: パッチ単位の選択に `git add -p`
+3. **PR ワークフロー**: ブランチを作成 → push → PR（`/pr` コマンドを使う）
+
+**⚠️ 注意**: push する前に必ず変更を確認する。迷ったら、より細かい制御のため個別の git コマンドを使う。
+
+---
+**Last Updated**: April 9, 2026
--- a/ja/01-slash-commands/setup-ci-cd.md
+++ b/ja/01-slash-commands/setup-ci-cd.md
@@ -0,0 +1,32 @@
+<!-- i18n-source: 01-slash-commands/setup-ci-cd.md -->
+<!-- i18n-source-sha: 7f2e773 -->
+<!-- i18n-date: 2026-04-27 -->
+
+---
+name: Setup CI/CD Pipeline
+description: 品質保証のための pre-commit フックと GitHub Actions を導入する
+tags: ci-cd, devops, automation
+---
+
+# CI/CD パイプラインのセットアップ
+
+プロジェクトの種類に応じて、包括的な DevOps の品質ゲートを導入する:
+
+1. **プロジェクトを分析**: 言語、フレームワーク、ビルドシステム、既存ツールを検出する
+2. **言語別ツールで pre-commit フックを設定する**:
+   - フォーマッタ: Prettier／Black／gofmt／rustfmt など
+   - リンタ: ESLint／Ruff／golangci-lint／Clippy など
+   - セキュリティ: Bandit／gosec／cargo-audit／npm audit など
+   - 型チェック: TypeScript／mypy／flow（該当する場合）
+   - テスト: 関連するテストスイートを実行する
+3. **GitHub Actions ワークフローを作成する**（.github/workflows/）:
+   - push／PR 時に pre-commit と同じチェックを実行する
+   - 複数バージョン／プラットフォームのマトリクス（該当する場合）
+   - ビルドとテストの検証
+   - デプロイ手順（必要な場合）
+4. **パイプラインを検証する**: ローカルで動作確認し、テスト用 PR を作成し、全チェックの通過を確認する
+
+無料・オープンソースのツールを使う。既存の設定を尊重する。実行時間は短く保つ。
+
+---
+**Last Updated**: April 9, 2026
--- a/ja/01-slash-commands/unit-test-expand.md
+++ b/ja/01-slash-commands/unit-test-expand.md
@@ -0,0 +1,32 @@
+<!-- i18n-source: 01-slash-commands/unit-test-expand.md -->
+<!-- i18n-source-sha: 7f2e773 -->
+<!-- i18n-date: 2026-04-27 -->
+
+---
+name: Expand Unit Tests
+description: 未テストの分岐やエッジケースを狙ってテストカバレッジを高める
+tags: testing, coverage, unit-tests
+---
+
+# ユニットテストの拡充
+
+プロジェクトのテストフレームワークに合わせて、既存のユニットテストを拡充する:
+
+1. **カバレッジを分析**: カバレッジレポートを実行し、未テストの分岐、エッジケース、低カバレッジ領域を特定する
+2. **ギャップを特定**: コードを見直し、論理分岐、エラー経路、境界条件、null／空入力を確認する
+3. **プロジェクトのフレームワークでテストを書く**:
+   - Jest／Vitest／Mocha（JavaScript／TypeScript）
+   - pytest／unittest（Python）
+   - Go testing／testify（Go）
+   - Rust のテストフレームワーク（Rust）
+4. **特定のシナリオを狙う**:
+   - エラーハンドリングと例外
+   - 境界値（最小／最大、空、null）
+   - エッジケース・コーナーケース
+   - 状態遷移と副作用
+5. **改善を確認**: 再度カバレッジを計測し、計測可能な向上を確認する
+
+新しく追加したテストコードのみを提示する。既存のテストパターンと命名規則に従う。
+
+---
+**Last Updated**: April 9, 2026