commit 87f8d1820ddd95dd38b43f25ca6caaf090269a08 Author: 19926533763 <19926533763@163.com> Date: Wed Sep 2 10:11:25 2026 +0800 Add SKILL.md Add SW Ads daily report skill diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..6a7c5a6 --- /dev/null +++ b/SKILL.md @@ -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.