Add SKILL.md

Add SW Ads daily report skill
2026-09-02 10:11:25 +08:00
commit 87f8d1820d
1 changed files with 37 additions and 0 deletions
@@ -0,0 +1,37 @@
+---
+name: swads-daily-report
+description: Generate a read-only SW Ads daily performance report for a named or current account, including normalized JSON, responsive HTML, and a shareable PNG. Use for 昨日日报、广告账户日报 or GMV Max daily performance reporting; not for changing delivery settings.
+---
+
+# SW Ads Daily Report
+
+Generate a decision-ready daily advertising report from the `swads` MCP. Query and render only; never change campaigns, budgets, ROI targets, creatives, product anchors, or delivery state.
+
+## Preconditions and scope
+
+1. Call `swads_whoami` and verify the requested account is visible. Use its reporting timezone and currency.
+2. Read `metrics_catalog` before querying. Use supported metric and dimension names.
+3. Default to the most recent complete business day. Honor an explicit account or date exactly.
+4. If authentication fails, tell the user to request a token from their administrator; never ask them to paste a token into chat.
+
+## Data and analysis
+
+Collect account totals, campaign rows, delivered creative rows, data freshness, sync warnings, and supported runtime findings. For commerce accounts include spend, GMV, orders, product impressions/clicks, ROAS, and cost per order.
+
+- Recompute ratios from aggregated numerators and denominators. Return `N/A` for missing or zero denominators.
+- If account delivery fields conflict with commerce interaction fields, disclose the discrepancy and use the internally consistent commerce facts.
+- Separate videos from `product_card` identities when comparing creative mix.
+- Describe platform attribution as evidence, not causal incrementality.
+- Distinguish low-volume uncertainty from confirmed underperformance.
+- Output exactly three prioritized, data-backed recommendations.
+- Put every proposed mutation under **Requires human confirmation** and do not execute it.
+
+## Artifacts
+
+Write to `~/swads-reports/YYYY-MM-DD/` unless the user chooses another location:
+
+- `report-data.json`: account, window, timezone/currency, freshness, totals, campaign/creative rows, findings, recommendations, and limitations.
+- `swads-daily-report.html`: self-contained responsive Wise-style HTML with restrained green styling.
+- `swads-daily-report.png`: full-page rendering when a browser renderer is available. Visually inspect it and rerender if text is clipped or unreadable.
+
+Do not include credentials or unrelated account data. Lead the response with the business outcome and main risk, then link the artifacts and confirm the workflow was read-only.