SuperAPI AI 工具集

autumn-catalog

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

用途:帮助把用户的定价意图翻译成 Autumn 的数据模型(功能 + 方案 + 方案项),用于设计或变更定价方案,以及处理用量如何授予或计费。使用前需先加载 autumn-concepts 技能,它定义 Autumn 的数据模型,是所有建模决策的基础。

主要能力与流程:建模是迭代过程,应先提出澄清问题、不假设行为,例如确认付费项是按用量计费还是预付、计量额度在什么间隔重置。若某个模糊点会决定后续问题的适用性,应先解决它。对于新的代码库管理目录,可询问用户是否用 atmn 创建、拉取、预览和推送目录,除非用户明确想用仪表盘或 API 优先,否则推荐 atmn。对于已有项目,检查是否存在 autumn.config.ts;存在则视为本地目录源并优先用 atmn,否则直接用 MCP/API 工具,或先询问是否初始化/拉取配置。ID 应使用小写下划线(如 pro_plan、chat_messages)。不要为同一资源创建重复功能,而应通过方案项变化额度、间隔或价格。初始保持简单,功能多时先建最重要的(优先计量类),确认后再增加。

更新目录:遵循与 atmn 和仪表盘相同的“预览—决策—应用”模式:构建或编辑目标目录形态;用 atmn 或 catalog.preview_update 预览;先汇总功能变更(创建、更新、跳过、删除/归档、被阻止的更新);对每个变更的基础方案或方案族,展示方案差异、客户影响、版本选择、变体、冲突与迁移选项;若用户改变任何决策,就修改配置或参数并再次预览;只应用与预览完全一致的更新,遵循全局写入审批规则(catalog.update 或 atmn --headless push --yes)。对含客户或变体的方案族,按顺序询问:版本选择(新建版本、以 disable_version: true 更新当前版本、以 all_versions: true 更新所有版本,或跳过);变体(检查 plan.variants[n].update_source,传播型变体需选择传播方式,直接型变体像独立方案一样更新,可能需要自己的版本与迁移决策);迁移(是否创建迁移草稿把现有客户迁到新方案形态)。

规则:永远不要给默认/自动启用的方案设置付费价格,其基础价格必须为 null,方案项不得含付费的预付或按用量价格;按单位定价(如每席位 $X)始终把基础费放在 Plan.price 上并搭配按单位方案项,不能只有按单位价格而无基础费;命名衍生方案用变体(年/月间隔、A/B 价格包、不同量级阶梯);Enterprise/自定义方案不在此处理,它们在仪表盘中按客户创建。

目录操作与定价模式:修改现有目录、预览变更、在版本、就地更新、迁移与变体传播间做选择时,读 references/catalog-update.md;使用 atmn、autumn.config.ts 或无头推拉流程时,读 references/atmn.md;建模年/月变体、A/B 方案变体或量级阶梯变体时,读 references/plan.md。建模对应模式时加载匹配参考:超额按用量付费读 references/usage-based-pricing.md;预付购买数量读 references/prepaid-pricing.md;按量阶梯定价读 references/volume-based-tiers.md;每单位 $X 定价(始终带基础费)读 references/per-unit-pricing.md;多个操作共享一个计量表读 references/credit-systems.md;免费或默认方案读 references/free-plans.md;定期订阅读 references/recurring.md;一次性购买或充值读 references/one-off-purchases.md;为方案添加试用读 references/trials.md。

限制:资料未提供 Autumn 的收费、价格、平台支持范围或具体 API 字段细节;上述流程与规则以现有资料为准,实际效果、可用性和完整字段需以官方文档与实际环境为准。