使用 AI 对接

我们提供一份接入 Skill，把签名算法、测试向量、资金规则和回调要求整理成 AI 工具可以直接读取的说明。装上以后，Claude Code、Codex 等 AI 编程工具在写接入代码时会自动遵守这些规则。

什么是 Skill

Skill 是一个 SKILL.md 文件，开头有名称和用途说明。AI 工具在处理相关任务（例如“实现明爵的签名”“写单一钱包回调”）时，会自动加载它。

这份 Skill 包含：

• 签名算法、两类回调密钥，以及可以直接写成单元测试的签名向量；
• 所有商户 → 平台接口的要点；
• 单一钱包 4 个回调接口的实现要求，以及开通前的 8 步核验；
• 资金安全规则：超时查单、永久幂等、不换 ID；
• 上线检查清单。

下载

下载 SKILL.md

安装

Claude Code

# 放到项目中（推荐，团队共享）
mkdir -p .claude/skills/mingjue-integration
mv ~/Downloads/SKILL.md .claude/skills/mingjue-integration/SKILL.md

Codex

# 放到 Codex 的 skills 目录
mkdir -p ~/.codex/skills/mingjue-integration
mv ~/Downloads/SKILL.md ~/.codex/skills/mingjue-integration/SKILL.md

其他 AI 工具如果不支持 Skill，可以把 SKILL.md 的内容放进项目的说明文件（例如 AGENTS.md），或者在对话开始时直接发给它。

使用示例

安装后直接用自然语言描述任务：

用 Go 实现明爵 API 的请求签名，并用文档里的签名向量写单元测试。

按明爵单一钱包规范，在我们的钱包服务里实现 /v1/wallet-transactions 和查单接口，
使用 PostgreSQL，余额变化和交易记录放在同一个事务里。

检查这段转账代码：超时以后会不会换新 external_id 重试？

常见问题

AI 生成的代码可以直接上线吗？ 不可以。请人工审查，并通过联调与上线中的检查清单。单一钱包还必须通过平台的回调核验。

Skill 和文档不一致时以哪个为准？ 以本站文档和 API Reference 为准。Skill 会随文档一起更新，请定期重新下载。

可以把密钥发给 AI 吗？ 不可以。不要把真实密钥、完整签名或玩家数据发给 AI。让 AI 从环境变量读取密钥；测试时使用文档里的示例密钥。