Skills · Claude Code · Agent Skills

金额用分,扣款只在 prd,没有商量余地。

支付状态是显式状态机,只有经过认证的 PSP 通道才能确认已支付,账本为不可变的复式记账,并且每日对账。银行卡不接触 PAN,非生产环境绝不发生真实扣款。

v0.2.1Disciplina · Pagamentos BRgithub.com/schematizeme/skill-payments

维护者 Lucas Andrade

schematize-payments · v0.2.1bash
$ schematize install payments
GitHub →下载技能 (.zip)/payments-help · github.com/schematizeme/schematize-cli

不可妥协的底线

不会为了"更快"而关闭。完整清单见该 skill。

绝不在 prd 之外扣款

扣款、退款、分账和税务单据只在沙箱或验证环境进行;环境缺失即视为非 prd,生产密钥只存在于 prd。

金额是最小单位的整数

以分加币种表示,绝不用 float;各部分之和(分账、分期)等于总额,余数按确定性规则处理。

绝不接触 PAN

由 PSP 采集;你的系统只看到令牌、卡组织和后 4 位,CVV 绝不存储。目标是 SAQ A。

支付状态是显式状态机

状态转换是经表格测试的纯函数,终态不可回退,未知事件绝不变成已支付。

只有经认证的 PSP 通道才能确认支付

浏览器跳转只是体验,不是证明;金额和币种需与扣款记录核对。

Webhook 需认证、去重并回查

对原始请求体做恒定时间的 HMAC 或 mTLS,按事件 ID 去重,并在不可逆操作前回查 PSP 的 API。

每次创建都幂等

在调用前持久化键(Idempotency-Key、PIX 的 txid、退款 ID);超时不等于失败。

不可变账本与每日对账

仅追加的复式记账,用反向分录更正,并在账本、PSP 与银行对账单之间对账,异常项有负责人和期限。

命令

安装在 .claude/commands/。随时运行 /pay-help。

/pay-ccContext compact:把 handoff 写入 archive 并运行 /compact。
/pay-claude在仓库根目录创建或合并常驻的 支付基线 CLAUDE.md(不会覆盖其他 skill 的区块)。
/pay-flow在集成之前设计支付方式的流程(状态、分录、幂等性)。
/pay-handoff在不压缩的前提下,把上下文 handoff(context.md + checklist.md)写入 archive。
/pay-help列出所有命令及其作用。
/pay-load强制加载支付的全部规范内容,并在本次会话中应用。
/pay-reconcile设计或审计账本、PSP 与银行对账单之间的每日对账。
/pay-review对照基线审查支付代码:运行门禁,再人工阅读机器读不到的部分。
/pay-sandbox证明 prd 之外不会发生扣款:失败即关闭的环境、密钥、测试替身与合成数据。
/pay-webhook创建或审计 PSP 的 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 确认。

不想安装?

阅读完整规范并直接复制到你的项目——或安装该技能,让智能体自动执行。