Skills · Claude Code · Agent Skills
金額は最小単位の整数、課金は prd のみ。交渉の余地はありません。
決済状態は明示的なステートマシン、支払い確定は認証された PSP の経路のみ、台帳は不変の複式簿記で、照合は毎日行います。カードは PAN に触れず、本番以外で実課金は行いません。
schematize-payments · v0.2.1bash
$ schematize install payments譲れない最低基準
「速くするため」に外すことはできません。全リストはスキルをご覧ください。
prd 以外では課金しない
課金、返金、送金、税務書類はサンドボックスまたは検証環境のみ。環境が未設定なら prd 以外とみなし、本番キーは prd にだけ置きます。
金額は最小単位の整数
センタボと通貨で表し、float は使いません。分割や分割払いの合計は総額と一致させ、端数は決定的に処理します。
PAN には触れない
カード情報の取得は PSP 経由です。システムが見るのはトークン、ブランド、下 4 桁のみで、CVV は保存しません。目標は SAQ A です。
決済状態は明示的なステートマシン
遷移は純粋関数としてテーブルテストし、終端状態には戻らず、未知のイベントを支払い済みにしません。
支払い確定は認証された PSP 経路のみ
ブラウザのリダイレクトは UX であり証拠ではありません。金額と通貨は請求内容と照合します。
Webhook は認証・重複排除・再照会
生のボディに対する定数時間の HMAC または mTLS、イベント ID による重複排除、不可逆な処理の前に API へ再照会します。
作成はすべて冪等
呼び出しの前に鍵を永続化します（Idempotency-Key、PIX の txid、返金 ID）。タイムアウトは失敗ではありません。
不変の台帳と日次照合
追記専用の複式簿記、逆仕訳による訂正、台帳・PSP・銀行明細の照合を行い、例外には担当者と期限を付けます。
コマンド
.claude/commands/ にインストールされます。いつでも /pay-help を実行できます。
/pay-ccContext compact: handoff をアーカイブに書き出し、/compact を実行します。/pay-claude決済の基本ルールを定めた常時有効な CLAUDE.md をリポジトリのルートに作成またはマージします（他のスキルのブロックは上書きしません）。/pay-flow連携の前に、決済手段のフロー（状態、仕訳、冪等性）を設計します。/pay-handoffコンテキストの handoff（context.md + checklist.md）を、圧縮せずにアーカイブへ出力します。/pay-helpすべてのコマンドと、それぞれの役割を一覧表示します。/pay-load決済の規範を強制的にすべて読み込み、このセッションで適用します。/pay-reconcile台帳、PSP、銀行明細の日次照合を設計または監査します。/pay-review決済コードを基準に照らしてレビューします。ゲートを実行し、機械では読めない部分を人が読みます。/pay-sandboxprd 以外で課金が起きないことを証明します。fail-closed の環境、キー、テストダブル、合成データを確認します。/pay-webhookPSP の Webhook 受信側を作成または監査します。真正性、重複排除、順序、再照会を扱います。AIエージェント向け
人手を介さずにインストールできます。メタデータは llms.txt にあります。
- 実行: git clone https://github.com/schematizeme/skill-payments.git && ./skill-payments/install.sh
- またはダウンロード: https://github.com/schematizeme/skill-payments/releases/latest/download/skill-payments.zip を .claude/skills/ に展開
- assets/CLAUDE.md をリポジトリのルートにコピー（常時オンのルール）。
- /pay-help で確認。
ディスカッション
読み込み中…