test-wisdom スキル

フロントエンドテストのドキュメント記事をインデックスするClaude Codeスキル（AI支援開発向け）。

test-wisdomスキルは、このサイトのフロントエンドテストドキュメントへAIコーディングエージェントが直接・ライブにアクセスできるようにするClaude Codeスキルです。AI コーディングエージェントが開発中に関連するテストパターンやテクニックを素早く参照できるようにします。

機能

このスキルディレクトリは、このリポジトリのdocs/およびdocs-ja/コンテンツディレクトリをライブでシンボリックリンクしており、そのSKILL.mdにはトップレベルのドキュメントカテゴリ -- ディレクトリツリーのみが埋め込まれています（記事単位のインデックスではありません）。記事の発見はルックアップ時に行われます。Claudeはシンボリックリンクされたディレクトリを閲覧し、各.mdxファイルのフロントマター（title、description）を読んで適切な記事を見つけます。

新しい記事は同じシンボリックリンクの先に存在するため、セットアップを再実行しなくてもすぐに利用可能になります。pnpm setup:doc-skillを再実行する必要があるのは、トップレベルカテゴリを追加・改名した場合のみです（SKILL.mdに埋め込まれたカテゴリリストに反映させるため）。

インストール

セットアップスクリプトを実行して、スキルを生成し、このリポジトリの他の追跡対象スキル（verify-ui、verify-ui-ai、headless-browser）とともにグローバルスキルディレクトリへシンボリックリンクします：

pnpm run setup:doc-skill

これにより.claude/skills/test-wisdom/にスキルが作成され、続けて.claude/skills/配下のすべてのスキルが~/.claude/skills/へシンボリックリンクされます。セットアップ状況は自動検出され、~/.codexも存在する場合は~/.codex/skills/配下にCodex版も同様にリンクされます（--target claude、--target codex、--target bothで上書き可能）。--no-link-tracked-skillsを指定すると追跡対象スキルをスキップし、生成されたtest-wisdomスキルのみをシンボリックリンクします。

使い方

ルックアップモード（デフォルト）

任意のClaude Codeセッションで、トピックキーワードを指定してスキルを呼び出します：

/test-wisdom vitest patterns
/test-wisdom playwright e2e
/test-wisdom testing level escalation

スキルはドキュメントから関連する記事を見つけて読み、コード記述時にテストパターンを適用します。

アップデートモード（`-u` / `--update`）

テストに関する新しい情報があり、このリポジトリのドキュメントを追加または更新したい場合は、-uフラグを使用します：

/test-wisdom -u vitest
/test-wisdom --update playwright patterns

アップデートモードでは、スキルはClaudeに以下を案内します：

学んだことやドキュメント化したい内容を尋ねる
既存のドキュメントを検索して関連記事を見つける
新しい.mdxファイルを作成するか、既存のファイルを更新する
docs-ja/配下の対応する日本語翻訳を更新する
pnpm format:mdを実行して新規/変更ファイルをフォーマットする
pnpm buildを実行してサイトが正しくビルドされることを確認する

スキル構造

.claude/skills/test-wisdom/
  SKILL.md         # 生成されたスキル定義
  docs/            # src/content/docs/ へのシンボリックリンク
  docs-ja/         # src/content/docs-ja/ へのシンボリックリンク

SKILL.mdファイルはセットアップスクリプトによって生成されます。スキルのメタデータとClaude Codeがドキュメントをどのように使用するかの指示が含まれています。

動作原理

/test-wisdom <トピック>を呼び出すと、Claude Codeは：

トピックに基づいてdocs/ディレクトリから関連する記事を見つける
必要な特定の記事のみを読む -- すべての記事を一度に読み込むことはない
記事の情報を質問への回答に適用する
ソース記事のパスを提示し、さらなる参照ができるようにする

日本語ドキュメントはdocs-ja/配下で利用可能です。日本語で作業する場合や日本語コンテンツを求める場合、スキルはdocs-ja/の記事を優先します。