VK Daily Campaign Triage

一个面向广告优化人员的 Codex Skill：读取 .xlsx / .csv / .tsv 投放日报，先确认 KPI、成熟日期和消耗目标，再从 Ad 层级划分学习期池与稳定期池，产出当天需要人工干预的对象、证据和可执行动作。

亮点：它不只报数。 针对 VK 广告生态，它会把 7/14 天趋势翻译成可以在平台中落实的优化指导，例如暂停差 Ad、预算回退观察、保护成熟赢家、拆分词包/受众假设、创建单变量素材测试，以及按 3 / 5 / 7 天决定去留和扩量。

它只做分析和建议，不会擅自修改 VK 或其他广告平台的预算、出价、状态和素材。

它解决什么

将当天获取指标与滞后成熟指标分开，避免用未成熟次留误判；
对学习期 Ad 按 3 / 5 / 7 天检查点排名和优胜劣汰；
对稳定期 Ad 按 S-优质 / A-稳定 / B-波动待优化 / C-劣质 排名；
结合近 7 天、前 7 天和 14 天证据识别偶发波动、持续恶化和成熟赢家；
输出暂停/降量、观察、恢复测试、扩量、新素材需求和预算缺口；
生成四段式 .docx 简报，保持 Ad 级视角，不输出 Campaign 排名。

为什么适合 VK 投放

普通日报往往只告诉你指标涨跌；这个 Skill 会进一步回答“今天具体动什么”：

数据现象	VK 可落地指导
新 Ad 同时上线，样本尚未成熟	放入同一学习池排名，按第3/5/7天优胜劣汰
扩量后连续成熟日恶化	回到最近稳定预算，保持其他变量不变，设定恢复测试退出条件
历史强组合重组后失效	分离素材疲劳与词包/受众变化，优先建立干净对照测试
原素材稳定但已投放较久	保护存量，不继续硬推；复制方向并只改变一个创意变量
有消耗缺口但没有成熟赢家	用有上限的新素材探索池补量，不把预算强塞给差 Ad
Ad 零消耗	提示检查 VK 审核状态、出价竞争力、受众规模和父级投放约束

每条建议都会尽量包含：对象、证据窗口、建议动作、保持不变的变量、预算影响、复查条件和退出条件。缺少预算、出价、状态或操作历史时，会明确标注限制，不会虚构精确的平台设置。

匿名日报模板预览

下图中的账户、Ad 名称、日期、数值和 KPI 阈值均为虚构内容：

安装

将仓库克隆到 Codex Skills 目录：

git clone https://github.com/joliehill294-hue/daily-campaign-triage.git \
  ~/.codex/skills/daily-campaign-triage

安装后重新启动 Codex。也可以在 Codex 中使用 $skill-installer，要求它从该 GitHub 仓库安装。

使用

在 Codex 中附上或提供报表路径，并明确调用：

$daily-campaign-triage 分析这份日报。KPI：CPI ≤ 5；D1次留成本 ≤ 35；
D1次留率 ≥ 14%；日消耗目标 500。输出 Word 到 ./output。

Skill 会先检查数据结构。若 KPI 的公式、方向、适用范围或成熟规则缺失，会先向你确认，绝不会从代码库或其他账户静默读取 KPI。以上调用中的阈值仅为虚构示例。

确定性工具

无需安装第三方 Python 包：

python3 scripts/analyze_report.py report.xlsx \
  --analysis-date 2026-08-25 \
  --retention-lag-days 1 \
  --output /tmp/report.analysis.json

python3 scripts/build_brief.py examples/brief.example.json \
  --output /tmp/example-brief.docx

第一个脚本只生成 Ad 级事实，不代替 Skill 做业务判断；第二个脚本将已经完成判断的 JSON 渲染为 Word。字段映射和 JSON 合同见 references/script-usage.md。

日报输出结构

是否达标
问题分析：学习期池排名、稳定期池排名
建议动作
近 7 天表现好的 Ads（严格筛选，允许少于 3 个）

仓库内的示例和模板均为匿名数据。.gitignore 默认排除真实 Excel、生成的 Word、分析 JSON 和本地交付配置。

验证

python3 -m unittest discover -s tests -v

还可以直接让 $skill-creator 验证当前目录中的 Skill 结构。

SKILL.md                    Skill 主说明
agents/openai.yaml          Codex 展示元数据
references/                 输入、决策、排名、输出与交付合同
scripts/analyze_report.py   CSV/TSV/XLSX 事实归一化
scripts/build_brief.py      DOCX 生成器
examples/                   匿名 JSON 示例
assets/                     GitHub 日报 PNG 预览
tests/                      标准库自动化测试与匿名 fixture

隐私与安全

不要提交真实广告报表、账户名称、个人绝对路径或生成的客户简报；
不要把固定 KPI 写进 Skill，KPI 必须由每次任务或本地配置提供；
所有建议仍需人工确认，本 Skill 不执行平台变更。

License

MIT

5.0 KiB Raw Blame History Unescape Escape