ドキュメントスキルシムリンカー

zudo-docのドキュメントをClaude CodeまたはCodexのナレッジベースとしてシムリンクで利用可能にします。

概要

ドキュメントスキルシムリンカーは、ドキュメントコンテンツからエージェント用スキルを作成します。セットアップ後、Claude CodeまたはCodexがそのスキルを読み込み、ドキュメントを参照できます。これにより、書き留めたすべてのドキュメントがAIのコンテキストとして利用可能になります。

これは特に次のような場合に便利です：

• このプロジェクトに依存する別のプロジェクトで作業しているとき

• 設定、コンポーネント、使用パターンに関する質問に答えるとき

• Claude CodeやCodexを通じてチームと組織のナレッジを共有するとき

仕組み

セットアップスクリプトは次のことを行います：

1. プロジェクト内に.claude/skills/<skill-name>/または.codex/skills/<skill-name>/ディレクトリを作成

2. エージェントにドキュメントの使い方を伝えるSKILL.mdを生成

3. src/content/docs/ディレクトリをスキルフォルダにシムリンク

4. スキルを~/.claude/skills/または~/.codex/skills/にシムリンクし、グローバルに利用可能にする

デフォルトでは、スクリプトがエージェントのホームディレクトリを自動判定します。~/.codex/だけがある場合はCodex、~/.claude/だけがある場合はClaude Code、両方ある場合は両方、どちらもない新しい環境では従来どおりClaude Codeを選びます。

セットアップ

セットアップスクリプトを実行します:

pnpm run setup:doc-skill

スキル名は決定的に<プロジェクト名>-wisdomになります（例: zudo-doc-wisdom）。先頭の位置引数またはSKILL_NAME環境変数で上書きできます。

対象を明示したい場合は、--targetつきのスクリプトを使います:

pnpm run setup:doc-skill:claude
pnpm run setup:doc-skill:codex
pnpm run setup:doc-skill:both

使い方

セットアップ後、任意のClaude Codeセッションでスキルを使用できます:

/zudo-doc-wisdom sidebar

Claudeが関連するドキュメント記事を検索し、回答に利用します。Codexでは、このドキュメントについて質問するときにスキル名を指定してください。スキルはグローバルにシムリンクされているため、どのプロジェクトディレクトリからでも動作します。

ワークフローの例

zudo-docでサイトを構築していて、フッターの設定方法を知りたいとします：

/zudo-doc-wisdom footer configuration

Claudeはドキュメントからフッターガイドを読み取り、ドキュメントに裏付けられた正確な回答を提供します。

作成されるファイル

セットアップスクリプトを実行すると、以下のファイルが作成されます:

.claude/skills/<skill-name>/
├── SKILL.md       # スキル定義（フロントマターと指示）
├── docs -> src/content/docs/         # 英語ドキュメントへのシムリンク
└── docs-ja -> src/content/docs-ja/   # 日本語ドキュメントへのシムリンク

Codex対象では、同じ構成が.codex/skills/<skill-name>/配下に作成されます。

グローバルシムリンク:

~/.claude/skills/<skill-name> -> .claude/skills/<skill-name>
~/.codex/skills/<skill-name> -> .codex/skills/<skill-name>

再実行

セットアップスクリプトはいつでも再実行できます。既存のシムリンクは自動的に置き換えられます。

pnpm run setup:doc-skill