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

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. 設定した追加ロケールのディレクトリ（例: src/content/docs-ja/とsrc/content/docs-de/）をすべてスキルフォルダにシムリンク

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

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

セットアップ

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

pnpm run setup:doc-skill

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

=== zudo-doc Skill Setup ===

Target: auto -> claude codex

  [claude] Created docs symlink -> ...
  [claude] Generated SKILL.md
  [codex] Created docs symlink -> ...
  [codex] Generated SKILL.md

Done! Skill 'zudo-doc-wisdom' is ready.

対象を明示したい場合は、--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/   # 設定したロケールへのリンク（存在する場合）
└── docs-de -> src/content/docs-de/   # 別の設定ロケールへのリンク（存在する場合）

リンク名は設定したディレクトリのベース名に従います（カスタムディレクトリが衝突する場合はコード付きの名前にフォールバック）。生成されたSKILL.mdには正確なロケールマップが記録され、docs-v1-ja/のようなバージョンスナップショットは現在のロケールとしてリンクされません。構造を揃えて翻訳し、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