Community编程与开发github.com

支付代码审查

审查 Java 或 Kotlin 支付代码(Spring Boot、Kafka、JPA)中导致资金丢失或重复的 bug - 因缺少幂等键导致的重复扣款、使用 double/float 表示的金额、因双写导致的事件丢失、非幂等消费者、自批准、缺少超时、日志中包含卡数据。运行内置扫描器,在代码中验证每个发现,然后执行手动检查清单。适用于审查创建、移动、批准、记账或对账付款、转账、退款、账本或余额的拉取请求或服务。

支付代码审查 是什么?

该技能专注于审查支付相关代码,识别可能直接导致资金丢失、重复或错误分配的严重缺陷。它针对在 Spring Boot、Kafka、JPA 及 Kotlin 等主流技术栈上运行的支付系统。技能内置了一个专用扫描器(使用 Python 3.10+),能够快速定位如浮点数金额、非幂等消费者、双写事件丢失以及日志记录敏感数据等高风险模式。扫描结果仅作为线索,技能要求审查者逐一阅读代码验证,剔除误报,最终生成以资金影响为最高优先级的报告。通过结合自动化扫描与强制手动检查清单(涵盖竞态条件、幂等键范围、状态机等扫描器无法检测的问题),该技能为支付服务提供了一种全面且注重实际风险的安全审查方法。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Vidhidesai12/payments-review-skill/tree/main/payments-code-review

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

支付代码审查 是做什么的?

找出支付代码中真正造成资金损失的 bug,并以金钱的角度解释每一个问题:谁被重复扣款、哪笔记账丢失、谁可以批准自己的转账。

工作流程

  1. 划定范围。 找出创建、移动、批准、记账或对账资金的代码:控制器、服务、监听器、实体、迁移。记录技术栈(Spring Boot、Kafka、JPA、Kotlin)。

  2. 运行扫描器 从本技能所在的文件夹针对项目或变更文件执行:

    python scripts/scan.py <代码路径>               # 输出 markdown 表格
    python scripts/scan.py <代码路径> --format json  # 供进一步处理
    

    需要 Python 3.10+,无需其他依赖。除非传入 --include-tests,否则它会跳过测试源代码。它通过启发式规则读取源码,因此输出是一系列线索。

  3. 通过阅读代码验证每一个发现。 对每一条线索,打开文件并确认:

    • 名为 amount 的 double 如果实际是百分比或比率,则不构成 PAY001。
    • 如果重复或四眼检查存在于扫描器跟踪范围(三次调用)更深的位置,则消费者或批准方法没有问题。跟踪下去并说明位置。
    • 剔除误报,并用一句话说明原因,以便读者信任其余结果。
  4. 执行手动检查清单 参见 references/checklist.md。其中对每条扫描规则给出了错误和正确示例,并列出了扫描器无法发现的内容:余额竞态、幂等键范围、重试加超时语义、状态机、对账、在途资金、审计和数据保护。只深入到当前审查代码所需的程度。

  5. 撰写报告 按照以下格式。以资金影响最大的问题开头。

报告格式

## 支付审查:<服务或PR>

**结论:** <一句话:可安全合并 / 修复后再合并 / 需要重新设计>

| # | 严重程度 | 位置 | 问题 | 资金影响 |
|---|---|---|---|---|
| 1 | 高 | `TransferController.java:24` | POST /transfers 缺少幂等键 | 客户端超时后重试会创建第二笔转账 |

### 1. <标题>
**为何重要:** <具体说明什么会出错,附带一个示例金额>
**修复:** <最小安全变更,附带简短代码片段>

### 已检查且无误
- <验证为正确的内容及其位置;确保审查诚实>

### 未涵盖
- <无法检查的内容,例如不在此仓库中的数据库约束>

审查规则

  • 严重程度基于资金影响。 高 = 资金可能丢失、重复或被错误的人转移。中 = 在故障或负载下可能发生。低 = 规范性问题。
  • 引用具体行,格式为 文件:行号,每个发现都必须如此。绝不报告未经确认的扫描器线索。
  • 优先选择最小的安全修复,例如添加唯一约束加 Idempotency-Key 请求头,而不是重写。当正确的修复是结构性的(如事务性发件箱)时,应明确说明。
  • 不要声称合规。 此审查并非 PCI DSS 或 SOX 审计;如果被问及,应明确说明。
  • 也要检查数据库。 许多保障应属于约束(UNIQUE、CHECK、触发器)。查看仓库中的迁移脚本(Flyway、Liquibase)。

相关技能