它能做什么
- 下单、重拉起、查单、关单、退款与退款查询;
- 三套签名:请求
XD-Signature-v1、响应XD-Response-v1、事件XD-Webhook-v1; - Webhook 原始字节验签、
eventId去重与幂等落账; - 错误码分派、上线检查清单与密钥轮换。
怎么用
- 下载 Skill 包并解压;
- 把
skill/目录重命名为xiaodou-open-platform-integration/,放入编码助手的技能目录(Claude Code 示例:~/.claude/skills/或项目.claude/skills/;目录内必须有SKILL.md); - 用下面的示例提示词触发;其他工具直接指向
SKILL.md即可。
包里有什么
| 资产 | 路径 | 说明 |
|---|---|---|
| Skill 主文件 | skill/SKILL.md | 触发词、铁律、工作流与边界 |
| 参考文件 | skill/references/*.md | 签名、接口流程、Webhook、错误码、上线检查、密钥、终端矩阵 |
| 四语言示例 | examples/{node,java,php,python}/ | 请求签名、响应验签与事件验签参考实现 |
| golden 向量 | examples/README.md | 自检向量与运行命令 |
docs/ 与 demo/ 不在 Skill 包内:人读文档请下载文档包,本地演示在公开仓。
示例提示词
按小豆支付开放平台的 Skill,帮我实现下单 + Webhook 验签,使用 Node.js。检查我现在的请求签名实现,和 XD-Signature-v1 规范逐行对照。按上线检查清单逐条检查我的接入,列出未通过项。边界
- Skill 是资料包,不会自动替你上线,也不包含平台密钥;
- 示例代码是参考实现,不是官方 SDK;
- 生产首单仍需用真实小额订单验证;平台暂不提供沙箱。