Claude Codeリソース
Claude Codeリソースからドキュメントを自動生成します。
概要
zudo-docはプロジェクトのClaude Codeリソース — CLAUDE.mdファイル、カスタムコマンド、スキル、エージェント — からドキュメントページを自動的に生成できます。有効にすると、これらはClaudeヘッダーナビゲーションセクションに表示されます。
Claude Resourcesの有効化
src/でclaudeResourcesを設定します：
claudeResources: {
claudeDir: ".claude",
},無効にするにはfalseに設定します：
claudeResources: false,生成されるもの
インテグレーションは.claude/ディレクトリをスキャンし、以下のMDXドキュメントページを生成します：
| リソース | ソース | 出力 |
|---|---|---|
| CLAUDE.mdファイル | プロジェクトルートとサブディレクトリ | claude-md/ |
| コマンド | .claude/commands/*.md | claude-commands/ |
| スキル | . | claude-skills/ |
| エージェント | .claude/agents/*.md | claude-agents/ |
各リソースタイプには、すべてのアイテムのリストを含むインデックスページと個別の詳細ページが用意されます。
仕組み
インテグレーションはzfb.config.tsに登録されたzfbプラグイン（.）として、ビルド時に動作します。preBuildフックで以下を行います：
設定された
.claude/ディレクトリをスキャンCLAUDE.mdファイル、コマンド、スキル（リファレンス付き）、エージェントを検出
src/ディレクトリにMDXファイルを生成content/ docs/ claude- */ これらのファイルはzfbのコンテンツコレクションによって取得され、ドキュメントページとしてレンダリング
生成されたページはClaudeヘッダーナビゲーションタブに表示されます。headerNavでcategoryMatch: "claude"を設定して構成します。
Note
生成されたファイルはsrc/に書き込まれ、ビルドごとに再作成されます。手動で編集しないでください — 変更は上書きされます。
設定オプション
| オプション | 型 | 説明 |
|---|---|---|
claudeDir | string | .claude/ディレクトリへのパス（プロジェクトルートからの相対パス） |
projectRoot | string | CLAUDE.mdファイルパスの解決に使用するオプションのプロジェクトルートオーバーライド |
projectRootオプションは、.claude/ディレクトリがプロジェクトルートにないモノレポ設定で便利です。
Tip
references/サブディレクトリを持つスキルは、そのリファレンスドキュメントが個別のリンクされたページとして含まれるため、バンドルされたナレッジベースを簡単に閲覧できます。