alipay-subscription-skill

Claude Code Skill —— 支付宝订阅产品商家接入指南。

安装后通过 postinstall 自动把 skill 放入 Claude Code 的 skills 目录 （~/.claude/skills/alipay-subscription/），无需手动拷贝。重启 Claude Code 后， 当你询问支付宝订阅、自动续费、团体席位订阅、试用期/优惠券、消息通知、退款等问题时， 该 skill 会被自动触发加载。

skill 内容包括：

• SKILL.md —— 接入指南主文档（API 规范、个体/团体订阅、营销工具、低代码与 API 两种接入、服务商代开发等）
• references/ —— API 完整文档、示例代码（Java/Go）、数据模型、测试推进、排障等参考材料

安装

一条命令完成全局安装 + 选择目标客户端：

npx alipay-subscription-skill

运行后：

1. 自动全局安装：若本包尚未全局安装，会先执行 npm i -g alipay-subscription-skill（已装则跳过）。
2. 交互式选择目标：用 ↑/↓ 移动、空格 切换勾选、a 全选、回车 确认，可同时勾选：
   • Claude Code → ~/.claude/skills/alipay-subscription/
   • Codex → ~/.codex/skills/alipay-subscription/
3. 复制 skill：把 SKILL.md 和 references/ 写入选定目录（已存在则覆盖）。

重启对应客户端（Claude Code / Codex）后即可使用。

跳过交互（CI / 脚本）

npx alipay-subscription-skill --all        # 装到 Claude Code + Codex
npx alipay-subscription-skill --claude     # 只装 Claude Code
npx alipay-subscription-skill --codex      # 只装 Codex

全局安装也可直接 npm i -g alipay-subscription-skill，之后会提示运行上述命令选择目标； 安装器本身已包含全局安装步骤，所以 npx 一条命令通常就够了。

自定义 skills 目录

若你的 skills 目录不在默认位置，用环境变量指定：

CLAUDE_SKILLS_DIR=/path/to/claude/skills \
CODEX_SKILLS_DIR=/path/to/codex/skills \
  npx alipay-subscription-skill --all

升级

npx alipay-subscription-skill@latest

安装器会以新版本覆盖旧目标目录，升级幂等。若已全局装过旧版，也可先 npm i -g alipay-subscription-skill@latest 再 npx alipay-subscription-skill 重新选目标。

卸载

npm uninstall -g alipay-subscription-skill

postuninstall 会自动移除 ~/.claude/skills/alipay-subscription/ 和 ~/.codex/skills/alipay-subscription/。如需手动清理，直接删除对应目录即可。

维护与发布（面向 skill 作者）

skill 源码与 git 仓库同根（alipay-subscription/）。日常更新流程：

# 1. 编辑 skill 内容（SKILL.md / references/）
# 2. 一键发布：自动 bump 版本 + git 同步 + npm 发布
cd alipay-subscription
npm run release              # 默认 patch
npm run release -- --minor   # minor
npm run release -- --major   # major
npm run release -- 1.2.0     # 显式版本号

# 预览（不改动文件、不发 git/npm 写操作）
npm run release -- --dry-run

npm run release 依次执行：

1. 校验 npm 登录态（npm whoami），未登录请先 npm login
2. 计算、写回 package.json 版本号
3. git add -A && git commit + git tag vX.Y.Z
4. git push origin <branch> 并推送 tag（同步到内部 git 仓库）
5. npm publish（发布到公开 npmjs.org）

若某一步失败，脚本会打印「下一步手动命令」便于续跑；git 已同步、仅 npm 失败时， 直接运行 npm publish 即可。

验证包内容

发布前可用 dry-run 检查 tarball 只含必要文件：

npm pack --dry-run
# 应仅含：SKILL.md / references/ / scripts/ / package.json / README.md

License

MIT