Skills · Claude Code · Agent Skills
金额用分,扣款只在 prd,没有商量余地。
支付状态是显式状态机,只有经过认证的 PSP 通道才能确认已支付,账本为不可变的复式记账,并且每日对账。银行卡不接触 PAN,非生产环境绝不发生真实扣款。
schematize-payments · v0.2.1bash
$ schematize install payments不可妥协的底线
不会为了"更快"而关闭。完整清单见该 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 确认。
讨论
加载中…