mcpField
E
effect-ts

effect-ts

github.com/blogic-cz開発375 回インストール1 週間前に更新
リポジトリ

effect-ts について

effect-tsは、Effectのサービス、レイヤー、エラー、設定、ランタイム統合に関する開発やレビュー向けのスキルです。現在の推奨事項とプロジェクトの資料を参照し、実装やテストを導きます。

主な機能

  1. 01Effectの作業に応じた資料選択
  2. 02effect-solutionsによる最新推奨事項の確認
  3. 03サービスとレイヤー設計ルールの適用
  4. 04エラー処理とランタイム統合の指針
  5. 05レビューと検証要件の提示

活用シーン

  1. 01Effectサービスの実装やリファクタリング
  2. 02レイヤー接続やランタイム動作の調査
  3. 03型付きエラーや境界マッピングのレビュー
  4. 04Effectコードのテスト計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/blogic-cz/blogic-marketplace --skill effect-ts

インストール後、Claude Code で/effect-tsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
agent-tools-patterns.md
error-handling.md
framework-integration.md
services-and-layers.md
testing-layers.md

詳細

Effect エキスパート

Effect のサービス、レイヤー、スキーマエラー、設定、ランタイム統合を扱う際は、このスキルを使用してください。

読み込みのトリガー

次の場合に、このスキルを読み込んでください。

  • ユーザーが Effect、Layer、Context.Tag、Schema.TaggedError、Effect.gen、または Effect.fn に言及した場合
  • Effect のサービス、レイヤー、ランタイムの境界を定義するファイルを実装またはレビューする場合
  • Effect のランタイム動作、スパンの欠落、レイヤーの接続、境界でのエラーマッピングをデバッグする場合
  • Effect コードのテスト戦略が必要な場合（@effect/vitest、テストレイヤー）
  • Effect のランタイム統合が必要な場合（TRPC／サーバーの境界）

最初の手順（必ず実行）

本格的な実装、リファクタリング、正式なレビューの前に、最新の推奨事項を取得してください。

effect-solutions list
effect-solutions show tsconfig
effect-solutions show basics
effect-solutions show services-and-layers
effect-solutions show data-modeling
effect-solutions show error-handling
effect-solutions show config
effect-solutions show testing
effect-solutions show cli

effect-solutions CLI を利用できない場合、またはタスクが些細な場合（たとえば、Effect の設計に影響しない簡単な文言の修正）は、CLI の呼び出しを省略し、このスキルの関連するリファレンスファイルを参照してください。

推奨事項は時期によって変わるものとして扱ってください。古い記憶に頼らないでください。

判断ツリー

  • サービスの設計またはリファクタリング -> references/services-and-layers.md
  • 型付きエラー、Option／Either、リカバリー -> references/error-handling.md
  • TRPC／サーバーのランタイム境界 -> references/framework-integration.md
  • agent-tools/* の CLI ツール -> references/agent-tools-patterns.md
  • テストとモック -> references/testing-layers.md

プロジェクトのルール（必ず守る）

  • サービスを同じファイルにまとめる（Context.Tag と静的な layer）
  • ドメインエラーには Schema.TaggedError を使用する
  • Option／Either の内部に _tag 経由でアクセスしない。ヘルパー（match、isNone、isLeft）を使用する
  • Effect の依存関係は vi.mock() ではなく Layer でモックする
  • エントリーポイントには、明確な provide 境界を 1 つだけ設ける

出力に関する要件

本格的な実装／レビュー／デバッグタスクでは、次の内容を返してください。

  1. 確認した effect-solutions show ... のトピック
  2. 使用したリファレンスファイルと、その理由
  3. 既存のプロジェクトパターンに沿った具体的な変更案
  4. 検証計画（型チェック／テスト）

リファレンス一覧

  • references/services-and-layers.md
  • references/error-handling.md
  • references/framework-integration.md
  • references/agent-tools-patterns.md
  • references/testing-layers.md

コメント

Markdown 対応