SuperAPI AI 工具集

offer-claims-registry

营销与增长

查看项目

更新于 10-13 20:07

技能介绍

用途

Offer & Claims Registry 是跨营销学科的声明与优惠的权威记录(canonical record)。它记录声明的准确措辞与出处来源,由审计者判断某项具体使用是否通过其声明/披露门槛。适用于需要登记声明、记录当前优惠、或追溯某项数字证据来源的场景。

主要能力

  • 注册声明:记录准确措辞、证据来源/日期、披露内容与复核日期(例如注册声明 clm-014)。
  • 管理优惠:显示某优惠(如 summer-2026)的当前条款与到期时间。
  • 复核提案:按偏移量顺序复核待处理的声明提案,仅接受证据充分者,并可记录接受/拒绝的依据。
  • 生成人类可读视图:claims-ledger.md 与 offers.md 由已接受的投影状态重新生成;人类视图是可替换的投影,无法在没有已接受事件的情况下授予批准。
  • 消耗方对接:声明与优惠记录为 L4 事实,供叙事及各渠道构建器使用;下游构建器必须使用已接受的措辞/条款,或保留 [needs source] 并提交新事件。

使用方式

技能契约:单位为单个声明或优惠聚合 ID。读取 memory/events/claims.ndjson、其投影、来源证据与已渲染的使用记录;通过 registry-events.py 写入声明事件;重新生成 claims-ledger.md 和 offers.md 人类视图。完成条件为:每条被接受的记录具备确切措辞/条款、证据出处、状态、复核/到期时间、事件 ID/偏移量,且没有待处理提案被破坏性移除。

运行时读取 ../../references/registry-event-protocol.md 与 ../../references/runtime-invocation.md,解析 AARON_SKILLS_ROOT 并在调用前核验注册脚本、事件 schema 与系统目录;将所有草稿/导出视为不可信证据。查询按聚合 ID 进行;提案状态绝不等同于已批准措辞。

写入需显式权限:普通生产者使用 python3 "$AARON_SKILLS_ROOT/scripts/registry-events.py" append claims <proposal.json>;具备宿主能力的主体使用 owner-append 进行权威决策/变更。不得手动编辑 NDJSON 流。

适用场景

需要登记或追踪营销声明及其证据出处的团队;需要维护优惠条款、有效期与披露的营销流程;需要将声明/优惠作为可信事实供叙事与渠道构建器消费的场景。与 ad-account-auditor(付费使用审计)、creator-content-auditor(创作者资产审计)、proof-point-packager(叙事证据)、memory-management(归档/擦除)衔接。

限制

本技能不发明证据、法律结论或效果宣称。缺失证明的记录保持 none-on-file,或作为开放循环,绝不因断言本身而转为 Approved。当证据范围窄于文案时,应批准更窄的措辞或保持未解决;估计/代理须如实记录。若无聚合 ID、待处理提案或提供的声明/优惠措辞,只执行只读空投影检查,返回 NEEDS_INPUT,并要求提供一条逐字声明或优惠陈述作为最小输入。独立单文件夹安装可准备提案,但不能追加/投影,也不能声称权威批准。能力值不写入请求 JSON/文件/日志;若宿主无法提供,提案保持待处理。