test-wisdom スキル

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

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

機能

このスキルは、テストの概念をドキュメント記事にマッピングするドキュメントインデックスを管理します。呼び出されると、関連する記事を見つけて読み、推奨されるパターンを適用します。

ドキュメントインデックスは、src/content/docs/ および src/content/docs-ja/（日本語版）配下のすべてのMDX記事から生成されます。各.mdxファイルにはtitleとdescriptionフィールドを持つYAMLフロントマターがあり、適切な記事の特定に役立ちます。

インストール

セットアップスクリプトを実行して、スキルを作成しグローバルClaude Codeスキルディレクトリにシンボリックリンクします：

pnpm run setup:doc-skill

これにより.claude/skills/test-wisdom/にスキルが作成され、~/.claude/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を実行して新規/変更ファイルをフォーマットする

スキル構造

.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/の記事を優先します。