SuperAPI AI 工具集

outcomes-ledger

营销与增长

查看项目

更新于 10-27 11:24

技能介绍

outcomes-ledger 是营销类 playbook 的共享步骤技能(SKILL.md),被 research-audience、write-outreach 和 work-with-creators 加载使用。它的核心作用是:playbook 把整理好的名单交给人在 GooseWorks 外部执行(发邮件联系潜在客户、联系创作者),本技能负责把这些实际结果回写进品牌账本,使下一次运行不会重复联系已经明确拒绝的人,并能从有效做法中改进。它不联系任何人,也不强制要求结果——没有结果就跳过相关步骤继续运行。

主要能力

一、维护账本文件。潜在客户账本为 research/audience/ledger.csv,创作者名册为 creators/roster.csv。每条记录包含必需列,顺序为:row_type、key、key_hash、name_or_handle、account_or_platform、date_listed、list_id、status、status_date、suppressed、suppressed_reason、suppressed_date、recheck_by|revet_by、outcome、notes,之后是实体专有列,再之后是加载它的 playbook 自己的列。回写时不得删除任何列,未知列原样保留。key 取第一个可用匹配键:人对应用 email,否则 profile URL,否则 name + root domain;创作者用 platform:handle。

二、状态体系。潜在客户状态包括 listed、contacted、replied、meeting、not-a-fit、bounced、unsubscribed、do-not-contact;创作者状态包括 shortlisted、contacted、replied、quoted、declined、signed、posted、never-again。bounced、unsubscribed、do-not-contact、never-again 为永久抑制状态;not-a-fit 为限时排除(6 个月后重新可纳入);序列结束仍无回复的 contacted 有 12 周全渠道冷却期;declined 一直跳过直到人工重新开启。

三、每次运行、在新增名单抓取前先读账本。账本不存在则按表头创建。对超过 recheck_by / revet_by 且尚未联系的记录,用一句话提醒人工(重新核验属于付费步骤,由 spend-gate 技能处理)。在所有运行结尾的决策环节只问一次是否有结果可报告(回复、会议、退信、退订、拒绝、报价等),绝不要求提供;创作者超过波次阅读窗口时还会询问浏览量、其代码或链接的订单量以及是否已发布。

四、结果匹配与更新。按匹配键顺序(email 或 email_candidate → profile URL → name + root domain;账户行用 root domain + route;创作者用 handle + platform → profile URL)把报告的结果对应到记录;无法匹配的行原样反馈,不猜测归属。更新 status、status_date、outcome;对人还更新首次联系日期 first_touch_date(首次发送报告后永不覆盖)、last_touch、reply_category,以及“现在不行、以后再试”回复对应的 recontact_after;创作者报告报价时更新 quoted_rate。波次结果按 wave_criterion 评分为 win、partial、miss 或 no-data。

五、排除集与抑制。把完整排除集交给加载它的 playbook:所有被抑制的 key_hash、所有生效中的限时排除(包括 recontact_after 未到的记录),以及已列出且尚未解决的 key,避免下一批重复。被抑制的行只保留 key_hash、suppressed、suppressed_reason、suppressed_date、list_id,其余个人字段清空,从而实现永久抑制且不保留个人联系方式。key_hash 为规范化 key 的 SHA-256(十六进制,前缀 sha256:)。对于不在账本中的地址发来的退订、投诉或退信,只建一条仅含哈希、原因和日期的抑制记录。

六、经验与建议。仅在有结果回来时生成 lessons:按实体分组比较回复率、会议率,或创作者的回复、报价区间、发布率及波次结果。样本量规则:人——某组联系数低于 50 只给计数和观察点,不评判比率;50 以上但正面回复不足约 10 条标注“仅供参考方向”;创作者——某组不足约 5 条标注“仅供参考方向”。经验文档保存到实体目录下的 lessons 文件,并通过 save-to-brain 技能另存为带日期的品牌文档(保留历史,标签为 playbook 与 lessons),只含数字和分组,不含姓名、邮箱、handle 或联系方式等个人数据。对加载它的 playbook 自身规则(信号权重、分段、负面 ICP、角色、层级、价格区间、审核权重等)的修改建议须经人同意后才生效。经验仅在通过 save-learning 技能写入时才成为品牌学习项,每条一个想法,并以其各自的前缀标注来源。

七、与 run-memory 的配合。账本保存逐行事实(每人的状态、日期和结果);运行记录只保存摘要(按上述分组的计数与比率及统计窗口)和账本路径,绝不保存任何行、键、姓名、邮箱、handle 或 profile URL。每轮的“自上次以来”数字从账本重新计算,不复制上次记录;重算结果与上次记录不一致时以账本为准,并在新记录中标注“restated: ”。

八、保留策略。date_listed 后 12 个月内从未联系的记录从账本删除;抑制记录以哈希形式永久保留;删除数量需告知人工。

使用方式

随对应的营销 playbook 加载,由 playbook 设置实体参数(person 或 creator)。若品牌有 coworker 工作区(file_* 作用于品牌_read 列表中的 coworker_agent_id),则在其工作区中操作;没有 coworker 时使用默认工作区,所有路径加前缀 brands/<brand-slug>/,并需告知人工团队成员看不到它。文件写入会整体替换文件,因此必须先读账本、修改行、再完整写回。每次 playbook 向人展示的每一行(包括样本行)都在展示当时入账,而不只在移交时入账;若人随后否决了样本定义,这些行标记为 listed-sample-rejected 且之后不被排除。

限制

不联系、不发送、不凭代理自身推断把某行标记为已联系;不以结果作为继续运行的前提;不为凑名单规模而移除抑制记录;不把个人联系数据移入 brain。新增实体(其他 playbook 想要账本)需由其所有者在本技能中补充表行,加载前先询问。宿主无法计算哈希时,不存储地址,建议人工将其加入其发送工具的抑制列表,并询问一次是否在此保留原始地址以维持屏蔽,仅在同意后存储并标记。