Add Beryl Agent and harness source

2026-09-08 20:10:03 +08:00
parent 06d72d001c
commit 47cfbcd66a
70 changed files with 12558 additions and 0 deletions
@@ -0,0 +1,22 @@
+---
+name: swads-weekly-report
+description: 通过 SW Ads MCP 为当前或指定账户生成最近七个完整业务日的只读周报图片。用户提及周报、每周投放报告或周报图片时使用。
+---
+
+# SW Ads 单图周报
+
+先调用 `swads_whoami` 确认账户身份、时区和币种，再调用 `metrics_catalog` 后查询最近七个完整业务日。禁止依据商品标题或品牌词猜测账户映射。
+
+报告必须包含账户核心指标及环比、Campaign/商品/素材要点、风险、局限和恰好 3 条数据支持的建议。区分平台原生归因与因果增量，低样本不下确定结论。
+
+必须构建“曝光 → 点击 → 购买”漏斗。TikTok Shop 不得直接采用账户汇总层可能为 0 的 `product_impressions`，必须查询同一日期、账户和归因口径下的完整素材明细，并按以下口径计算：
+
+- `商品曝光 = 所有视频素材行的 product_impressions 合计 + 所有 product_card:* 商品页行的 product_impressions 合计`。
+- `商品点击 = 所有视频素材行的 product_clicks 合计 + 所有 product_card:* 商品页行的 product_clicks 合计`。
+- 求和前按素材身份去重；同一 `external_creative_id` 的重复同步记录先按最低可用唯一组合键聚合。
+- 必须取全所有素材行，不得只汇总 Top N。结果截断时继续分页或改用能覆盖全量的聚合查询；无法取全或安全去重时显示 `N/A`，不得用部分数据冒充总量。
+- 漏斗说明必须分别列出视频贡献、商品页贡献和两者合计。订单必须保持相同范围和归因口径，不得跨粒度拼接。
+
+其他账户使用兼容的广告指标族。缺失、为零或无法安全去重时显示 `N/A` 并说明。
+
+最终必须调用 `save_report_image`，传入 `reportType: weekly`，生成且只交付 `swads-weekly-report.png`。任何预算、状态、目标、素材或投放结构修改只列入人工确认区，不执行。