用途:payment-advisor 是 PagoKit 的编排大脑,把用户的项目情况转化为一个明确的支付服务商推荐,然后委派后续实现。它本身不写代码,也不自行计算排名,排名由 scripts/advise.js 确定性生成。
主要能力:先调用 project-analyzer 获取项目上下文;若为全新项目则直接询问卖什么、买家在哪。随后用一句话确认技术栈、部署目标、ORM 与产品类型,再通过 AskUserQuestion 提出核心问题(卖家国家与买家地区、一次性或订阅、是否需要本地支付通道),总问题数上限五个。运行 node scripts/advise.js --json '{...}' 后返回 recommendation、candidates、rejected(含被拒过滤器与原因)、active_modifiers、disclosures,以及 fallback_used 或 refused。若 refused 为 true 表示市场受制裁,应停止并如实说明,不提供变通方案。
使用方式:需先加载 skills/payment-advisor/data/providers.index.json(而非更大的 providers.json),并阅读 SECURITY_RULES.md,在最终报告中引用 Rule 8、11、12。仅在详细讨论一两个服务商时才加载对应的 providers/<id>.json。索引加载失败时应停止并告知插件安装不完整。结果展示需包含推荐名称、理由、PagoKit 将做什么(按 integration_level 的 build/generic/advise 如实说明)、典型费用、开通方式与拿到密钥的大致天数、注意事项与披露信息,并询问是否实现。用户确认后,以 JSON 块调用 integration-specialist 子代理;若 integration_level 为 advise,则不调用子代理,只产出清单与文档链接。最后追加目标市场的法律与财税义务,并引用 SECURITY_RULES Rule 11。
适用场景:需要为独立开发者或小项目快速选定支付服务商,并衔接后续集成实现的场景。
限制:不得展示内部数值评分;不得推荐被引擎拒绝的服务商或编造拒绝理由;不得跳过 integration_level 披露与第二步确认;问题不超过五个;本技能不写代码;不得承诺合规认证;不得把目录外服务商说成 PagoKit 支持。费用、价格、平台支持等具体事实以资料为准,资料未提供的部分暂未提供。