mirror of https://github.com/luongnv89/claude-howto.git synced 2026-08-08 00:08:36 +02:00

Files

T

Luong NGUYENandGitHub 4f3fa85d7e docs: follow-ups from the v2.1.220 accuracy review (#161 )

* fix(ci): move the EPUB build out of pre-commit into CI

The build-epub hooks called scripts/build_epub.py, which raises when the
mmdc binary is missing, while check_mermaid.py skips with a warning in the
same situation. On arm64 — where @mermaid-js/mermaid-cli has no working
build — that made 'pre-commit run --all-files' impossible to satisfy for a
docs-only change without --no-verify.

Remove the build-epub, vietnamese-build-epub and japanese-build-epub hooks
and widen the CI build-epub job to a language matrix so PR-time coverage is
not reduced: it previously built en only, and now builds en, vi, zh and ja.
zh was covered by neither the hooks nor this job, so a broken zh diagram
could only surface at release time.

Closes #156

* docs: replace the stale Kroki narrative with local mmdc rendering

Commit e76bbe4 swapped the Kroki HTTP dependency for local mmdc rendering
but left the docs describing the old design. The claim appeared in seven
live files, not the two originally reported: CLAUDE.md, scripts/README.md
and their ja/uk/vi copies.

Also corrects what the same staleness dragged along:
- scripts/README.md documented --timeout and --max-concurrent, which no
  longer exist, and omitted --mmdc-path, --lang and --puppeteer-config
- 'Async concurrent fetching' described a render_all() that is now a plain
  sequential loop with a dedupe cache
- the network-error/rate-limiting troubleshooting entries are replaced with
  the failures that actually occur now (missing mmdc, Chromium sandbox)

CHANGELOG entries recording the Kroki-to-mmdc switch are left alone; they
describe the past accurately.

Closes #157

* fix(scripts): make the ruff config match files that exist

Ruff resolves include/per-file-ignores patterns relative to the directory
holding pyproject.toml. Since the config lives in scripts/, the pattern
"scripts/**/*.py" meant scripts/scripts/**/*.py, which matches nothing —
'ruff check scripts/' printed 'warning: No Python files found under the
given path(s)' and then 'All checks passed!'. per-file-ignores had the same
mistake. Both are now relative to scripts/, so ruff sees all 14 files.

This silently disabled the pre-commit ruff hooks too, not just the
documented command, and two test files had drifted out of format as a
result. Reformatting them exposed a second problem: the pre-commit hook
pinned ruff v0.8.2 while the CI lint job installs unpinned latest and this
venv has 0.15.10. The versions disagree on formatting, so each reverted the
other's output, and CI would have started failing on a file the local hook
kept rewriting. Bump the hook pin and the requirements-dev floor to 0.15.10
so all three agree.

Verified: 'pre-commit run --all-files' is stable across consecutive runs,
'ruff format --check scripts/' and 'ruff check scripts/' both pass, 92
tests pass.

Closes #160

* docs: point localized module links at their own trees

Files at the root of a language directory used ../NN-module/, which from
uk/CATALOG.md resolves to the English 05-mcp/ at the repo root rather than
uk/05-mcp/. Readers following a count stated about the localized tree
landed in the English one. The link checker never caught it because the
English target does exist.

Files one level deeper (uk/04-subagents/README.md and friends) were already
correct — ../06-hooks/ from there resolves to uk/06-hooks/ — so this is
scoped to the 7 depth-1 files that actually escape: CATALOG.md in uk, vi,
ja and zh, LEARNING-ROADMAP.md in uk and vi, and ja/claude_concepts_guide.md.
119 links in total.

The ../NN- occurrences left in STYLE_GUIDE.md and TRANSLATION_NOTES.md are
inside fenced examples showing what a module page should contain, where the
../ form is the correct convention. All 119 rewritten targets were verified
to exist.

Closes #158

* docs(hooks): stop conflating hook types with hook event categories

'**Hook Types** (5 types, 31 events)' sat above four bullets, so the count
read as wrong. It was not — the two numbers describe different axes that
had been merged into one label.

06-hooks/README.md:126 documents five hook *types*: command, http, prompt,
mcp_tool and agent. Those describe how a hook runs. The four bullets are
event *categories* — Tool, Session, Task, Lifecycle — holding 31 events
(6+7+6+12), and describe when it runs.

Split the label so each number belongs to the axis it counts, in all nine
affected files: README.md and INDEX.md plus the ja, uk, vi and zh copies.
QUICK_REFERENCE.md and LEARNING-ROADMAP.md already stated '5 types' with
the handler names attached and needed no change.

Closes #159

* chore(scripts): drop the unused httpx dependency

httpx was the HTTP client for Kroki rendering. Nothing has imported it
since e76bbe4 moved diagram rendering to a local mmdc subprocess —
check_links.py, the only other network caller, uses stdlib urllib.request.
The PEP 723 blocks in build_epub.py and build_website.py had already
dropped it; only the manifests and docs still declared it.

Removes it from requirements.txt, pyproject.toml dependencies, the
dependency tables and uv --with lines in scripts/README.md and its ja/uk
copies, and the .cspell.json word list. Also drops the B113 bandit
suppression, which existed solely for an httpx timeout false positive —
bandit reports no issues without it.

Also corrects two Requirements lines missed in the previous pass: the ja
and uk script READMEs still listed an internet connection rather than mmdc.

Note: tenacity is now dead for the same reason and is left in place.

* chore(scripts): drop the unused tenacity dependency

Nothing imports tenacity — the retry logic it was added for went away
with the Kroki HTTP fetching in e76bbe4. It was still declared in
requirements.txt, pyproject.toml, both `uv run --with` lines and all
three dependency tables.

* docs(i18n): sync the localized pre-commit check lists

The ja/uk/vi CLAUDE.md files still listed build-epub as pre-commit
check #5, stale since 6da8184 moved the EPUB build to CI. They also
omitted markdown-rendering, and the ja/uk stated counts disagreed with
their own lists. Now matches the English CLAUDE.md.

* fix(scripts): silence PLR0917 now stable in ruff 0.16

CI installs the latest ruff (uv pip install ruff, unpinned), and 0.16.1
promoted too-many-positional-arguments from preview to stable, hard-failing
the Code Quality check on build_epub.py's long-signature draw/helper
functions. These sit in the same family as PLR0913, which is already
ignored. Add PLR0917 so the local 0.15.10 pin and unpinned CI lint agree
again.

2026-08-06 07:58:46 +07:00

34 KiB

Raw Blame History

Claude Code 例題 — 完全索引

本ドキュメントは、機能種別ごとに整理された全サンプルファイルの完全索引である。

サマリー統計

総ファイル数：100 ファイル超
カテゴリ：10 機能カテゴリ
プラグイン：完全プラグイン 3 個
スキル：完全スキル 6 個
フック：例フック 8 個
すぐ使える：すべての例

01. スラッシュコマンド（10 ファイル）

日常ワークフロー向けにユーザーが実行するショートカット。

ファイル	説明	ユースケース
`optimize.md`	コード最適化アナライザ	パフォーマンス問題の検出
`pr.md`	プルリクエスト準備	PR ワークフロー自動化
`generate-api-docs.md`	API ドキュメント生成	API ドキュメント生成
`commit.md`	コミットメッセージ補助	標準化されたコミット
`setup-ci-cd.md`	CI/CD パイプラインセットアップ	DevOps 自動化
`push-all.md`	全変更を push	高速 push ワークフロー
`unit-test-expand.md`	ユニットテストカバレッジ拡張	テスト自動化
`doc-refactor.md`	ドキュメントリファクタリング	ドキュメント改善
`pr-slash-command.png`	スクリーンショット例	視覚的参考
`README.md`	ドキュメント	セットアップと使用ガイド

インストール先：.claude/commands/

使い方：/optimize、/pr、/generate-api-docs、/commit、/setup-ci-cd、/push-all、/unit-test-expand、/doc-refactor

02. メモリ（6 ファイル）

永続的なコンテキストとプロジェクト規約。

ファイル	説明	スコープ	配置場所
`project-CLAUDE.md`	チームプロジェクト規約	プロジェクト全体	`./CLAUDE.md`
`directory-api-CLAUDE.md`	API 固有のルール	ディレクトリ	`./src/api/CLAUDE.md`
`personal-CLAUDE.md`	個人の好み	ユーザー	`~/.claude/CLAUDE.md`
`memory-saved.png`	スクリーンショット：保存済みメモリ	-	視覚的参考
`memory-ask-claude.png`	スクリーンショット：Claude に質問	-	視覚的参考
`README.md`	ドキュメント	-	リファレンス

インストール：適切な場所にコピー

使い方：Claude が自動的に読み込む

03. スキル（28 ファイル）

スクリプトとテンプレートを含む自動起動機能。

コードレビュースキル（5 ファイル）

code-review/
├── SKILL.md                          # スキル定義
├── scripts/
│   ├── analyze-metrics.py            # コードメトリクス分析
│   └── compare-complexity.py         # 複雑度比較
└── templates/
    ├── review-checklist.md           # レビューチェックリスト
    └── finding-template.md           # 指摘ドキュメント

目的：セキュリティ、パフォーマンス、品質分析を含む包括的コードレビュー

自動起動：コードレビュー時

ブランドボイススキル（4 ファイル）

brand-voice/
├── SKILL.md                          # スキル定義
├── templates/
│   ├── email-template.txt            # メールフォーマット
│   └── social-post-template.txt      # SNS フォーマット
└── tone-examples.md                  # メッセージ例

目的：コミュニケーションでブランドボイスの一貫性を保つ

自動起動：マーケティング文の作成時

ドキュメント生成スキル（2 ファイル）

doc-generator/
├── SKILL.md                          # スキル定義
└── generate-docs.py                  # Python ドキュメント抽出

目的：ソースコードから包括的な API ドキュメントを生成

自動起動：API ドキュメントの作成・更新時

リファクタスキル（5 ファイル）

refactor/
├── SKILL.md                          # スキル定義
├── scripts/
│   ├── analyze-complexity.py         # 複雑度分析
│   └── detect-smells.py              # コードスメル検出
├── references/
│   ├── code-smells.md                # コードスメルカタログ
│   └── refactoring-catalog.md        # リファクタリングパターン
└── templates/
    └── refactoring-plan.md           # リファクタリング計画テンプレート

目的：複雑度分析を伴う体系的リファクタリング

自動起動：コードリファクタリング時

Claude MD スキル（1 ファイル）

claude-md/
└── SKILL.md                          # スキル定義

目的：CLAUDE.md ファイルの管理と最適化

ブログ草稿スキル（3 ファイル）

blog-draft/
├── SKILL.md                          # スキル定義
└── templates/
    ├── draft-template.md             # ブログ草稿テンプレート
    └── outline-template.md           # ブログ構成テンプレート

目的：一貫した構造でブログ記事を草稿する

追加：README.md — スキル概要と使用ガイド

インストール先：~/.claude/skills/ または .claude/skills/

04. サブエージェント（10 ファイル）

カスタム能力を持つ専門特化 AI アシスタント。

ファイル	説明	ツール	ユースケース
`code-reviewer.md`	コード品質分析	Read, Grep, Glob, Bash	包括的レビュー
`test-engineer.md`	テストカバレッジ分析	Read, Write, Bash, Grep	テスト自動化
`documentation-writer.md`	ドキュメント作成	Read, Write, Grep	ドキュメント生成
`secure-reviewer.md`	セキュリティレビュー（読み取り専用）	Read, Grep	セキュリティ監査
`implementation-agent.md`	フル実装	Read, Write, Edit, Bash, Grep, Glob	機能開発
`debugger.md`	デバッグ専門家	Read, Edit, Bash, Grep, Glob	バグ調査
`data-scientist.md`	データ分析専門家	Bash, Read, Write	データワークフロー
`clean-code-reviewer.md`	クリーンコード基準	Read, Grep, Glob, Bash	コード品質
`performance-optimizer.md`	パフォーマンスボトルネック分析	Read, Edit, Bash, Grep, Glob	最適化作業
`README.md`	ドキュメント	-	セットアップと使用ガイド

インストール先：.claude/agents/

使い方：メインエージェントが自動委譲

05. MCP プロトコル（5 ファイル）

外部ツールおよび API の統合。

ファイル	説明	連携先	ユースケース
`github-mcp.json`	GitHub 連携	GitHub API	PR / issue 管理
`database-mcp.json`	データベースクエリ	PostgreSQL/MySQL	ライブデータクエリ
`filesystem-mcp.json`	ファイル操作	ローカルファイルシステム	ファイル管理
`multi-mcp.json`	複数サーバ	GitHub + DB + Slack	完全統合
`README.md`	ドキュメント	-	セットアップと使用ガイド

インストール先：.mcp.json（プロジェクトスコープ）または ~/.claude.json（ユーザースコープ）

使い方：/mcp__github__list_prs など

06. フック（10 ファイル）

自動実行されるイベント駆動の自動化スクリプト。

ファイル	説明	イベント	ユースケース
`format-code.sh`	コード自動整形	PostToolUse（matcher: Write）	コード整形
`pre-commit.sh`	コミット前のテスト実行	PreToolUse（matcher: Bash）	テスト自動化
`pre-tool-check.sh`	実行前のコマンド検証と監査	PreToolUse（matcher: Bash）	ガードレール、監査ログ
`security-scan.sh`	セキュリティスキャン	PostToolUse（matcher: Write）	セキュリティチェック
`dependency-check.sh`	依存関係マニフェストの脆弱性スキャン	PostToolUse（matcher: Write）	サプライチェーン検査
`log-bash.sh`	bash コマンド記録	PostToolUse（matcher: Bash）	コマンドログ
`notify-team.sh`	通知送信	PostToolUse（matcher: Bash）	チーム通知
`validate-prompt.sh`	プロンプト検証	UserPromptSubmit	入力検証
`session-end.sh`	セッション終了時に進捗を記録	SessionEnd	進捗トラッキング
`README.md`	ドキュメント	-	セットアップと使用ガイド

インストール先：~/.claude/settings.json で設定

使い方：設定で構成し、自動実行される

フックの種類（5 種）：command、http、prompt、mcp_tool、agent — フックの実行方式。

フックイベント（31 件、4 カテゴリ）— 実行タイミング：

ツール系フック：PreToolUse、PostToolUse、PostToolUseFailure、PostToolBatch、PermissionRequest、PermissionDenied
セッション系フック：SessionStart、Setup、SessionEnd、Stop、StopFailure、SubagentStart、SubagentStop
タスク系フック：UserPromptSubmit、UserPromptExpansion、MessageDisplay、TaskCompleted、TaskCreated、TeammateIdle
ライフサイクル系フック：ConfigChange、CwdChanged、DirectoryAdded、FileChanged、PreCompact、PostCompact、WorktreeCreate、WorktreeRemove、Notification、InstructionsLoaded、Elicitation、ElicitationResult

07. プラグイン（完全プラグイン 3 個、40 ファイル）

機能のバンドル集。

PR レビュープラグイン（10 ファイル）

pr-review/
├── .claude-plugin/
│   └── plugin.json                   # プラグインマニフェスト
├── commands/
│   ├── review-pr.md                  # 包括的レビュー
│   ├── check-security.md             # セキュリティチェック
│   └── check-tests.md                # テストカバレッジチェック
├── agents/
│   ├── security-reviewer.md          # セキュリティ専門家
│   ├── test-checker.md               # テスト専門家
│   └── performance-analyzer.md       # パフォーマンス専門家
├── mcp/
│   └── github-config.json            # GitHub 連携
├── hooks/
│   └── pre-review.js                 # レビュー前検証
└── README.md                         # プラグインドキュメント

機能：セキュリティ分析、テストカバレッジ、パフォーマンス影響

コマンド：/review-pr、/check-security、/check-tests

インストール：/plugin install pr-review

DevOps 自動化プラグイン（15 ファイル）

devops-automation/
├── .claude-plugin/
│   └── plugin.json                   # プラグインマニフェスト
├── commands/
│   ├── deploy.md                     # デプロイ
│   ├── rollback.md                   # ロールバック
│   ├── status.md                     # システムステータス
│   └── incident.md                   # インシデント対応
├── agents/
│   ├── deployment-specialist.md      # デプロイ専門家
│   ├── incident-commander.md         # インシデント指揮
│   └── alert-analyzer.md             # アラート分析
├── mcp/
│   └── kubernetes-config.json        # Kubernetes 連携
├── hooks/
│   ├── pre-deploy.js                 # デプロイ前チェック
│   └── post-deploy.js                # デプロイ後タスク
├── scripts/
│   ├── deploy.sh                     # デプロイ自動化
│   ├── rollback.sh                   # ロールバック自動化
│   └── health-check.sh               # ヘルスチェック
└── README.md                         # プラグインドキュメント

機能：Kubernetes デプロイ、ロールバック、監視、インシデント対応

コマンド：/deploy、/rollback、/status、/incident

インストール：/plugin install devops-automation

ドキュメントプラグイン（14 ファイル）

documentation/
├── .claude-plugin/
│   └── plugin.json                   # プラグインマニフェスト
├── commands/
│   ├── generate-api-docs.md          # API ドキュメント生成
│   ├── generate-readme.md            # README 作成
│   ├── sync-docs.md                  # ドキュメント同期
│   └── validate-docs.md              # ドキュメント検証
├── agents/
│   ├── api-documenter.md             # API ドキュメント専門家
│   ├── code-commentator.md           # コードコメント専門家
│   └── example-generator.md          # 例の作成
├── mcp/
│   └── github-docs-config.json       # GitHub 連携
├── templates/
│   ├── api-endpoint.md               # API エンドポイントテンプレート
│   ├── function-docs.md              # 関数ドキュメントテンプレート
│   └── adr-template.md               # ADR テンプレート
└── README.md                         # プラグインドキュメント

機能：API ドキュメント、README 生成、ドキュメント同期、検証

コマンド：/generate-api-docs、/generate-readme、/sync-docs、/validate-docs

インストール：/plugin install documentation

追加：README.md — プラグイン概要と使用ガイド

08. チェックポイントと巻き戻し（2 ファイル）

会話状態を保存し、別アプローチを探索する。

ファイル	説明	内容
`README.md`	ドキュメント	包括的なチェックポイントガイド
`checkpoint-examples.md`	実用例	DB マイグレーション、パフォーマンス最適化、UI 反復、デバッグ

主要概念：

チェックポイント：会話状態のスナップショット
巻き戻し：以前のチェックポイントへ戻る
分岐点：複数のアプローチを探索する

使い方：

# チェックポイントはユーザープロンプトのたびに自動作成される
# 巻き戻しは Esc を 2 回押すか、次を実行:
/rewind
# 選択肢: コードと会話の復元、会話の復元、
# コードの復元、ここから要約、やめる

ユースケース：

別実装を試す
ミスからのリカバリ
安全な実験
解決策の比較
A/B テスト

09. 高度な機能（3 ファイル）

複雑なワークフロー向けの高度な機能。

ファイル	説明	機能
`README.md`	完全ガイド	全高度機能のドキュメント
`config-examples.json`	設定例	ユースケース別の 10 種以上の設定
`planning-mode-examples.md`	プランニング例	REST API、DB マイグレーション、リファクタリング
スケジュールタスク	`/loop` および cron ツールによる反復タスク	自動化された反復ワークフロー
Chrome 連携	ヘッドレス Chromium によるブラウザ自動化	Web テストとスクレイピング
リモートコントロール（拡張）	接続方式、セキュリティ、比較表	リモートセッション管理
キーバインドカスタマイズ	カスタムキーバインド、コード対応、コンテキスト	パーソナライズされたショートカット
デスクトップアプリ（拡張）	コネクタ、launch.json、エンタープライズ機能	デスクトップ統合

カバーされる高度機能：

プランニングモード

詳細な実装計画の作成
時間見積もりとリスク評価
体系的なタスク分解

拡張思考

複雑な問題に対する深い推論
アーキテクチャ意思決定の分析
トレードオフの評価

バックグラウンドタスク

ブロックなしの長時間処理
並列開発ワークフロー
タスク管理と監視

権限モード

default：危険な操作で承認を求める
acceptEdits：ファイル編集を自動承認、それ以外は確認
plan：読み取り専用分析、変更なし
auto：バックグラウンドの安全チェック付きで全操作を実行 — 分類器がコマンドと保護ディレクトリへの書き込みを審査する（autoMode 設定オブジェクトで構成）
dontAsk：事前承認済みのツールのみ — 本来プロンプトが出る呼び出しはすべて自動的に拒否される。Claude が実行できるのは permissions.allow に一致するもの、読み取り専用の Bash コマンド、PreToolUse フックが承認した呼び出しに限られる
bypassPermissions：すべて承認（--dangerously-skip-permissions が必要）

ヘッドレスモード（`claude -p`）

CI/CD 統合
自動化されたタスク実行
バッチ処理

セッション管理

複数の作業セッション
セッション切替と保存
セッション永続化

インタラクティブ機能

キーボードショートカット
コマンド履歴
タブ補完
複数行入力

設定

包括的な設定管理
環境別設定
プロジェクト別カスタマイズ

スケジュールタスク

/loop コマンドによる反復タスク
cron ツール：CronCreate、CronList、CronDelete
自動化された反復ワークフロー

Chrome 連携

ヘッドレス Chromium によるブラウザ自動化
Web テストおよびスクレイピング能力
ページ操作とデータ抽出

リモートコントロール（拡張）

接続方式とプロトコル
セキュリティ上の留意事項とベストプラクティス
リモートアクセスオプションの比較表

キーバインドカスタマイズ

カスタムキーバインド設定
複数キーショートカットのコード対応
コンテキストに応じたキーバインドの有効化

デスクトップアプリ（拡張）

IDE 統合のためのコネクタ
launch.json 設定
エンタープライズ機能とデプロイ

10. CLI 利用（1 ファイル）

コマンドラインインターフェースの利用パターンとリファレンス。

ファイル	説明	内容
`README.md`	CLI ドキュメント	フラグ、オプション、利用パターン

主な CLI 機能：

claude — 対話セッションを開始
claude -p "prompt" — ヘッドレス / 非対話モード
claude web — Web セッションを起動
claude --model — モデル選択（Sonnet 4.6、Opus 4.7、Haiku 4.5）
claude --permission-mode — 権限モードの設定
claude --remote — WebSocket 経由のリモートコントロール有効化

ドキュメントファイル（13 ファイル）

ファイル	場所	説明
`README.md`	`/`	メイン例題概要
`INDEX.md`	`/`	この完全索引
`QUICK_REFERENCE.md`	`/`	クイックリファレンスカード
`README.md`	`/01-slash-commands/`	スラッシュコマンドガイド
`README.md`	`/02-memory/`	メモリガイド
`README.md`	`/03-skills/`	スキルガイド
`README.md`	`/04-subagents/`	サブエージェントガイド
`README.md`	`/05-mcp/`	MCP ガイド
`README.md`	`/06-hooks/`	フックガイド
`README.md`	`/07-plugins/`	プラグインガイド
`README.md`	`/08-checkpoints/`	チェックポイントガイド
`README.md`	`/09-advanced-features/`	高度な機能ガイド
`README.md`	`/10-cli/`	CLI ガイド

完全ファイルツリー

claude-howto/
├── README.md                                    # メイン概要
├── INDEX.md                                     # このファイル
├── QUICK_REFERENCE.md                           # クイックリファレンスカード
├── claude_concepts_guide.md                     # オリジナルガイド
│
├── 01-slash-commands/                           # スラッシュコマンド
│   ├── optimize.md
│   ├── pr.md
│   ├── generate-api-docs.md
│   ├── commit.md
│   ├── setup-ci-cd.md
│   ├── push-all.md
│   ├── unit-test-expand.md
│   ├── doc-refactor.md
│   ├── pr-slash-command.png
│   └── README.md
│
├── 02-memory/                                   # メモリ
│   ├── project-CLAUDE.md
│   ├── directory-api-CLAUDE.md
│   ├── personal-CLAUDE.md
│   ├── memory-saved.png
│   ├── memory-ask-claude.png
│   └── README.md
│
├── 03-skills/                                   # スキル
│   ├── code-review/
│   │   ├── SKILL.md
│   │   ├── scripts/
│   │   │   ├── analyze-metrics.py
│   │   │   └── compare-complexity.py
│   │   └── templates/
│   │       ├── review-checklist.md
│   │       └── finding-template.md
│   ├── brand-voice/
│   │   ├── SKILL.md
│   │   ├── templates/
│   │   │   ├── email-template.txt
│   │   │   └── social-post-template.txt
│   │   └── tone-examples.md
│   ├── doc-generator/
│   │   ├── SKILL.md
│   │   └── generate-docs.py
│   ├── refactor/
│   │   ├── SKILL.md
│   │   ├── scripts/
│   │   │   ├── analyze-complexity.py
│   │   │   └── detect-smells.py
│   │   ├── references/
│   │   │   ├── code-smells.md
│   │   │   └── refactoring-catalog.md
│   │   └── templates/
│   │       └── refactoring-plan.md
│   ├── claude-md/
│   │   └── SKILL.md
│   ├── blog-draft/
│   │   ├── SKILL.md
│   │   └── templates/
│   │       ├── draft-template.md
│   │       └── outline-template.md
│   └── README.md
│
├── 04-subagents/                                # サブエージェント
│   ├── code-reviewer.md
│   ├── test-engineer.md
│   ├── documentation-writer.md
│   ├── secure-reviewer.md
│   ├── implementation-agent.md
│   ├── debugger.md
│   ├── data-scientist.md
│   ├── clean-code-reviewer.md
│   └── README.md
│
├── 05-mcp/                                      # MCP プロトコル
│   ├── github-mcp.json
│   ├── database-mcp.json
│   ├── filesystem-mcp.json
│   ├── multi-mcp.json
│   └── README.md
│
├── 06-hooks/                                    # フック
│   ├── format-code.sh
│   ├── pre-commit.sh
│   ├── security-scan.sh
│   ├── log-bash.sh
│   ├── validate-prompt.sh
│   ├── notify-team.sh
│   ├── context-tracker.py
│   ├── context-tracker-tiktoken.py
│   └── README.md
│
├── 07-plugins/                                  # プラグイン
│   ├── pr-review/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   ├── commands/
│   │   │   ├── review-pr.md
│   │   │   ├── check-security.md
│   │   │   └── check-tests.md
│   │   ├── agents/
│   │   │   ├── security-reviewer.md
│   │   │   ├── test-checker.md
│   │   │   └── performance-analyzer.md
│   │   ├── mcp/
│   │   │   └── github-config.json
│   │   ├── hooks/
│   │   │   └── pre-review.js
│   │   └── README.md
│   ├── devops-automation/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   ├── commands/
│   │   │   ├── deploy.md
│   │   │   ├── rollback.md
│   │   │   ├── status.md
│   │   │   └── incident.md
│   │   ├── agents/
│   │   │   ├── deployment-specialist.md
│   │   │   ├── incident-commander.md
│   │   │   └── alert-analyzer.md
│   │   ├── mcp/
│   │   │   └── kubernetes-config.json
│   │   ├── hooks/
│   │   │   ├── pre-deploy.js
│   │   │   └── post-deploy.js
│   │   ├── scripts/
│   │   │   ├── deploy.sh
│   │   │   ├── rollback.sh
│   │   │   └── health-check.sh
│   │   └── README.md
│   ├── documentation/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   ├── commands/
│   │   │   ├── generate-api-docs.md
│   │   │   ├── generate-readme.md
│   │   │   ├── sync-docs.md
│   │   │   └── validate-docs.md
│   │   ├── agents/
│   │   │   ├── api-documenter.md
│   │   │   ├── code-commentator.md
│   │   │   └── example-generator.md
│   │   ├── mcp/
│   │   │   └── github-docs-config.json
│   │   ├── templates/
│   │   │   ├── api-endpoint.md
│   │   │   ├── function-docs.md
│   │   │   └── adr-template.md
│   │   └── README.md
│   └── README.md
│
├── 08-checkpoints/                              # チェックポイント
│   ├── checkpoint-examples.md
│   └── README.md
│
├── 09-advanced-features/                        # 高度な機能
│   ├── config-examples.json
│   ├── planning-mode-examples.md
│   └── README.md
│
└── 10-cli/                                      # CLI 利用
    └── README.md

ユースケース別クイックスタート

コード品質とレビュー

# スラッシュコマンドをインストール
cp 01-slash-commands/optimize.md .claude/commands/

# サブエージェントをインストール
cp 04-subagents/code-reviewer.md .claude/agents/

# スキルをインストール
cp -r 03-skills/code-review-specialist ~/.claude/skills/

# あるいは完全プラグインをインストール
/plugin install pr-review

DevOps とデプロイ

# プラグインをインストール (すべて含む)
/plugin install devops-automation

ドキュメント

# スラッシュコマンドをインストール
cp 01-slash-commands/generate-api-docs.md .claude/commands/

# サブエージェントをインストール
cp 04-subagents/documentation-writer.md .claude/agents/

# スキルをインストール
cp -r 03-skills/doc-generator ~/.claude/skills/

# あるいは完全プラグインをインストール
/plugin install documentation

チーム標準

# プロジェクトメモリをセットアップ
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# チームの標準に合わせて編集

外部統合

# 環境変数を設定
export GITHUB_TOKEN="your_token"
export DATABASE_URL="postgresql://..."

# MCP 設定をインストール (プロジェクトスコープ)
cp 05-mcp/multi-mcp.json .mcp.json

自動化と検証

# フックをインストール
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

# 設定でフックを構成 (~/.claude/settings.json)
# 06-hooks/README.md を参照

安全な実験

# チェックポイントはユーザープロンプトのたびに自動作成される
# 巻き戻し: Esc+Esc を押すか /rewind
# 巻き戻しメニューから何を復元するか選択

# 例は 08-checkpoints/README.md を参照

高度なワークフロー

# 高度な機能を設定
# 09-advanced-features/config-examples.json を参照

# プランニングモードを使う
/plan Implement feature X

# 権限モードを使う
claude --permission-mode plan          # コードレビュー (読み取り専用)
claude --permission-mode acceptEdits   # 編集を自動承認
claude --permission-mode auto          # 安全な操作を自動承認

# CI/CD のためのヘッドレスモードで実行
claude -p "Run tests and report results"

# バックグラウンドタスクを実行
Run tests in background

# 完全ガイドは 09-advanced-features/README.md を参照

機能カバレッジマトリクス

カテゴリ	コマンド	エージェント	MCP	フック	スクリプト	テンプレート	ドキュメント	画像	合計
01 スラッシュコマンド	8	-	-	-	-	-	1	1	10
02 メモリ	-	-	-	-	-	3	1	2	6
03 スキル	-	-	-	-	5	9	1	-	28
04 サブエージェント	-	9	-	-	-	-	1	-	10
05 MCP	-	-	4	-	-	-	1	-	5
06 フック	-	-	-	9	-	-	1	-	10
07 プラグイン	11	9	3	3	3	3	4	-	40
08 チェックポイント	-	-	-	-	-	-	1	1	2
09 高度な機能	-	-	-	-	-	-	1	2	3
10 CLI	-	-	-	-	-	-	1	-	1

学習パス

初級（第 1 週）

✅ README.md を読む
✅ スラッシュコマンドを 1〜2 個インストール
✅ プロジェクトメモリファイルを作成
✅ 基本コマンドを試す

中級（第 2〜3 週）

✅ GitHub MCP をセットアップ
✅ サブエージェントをインストール
✅ タスク委譲を試す
✅ スキルをインストール

上級（第 4 週〜）

✅ 完全プラグインをインストール
✅ カスタムスラッシュコマンドを作成
✅ カスタムサブエージェントを作成
✅ カスタムスキルを作成
✅ 自分のプラグインを構築

エキスパート（第 5 週〜）

✅ 自動化のためのフックをセットアップ
✅ 実験のためチェックポイントを使う
✅ プランニングモードを設定
✅ 権限モードを効果的に使う
✅ CI/CD のためヘッドレスモードをセットアップ
✅ セッション管理を習得

キーワード検索

パフォーマンス

01-slash-commands/optimize.md — パフォーマンス分析
04-subagents/code-reviewer.md — パフォーマンスレビュー
03-skills/code-review-specialist/ — パフォーマンスメトリクス
07-plugins/pr-review/agents/performance-analyzer.md — パフォーマンス専門家

セキュリティ

04-subagents/secure-reviewer.md — セキュリティレビュー
03-skills/code-review-specialist/ — セキュリティ分析
07-plugins/pr-review/ — セキュリティチェック

テスト

04-subagents/test-engineer.md — テストエンジニア
07-plugins/pr-review/commands/check-tests.md — テストカバレッジ

ドキュメント

01-slash-commands/generate-api-docs.md — API ドキュメントコマンド
04-subagents/documentation-writer.md — ドキュメント作成エージェント
03-skills/doc-generator/ — ドキュメント生成スキル
07-plugins/documentation/ — 完全ドキュメントプラグイン

デプロイ

07-plugins/devops-automation/ — 完全 DevOps ソリューション

自動化

06-hooks/ — イベント駆動自動化
06-hooks/pre-commit.sh — コミット前自動化
06-hooks/format-code.sh — 自動整形
09-advanced-features/ — CI/CD のためのヘッドレスモード

検証

06-hooks/security-scan.sh — セキュリティ検証
06-hooks/validate-prompt.sh — プロンプト検証

実験

08-checkpoints/ — 巻き戻しによる安全な実験
08-checkpoints/checkpoint-examples.md — 実用例

プランニング

09-advanced-features/planning-mode-examples.md — プランニングモード例
09-advanced-features/README.md — 拡張思考

設定

09-advanced-features/config-examples.json — 設定例

注意事項

すべての例はそのまま利用できる
自分のニーズに合わせて改造する
例は Claude Code のベストプラクティスに従う
各カテゴリには詳細手順つきの独自 README がある
スクリプトには適切なエラー処理が含まれる
テンプレートはカスタマイズ可能

コントリビュート

例題を追加したい場合は次の構造に従う：

適切なサブディレクトリを作成
利用方法つき README.md を含める
命名規則に従う
入念にテストする
この索引を更新する

最終更新：2026 年 4 月 24 日 Claude Code バージョン：2.1.119 情報源：

https://code.claude.com/docs/en/overview
https://code.claude.com/docs/en/hooks
https://code.claude.com/docs/en/commands
https://github.com/anthropics/claude-code/releases/tag/v2.1.119 互換モデル：Claude Sonnet 4.6、Claude Opus 4.7、Claude Haiku 4.5 例題総数：100 ファイル超 カテゴリ：10 機能 フック：自動化スクリプト 8 個 設定例：10 シナリオ以上 すぐ使える：すべての例

34 KiB Raw Blame History Unescape Escape

Claude Code 例題 — 完全索引

サマリー統計

01. スラッシュコマンド（10 ファイル）

02. メモリ（6 ファイル）

03. スキル（28 ファイル）

コードレビュースキル（5 ファイル）

ブランドボイススキル（4 ファイル）

ドキュメント生成スキル（2 ファイル）

リファクタスキル（5 ファイル）

Claude MD スキル（1 ファイル）

ブログ草稿スキル（3 ファイル）

04. サブエージェント（10 ファイル）

05. MCP プロトコル（5 ファイル）

06. フック（10 ファイル）

07. プラグイン（完全プラグイン 3 個、40 ファイル）

PR レビュープラグイン（10 ファイル）

DevOps 自動化プラグイン（15 ファイル）

ドキュメントプラグイン（14 ファイル）

08. チェックポイントと巻き戻し（2 ファイル）

09. 高度な機能（3 ファイル）

プランニングモード

拡張思考

バックグラウンドタスク

権限モード

ヘッドレスモード（claude -p）

セッション管理

インタラクティブ機能

設定

スケジュールタスク

Chrome 連携

リモートコントロール（拡張）

キーバインドカスタマイズ

デスクトップアプリ（拡張）

10. CLI 利用（1 ファイル）

ドキュメントファイル（13 ファイル）

完全ファイルツリー

ユースケース別クイックスタート

コード品質とレビュー

DevOps とデプロイ

ドキュメント

チーム標準

外部統合

自動化と検証

安全な実験

高度なワークフロー

機能カバレッジマトリクス

学習パス

初級（第 1 週）

中級（第 2〜3 週）

上級（第 4 週〜）

エキスパート（第 5 週〜）

キーワード検索

パフォーマンス

セキュリティ

テスト

ドキュメント

デプロイ

自動化

検証

実験

プランニング

設定

注意事項

コントリビュート

34 KiB

Raw Blame History

ヘッドレスモード（`claude -p`）