effect-index について
effect-index は、Effect を扱うコーディングエージェント向けのスキル案内です。タスクに合うスキルやローカルのパターン集を示し、実装前に Effect のソースを調べる手順も案内します。
主な機能
- 01タスク別スキル選択ツリー
- 02130以上のローカルパターンへのリンク
- 03Effect ソース検索の案内
- 04スキル横断のパターン参照
活用シーン
- 01Effect タスク向けスキルの選択
- 02リトライやストリーミング例の検索
- 03コーディング前の Effect ソース確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ mepuka/ effect-ontology --skill effect-indexインストール後、Claude Code で/effect-indexを入力して読み込まれたか確認します。
詳細
Effect スキルインデックス
タスクに適したスキルをすばやく見つけるためのルーターとしてお使いください。各項目は、コーディングエージェントの限られたコンテキストに最適化された、特定の用途に特化したスキルにリンクしています。
決定木
- Effect コードを新しく書く、またはリファクタリングする必要がある → 基礎
- 堅牢なエラー処理やリトライが必要 → エラーとリトライ
- 並列処理を実行する、またはファイバーを管理する必要がある → 並行処理とファイバー
- データパイプライン、バッチ処理、バックプレッシャーを扱う → ストリームとパイプライン
- DI、サービス、レイヤー、またはテストと本番環境の配線が必要 → レイヤーとサービス
- クリーンアップを伴うファイル、ソケット、サーバーのオープン → リソースとスコープ
- HTTP エンドポイントや JSON レスポンスを追加する → HTTP とルーティング
- 入力を検証する、または設定を解析する → 設定とスキーマ
- 値ベースの等価性や高性能なイミュータブルコレクション → データ構造
- 時間、ログ、スパン、トレーシング → 時間/トレーシング/ログ
- キュー、PubSub、バックグラウンドワーカー → キューとバックグラウンド処理
- サービスのテストやモックを書く → テストとモック
- 特定のパターンや例を探している → パターンハブ(130 以上のパターン)
スキルをまたぐパターン
すべてのパターンが、ローカルの パターンハブ(130 以上のパターン)で利用できるようになりました。
- 一時的な障害をリトライする → エラーとリトライ + retry-based-on-specific-errors.mdx
- リソースセーフなストリーミング → ストリームとパイプライン + stream-manage-resources.mdx
- グレースフルシャットダウン → キューとバックグラウンド処理 + execute-long-running-apps-with-runfork.mdx
- サービスレイヤーの設計 → レイヤーとサービス + model-dependencies-as-services.mdx
- HTTP サーバーのセットアップ → HTTP とルーティング + build-a-basic-http-server.mdx
- スキーマ検証 → 設定とスキーマ + define-contracts-with-schema.mdx
- モックを使ったテスト → テストとモック + mocking-dependencies-in-tests.mdx
ヒント:「どうすれば……?」という質問では、まず パターンハブ の決定木を確認してください。
ローカルソースの参照
重要:実装する前に必ずローカルの Effect ソースを検索してください
Effect のソースコード全体は docs/effect-source/ にあります。Effect の各スキルには、「ローカルソースの参照」セクションが追加されており、以下が記載されています。
- そのスキルの領域に関連する主要なソースファイル
- 実装を見つけるための grep コマンドの例
- コーディング前に検索する手順
ソースへのクイックアクセス
- すべての Effect パッケージ:
docs/effect-source/ - コアライブラリ:
docs/effect-source/effect/src/ - プラットフォーム API:
docs/effect-source/platform/src/ - SQL:
docs/effect-source/sql/src/ - スキーマ:
docs/effect-source/schema/src/
例:Effect.gen を見つける
grep -F "Effect.gen" docs/effect-source/effect/src/Effect.ts
ワークフローのリマインダー
- 関連するスキルを読みます(上記の決定木から選択してください)
- スキルの「ローカルソースリファレンス」セクションを確認します
- 必要な API を Effect のソースコードから検索します
- 実装と型を調べます
- 実際の実装に基づいてコードを記述します
ソースリファレンスガイドの全文については、CLAUDE.local.md を参照してください
参考資料
- エージェントスキルの概要:エージェントスキルの紹介
- スキルガイド:Claude Code スキルのドキュメント
- ローカルパターンハブ:../effect-patterns-hub/SKILL.md(130 以上のパターン)
- パターンのドキュメント:../../docs/effect-patterns/
- AGENTS.md:../../AGENTS.md(AI エージェント向けの Effect のベストプラクティス)
- EffectPatterns(上流ソース):PaulJPhilp/EffectPatterns
コメント
Markdown 対応