mcpField
D
dinero-currency-patterns

dinero-currency-patterns

github.com/dinerojs開発2345 回インストール35 週間前に更新
リポジトリ

dinero-currency-patterns について

Dinero.js で通貨を扱う開発者向けのパターン集です。型安全、換算、データベース保存、決済サービス形式への対応を扱います。

主な機能

  1. 01型安全な独自通貨の定義
  2. 02通貨コードの検証
  3. 03スケーリング値による換算
  4. 04データベース保存パターン
  5. 05決済サービス形式への変換

活用シーン

  1. 01独自通貨型の定義
  2. 02小数の為替レートでの換算
  3. 03複数通貨の金額をデータベースに保存
  4. 04Dinero オブジェクトを決済形式に変換

インストール

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

$npx skills add https://github.com/dinerojs/skills --skill dinero-currency-patterns

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

同梱ファイル

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

rules/
_sections.md
convert-reusable.md
convert-scaled-rates.md
payment-services.md
storage-database.md
storage-no-money-type.md
types-as-const.md
types-currency-mismatch.md
types-lookup-validation.md

詳細

Dinero.js の通貨パターン

Dinero.js で通貨を扱うためのパターンです。型安全性、換算、カスタム通貨、データベースへの保存、決済サービスとの連携について説明します。

適用する場面

次の場合に、これらのガイドラインを参照してください。

  • convert で通貨を換算する場合
  • カスタム通貨（暗号通貨、ロイヤルティポイントなど）を定義する場合
  • 外部入力から通貨を動的に検索する場合
  • 金額をデータベースに保存する場合
  • 決済サービス（Stripe、PayPal、Square）と連携する場合

優先度別のルールカテゴリ

優先度カテゴリ影響度プレフィックス
1型安全性高types-
2換算高convert-
3保存高storage-
4決済連携中payment-

クイックリファレンス

1. 型安全性（高）
  • types-as-const - コンパイル時の安全性を確保するため、as const satisfies でカスタム通貨を定義します
  • types-currency-mismatch - TypeScript により、操作時の通貨の不一致をコンパイル時に検出できます
  • types-lookup-validation - 外部ソースから取得した通貨コードを実行時に検証します
2. 換算（高）
  • convert-scaled-rates - 小数の為替レートには浮動小数点数ではなく、スケーリングされた金額を使用します
  • convert-reusable - 高階関数のパターンを使って、再利用可能な換算関数を作成します
3. 保存（高）
  • storage-database - 金額、通貨コード、スケールを別々の列に保存します
  • storage-no-money-type - 複数通貨を扱うアプリケーションでは、PostgreSQL の money 型を避けます
4. 決済連携（中）
  • payment-services - 専用のヘルパーを使って、Dinero オブジェクトを決済サービスの形式に変換します

使い方

詳しい説明とコード例については、個々のルールファイルをお読みください。

rules/types-as-const.md
rules/convert-scaled-rates.md

各ルールファイルには、以下が含まれます。

  • 重要である理由の簡単な説明
  • 説明付きの誤ったコード例
  • 説明付きの正しいコード例
  • 追加の背景情報と参考資料

コメント

Markdown 対応