用途:设计 SaaS 权益引擎,统一回答“该租户被允许做什么”,替代散落的 if tenant.plan == 'pro' 判断;支持企业合同定制覆盖而不分叉代码库,并将门控与产品内升级引导(PLG)结合。要求先有套餐目录、定价模型、待门控功能与限额清单、覆盖策略等输入。
主要能力:区分权益(套餐允许什么,长期、按租户、可审计)与功能开关(灰度与实验,短期、按用户或队列,默认关闭),两者运行时应分离。权益解析三个输入:套餐基线、合同覆盖、附加项,优先级为覆盖 > 附加项 > 套餐基线,试用期通常继承目标套餐权益。回答布尔型功能门控与周期限额两类问题。
使用方式:先通读 SKILL.md,区分权益与功能开关,设计数据模型(plans、features、plan_features、limits、plan_limits、租户功能/限额覆盖、addons、addon_features、addon_limits、tenant_addons、tenant_usage_counters),选择解析策略(JWT 内嵌、运行时查库、Redis 缓存加回退或混合;默认布尔检查走 JWT,限额检查走 Redis 原子计数,15 分钟重发 JWT,套餐或覆盖变更时失效 JWT 并发 entitlements.changed 事件),在 UI、API、worker、DB 约束处放置门控,接入升级发现 UX 与覆盖机制,并埋点命中与拒绝用于 PLG 分析。API 门控可用 @require_entitlement(feature='api_access') 与 @require_within_limit(limit='api_calls_monthly') 等装饰器;拒绝响应返回 ENTITLEMENT_REQUIRED、feature、message 与 upgrade_url。
适用场景:SaaS 套餐门控、企业合同定制权益、附加项与超额、PLG 升级引导、门控拒绝分析。
限制:不适用于 Stripe 计费原语、实验功能开关、租户数据隔离、企业 SSO/SCIM 等任务,应分别使用对应技能;权益解析热路径 p99 应小于 5ms,限额检查须与动作原子化,覆盖须写审计日志,拒绝须携带升级信息;AI 相关权益键与网关强制另有专门技能。具体实现细节与价格信息暂未提供。