@35m/skill

Claude CodeSkill 文件。 装上之后,当你在 Claude Code 里说"加微信支付" / "加收款" / "payment integration" 这类话,Claude 会自动加载 35pay 的接入指南,按最小模板帮你接 —— 不再需要每次贴文档链接。

Skill 是"AI 编码时的引导",运行时不参与。如果你想让 AI 在对话里实际执行 35pay 操作(创建支付、查会话、退款),看 @35m/mcp@35m/cli

安装

SKILL.md 放到 Claude Code 的 skills 目录就行。

全局(所有项目可用)

mkdir -p ~/.claude/skills/35pay
curl -o ~/.claude/skills/35pay/SKILL.md \
  https://raw.githubusercontent.com/guo2001china/35m-sdk/main/packages/skill/SKILL.md

项目内(仅当前 repo)

mkdir -p .claude/skills/35pay
curl -o .claude/skills/35pay/SKILL.md \
  https://raw.githubusercontent.com/guo2001china/35m-sdk/main/packages/skill/SKILL.md

Claude Code 监听 skills 目录,文件添加 / 修改即时生效,无需重启。 但如果是第一次创建 ~/.claude/skills/ 或项目内 .claude/skills/ 目录 (之前完全不存在),需要重启一次 Claude Code 让它把这个目录加入监听。


触发词

Claude Code 看到下面这些信号会自动加载这个 skill:

  • 消息里出现:加支付 / 接微信支付 / 收款 / 支付集成
  • 消息里出现:payment integration / checkout / Stripe alternative
  • 仓库代码里出现 import '@35m/sdk' / from pay35(Claude 主动浏览代码时)

里面有什么

SKILL.md 是个浓缩版接入手册,覆盖:

  • 关键事实(资金不过手 / sk_test_ 自动 mock / 切换通过 env)
  • 最小集成模板(lib/pay.ts + 创建支付 + webhook handler,三段代码)
  • 商户端配置 checklist(手机登录 / 配 provider / 创建 key / .env 怎么填)
  • 测试方法(无需任何真凭证)
  • 四种语言 SDK 的选用(TS / Python / Go / 其他走 REST)
  • 常见错误对照表(provider not configured / 验签失败 / openid 必需 等)
  • "不应该做的"(前端塞 sk_ key / 绕过验签 / webhook handler 内联重逻辑)

实际效果

装好之后,在 Claude Code 里说:

你: 帮我给这个 Next.js 项目加微信支付

Claude: [自动加载 35pay skill]
       我用 @35m/sdk 帮你接,几步:
       1. npm i @35m/sdk
       2. 新建 lib/pay.ts
       3. server action createCheckout
       4. /api/webhooks/pay route 处理回调
       5. .env

       要不要我直接写?记得测试期用 sk_test_ 不需要配真微信凭证。

Claude 不会乱给你接 Stripe / 自己写 WeChat SDK,因为 skill 已经把"35pay 是怎么用的"喂给它了。


三件套对比

三个 AI / Agent 包面向不同场景,互不冲突,可以同时装:

  • @35m/skill(本页) — Claude Code 写代码时知道该怎么接。装一次,新项目自动用。
  • @35m/cli — shell 命令,让带 shell 的 agent(Claude Code 自己 / Aider / 任何自动化脚本)能实际执行 35pay 操作。
  • @35m/mcp — IDE / 桌面 AI 助手(Claude Desktop / Cursor / Zed)在对话里直接调 35pay。

源码

SKILL.md 全文在 github.com/guo2001china/35m,欢迎 fork 改成你团队内部的版本(加上私有的 baseUrl / 内部约定)。