AdPilot 技能包是一款轻量级、以本地为先的广告分析技能包，适用于代理编码环境，如 Claude Code、Codex、Cursor 及类似工具。
概览
AdPilot 技能包是一款轻量级、以本地为先的广告分析技能包，适用于代理编码环境，如 Claude Code、Codex、Cursor 及类似工具。 它帮助代理用确定性Python脚本分析导出的广告CSV/JSON文件，而不是让模型自行创造指标。第一个版本专注于中国广告工作流程，同时保持常见的英文字段别名兼容。 本仓库仅包含开源技能包。不包含原始的AdPilot网页平台、OAuth集成、账户系统、后端服务或真实广告平台写作操作。 共享计算代码存在于技能/_shared技能/工具/adpilot_common.py。示例数据存在技能/装置/。 - 推荐使用 Python 3.10 或更新版本。- 无需安装 Python 包;脚本仅使用标准库。- 无需后端、数据库、OAuth、API 密钥或广告账户连接。
概述（AI 翻译）
AdPilot 技能包是一款轻量级、以本地为先的广告分析技能包，适用于代理编码环境，如 Claude Code、Codex、Cursor 及类似工具。
它帮助代理用确定性Python脚本分析导出的广告CSV/JSON文件，而不是让模型自行创造指标。第一个版本专注于中国广告工作流程，同时保持常见的英文字段别名兼容。
本仓库仅包含开源技能包。不包含原始的 AdPilot 网络平台、OAuth 集成、账户系统、后端服务或真实的广告平台写入操作。
包含了什么
| 技能 | 目的 |
|---|---|
adpilot-normalize-report |
将本地 CSV/JSON 导出归一化为 AdPilot 模式。 |
adpilot-diagnose |
计算CPA、ROI、CTR、CVR、渠道指标、活动指标和发现。 |
adpilot-budget-planner |
从历史表现中生成谨慎的下一期预算分配建议。 |
adpilot-anomaly-scan |
检测异常CPA、ROI、CVR并计算移动。 |
adpilot-health-score |
生成一个可解释的广告健康评分0-100。 |
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
AdPilot Skill Pack
AdPilot Skill Pack is a lightweight, local-first advertising analysis skill pack for agent coding environments such as Claude Code, Codex, Cursor, and similar tools.
It helps agents analyze exported advertising CSV/JSON files with deterministic Python scripts instead of asking the model to invent metrics. The first version focuses on Chinese advertising workflows while keeping common English field aliases compatible.
This repository is only the open-source skill pack. It does not include the original AdPilot web platform, OAuth integrations, account systems, backend services, or real advertising platform write operations.
What is included
| Skill | Purpose |
|---|---|
adpilot-normalize-report |
Normalize local CSV/JSON exports into the AdPilot schema. |
adpilot-diagnose |
Calculate CPA, ROI, CTR, CVR, channel metrics, campaign metrics, and findings. |
adpilot-budget-planner |
Generate cautious next-period budget allocation suggestions from historical performance. |
adpilot-anomaly-scan |
Detect unusual CPA, ROI, CVR, and spend movement. |
adpilot-health-score |
Produce an explainable 0-100 advertising health score. |
adpilot-report-export |
Generate a Chinese Markdown recap from deterministic metrics. |
Shared calculation code lives in skills/_shared/adpilot_common.py. Example data lives in skills/fixtures/.
Requirements
- Python 3.10 or newer recommended.
- No Python package installation is required; scripts use the standard library only.
- No backend, database, OAuth, API key, or advertising account connection is required.
Quick start
Clone the repository and run scripts from the repository root:
git clone https://github.com//adpilot-skill-pack.git
cd adpilot-skill-pack
python3 skills/adpilot-normalize-report/scripts/normalize_report.py skills/fixtures/mock_ad_data.json
Run the six core workflows:
python3 skills/adpilot-normalize-report/scripts/normalize_report.py skills/fixtures/mock_ad_data.json
python3 skills/adpilot-diagnose/scripts/diagnose.py skills/fixtures/mock_ad_data.json
python3 skills/adpilot-budget-planner/scripts/budget_plan.py skills/fixtures/mock_ad_data.json --total-budget 100000
python3 skills/adpilot-anomaly-scan/scripts/anomaly_scan.py skills/fixtures/anomaly_report.csv
python3 skills/adpilot-health-score/scripts/health_score.py skills/fixtures/mock_ad_data.json
python3 skills/adpilot-report-export/scripts/export_report.py skills/fixtures/mock_ad_data.json --output /tmp/adpilot-report.md
Every script prints JSON to stdout. adpilot-report-export can also write a Markdown file with --output.
Using with an agent
Point your agent at the relevant SKILL.md file, or copy the full skills/ directory into a location supported by your agent runtime.
Keep the entire skills/ directory together. The individual skill entrypoints depend on the shared helper at skills/_shared/adpilot_common.py.
推荐工具
换一个关键词，或者移除筛选条件。
安装
npx skillfish add ocho-lo/adpilot-skill-pack