Claude Codeリソース

作成 2026年3月13日更新 2026年9月18日Takeshi Takatsudo

Claude Codeリソースからドキュメントを自動生成します。

概要

zudo-docはプロジェクトのClaude Codeリソース — CLAUDE.mdファイル、カスタムコマンド、スキル、エージェント — からドキュメントページを自動的に生成できます。有効にすると、これらはClaudeヘッダーナビゲーションセクションに表示されます。

Claude Resourcesの有効化

zfb.config.tsでclaudeResourcesを設定します：

zfb.config.ts

export default defineConfig(
  zudoDoc({
    claudeResources: {
      claudeDir: ".claude",
    },
  }),
);

無効にするにはfalseに設定します：

claudeResources: false,

生成されるもの

インテグレーションは.claude/ディレクトリをスキャンし、以下のMDXドキュメントページを生成します：

リソース	ソース	出力
CLAUDE.mdファイル	プロジェクトルートとサブディレクトリ	`claude-md/`
コマンド	`.claude/commands/*.md`	`claude-commands/`
スキル	`.claude/skills/*/SKILL.md`	`claude-skills/`
エージェント	`.claude/agents/*.md`	`claude-agents/`

各リソースタイプには、すべてのアイテムのリストを含むインデックスページと個別の詳細ページが用意されます。

仕組み

インテグレーションはzfbプラグイン（@takazudo/zudo-doc/plugins/claude-resources）として、ビルド時に動作します。このプラグインはclaudeResourcesが設定されていればzudoDoc()が自動的に組み込みます。preBuildフックで以下を行います：

設定された.claude/ディレクトリをスキャン
CLAUDE.mdファイル、コマンド、スキル（リファレンス付き）、エージェントを検出
src/content/docs/claude-*/ディレクトリにMDXファイルを生成
これらのファイルはzfbのコンテンツコレクションによって取得され、ドキュメントページとしてレンダリング

生成されたページはClaudeヘッダーナビゲーションタブに表示されます。headerNavでcategoryMatch: "claude"を設定して構成します。

Note

生成されたファイルはsrc/content/docs/に書き込まれ、ビルドごとに再作成されます。手動で編集しないでください — 変更は上書きされます。

ロケールごとの挙動

概要ページとカテゴリインデックスは、設定済みの各ロケールに生成されます。タイトル、説明、ラベルにはresource.*のUI文字列が使われます。個別リソース本文の正本となるソースダンプはデフォルトのコンテンツディレクトリに置かれます。本文の言語は元のソースファイルに従うため、必ずしも英語ではありません。ロケール付きルートでは未翻訳バナーを出さず、ローカライズされたナビゲーションとクロームの中にその本文を表示します。言語切り替えには設定済みの全ロケールへのリンクが残ります。

パッケージが同梱するresource.*文字列は英語と日本語です。他の対応ロケールコードは、通常どおり要求ロケール → 設定済みデフォルト → 英語 → リテラルの順でフォールバックします。ラベルはZudoDocConfig.translationsで上書きできます。保存方針の理由、llms.txtと検索の挙動、defaultLocaleOnlyPrefixesによるオプトアウトは国際化を参照してください。

このオプトアウトを使う場合は、セクション全体をまとめて制限してください。/docs/claude-md/、/docs/claude-skills/、/docs/claude-agents/、/docs/claude-commands/に加えて、概要プレフィックス/docs/claude/も列挙する必要があります。概要プレフィックスがないと、ロケール所有の概要インデックスは設定済みの全ロケールに生成されます。そのロケール側に手書きのclaude/index.mdx（frontmatterにgenerated: trueがないもの）が既にある場合、ビルドはresource-docs: refusing to overwrite authored locale indexで失敗します。詳しくはリソースセクションには概要プレフィックスも含まれるを参照してください。

設定オプション

オプション	型	説明
`claudeDir`	string	`.claude/`ディレクトリへのパス（プロジェクトルートからの相対パス）
`projectRoot`	string	CLAUDE.mdファイルパスの解決に使用するオプションのプロジェクトルートオーバーライド
`scanRoot`	string	CLAUDE.mdの探索に使用する省略可能なリポジトリ全体のルート。デフォルトは`projectRoot`

projectRootオプションは、.claude/ディレクトリがプロジェクトルートにないモノレポ設定で便利です。

Tip

references/サブディレクトリを持つスキルは、そのリファレンスドキュメントが個別のリンクされたページとして含まれるため、バンドルされたナレッジベースを簡単に閲覧できます。

ミラー内のリポジトリ相対リンク

ミラーされたリソース本文では、リポジトリ内の相対パスを指すMarkdownリンクと画像をインラインコードに変換します。リンク先をドキュメントのURLとして扱うと壊れるためです。リンクのラベルまたは画像の代替テキストを表示します。Claude側のCLAUDE.md・コマンド・エージェント、Codex側のAGENTS.md、および両方のスキル本文とサブページに適用されます。

スキルのメイン本文にあるreferences/・scripts/・assets/へのリンクは、対応するサブページが実際に生成される場合に限り、そのページへのリンクとして維持されます。存在しない対象や生成対象外のファイル（.shスクリプトなど）はインラインコードになります。サブページ本文のリポジトリ相対リンクもインラインコードになります。生成ページへのリンクを維持する例外は、スキルのメイン本文に適用されます。

外部URL、ルート相対URL、ページ内フラグメントは維持されます。インラインコードやコードフェンス内のリンク例は変換しません。通常の手書きMDXでは、引き続きドキュメント間リンクの規則に従ってください。

GitHub でソースを見る