- name
SKILL.md
स्किल फ़ाइल पब्लिशर की रिपॉज़िटरी में ही रहती है।
कॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill roi-calculator -a cursor -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill roi-calculator -a claude-code -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill roi-calculator -a codex -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill roi-calculator -a grok -yकॉपी किया गया संदेश Grok Bot चैट में भेजें। Bot यह SKILL.md GitHub से लाता है और उसे उन स्किल में जोड़ देता है जो आपके सभी Bot साझा करते हैं।
Install this skill: https://github.com/ZJU-REAL/Easel/tree/HEAD/skills/builtin/roi-calculatorपब्लिशर से
根据用户提供的投放数据,计算标准营销效果指标,对比行业基准,输出结构化分析报告。
用户提供以下字段的任意子集(缺失字段跳过其依赖指标):
两种模式:
以下指标仅在分母数据存在且非零时计算,否则标注"数据不足,已跳过":
Mode A — 单活动分析:
## 投放效果报告
### 基础数据
(用户提供的原始字段)
### 计算指标
| 指标 | 值 | 公式 | 基准对比 |
|------|----|------|----------|
| CTR | x% | clicks/impressions | ▲ 高于行业均值 |
| ... | | | |
### 基准对比图例
▲ 高于行业均值(表现良好)
▼ 低于行业均值(需关注)
≈ 接近行业均值(正常水平)
⚠ 显著偏离(超出基准 2 倍或低于 50%)
### 诊断
- 表现突出:(列出高于基准的指标及优势分析)
- 待优化:(列出低于基准的指标及具体改进方向)
- 综合评价:(一句话总结本次投放效果)
Mode B — 多活动对比:
## 多活动横向对比(按 ROI 降序)
| 活动 | 花费 | 营收 | ROI | ROAS | CTR | CPC | 综合评价 |
|------|------|------|-----|------|-----|-----|----------|
| ... | | | | | | | |
### 最优/最差活动分析
(对比 ROI 最高与最低活动的关键指标差异,找出差距来源)
### 预算分配建议
(基于各活动效率,建议预算向高 ROI 活动倾斜的比例)
### 优化建议
(针对低效活动的具体改进方向)
确定性计算交给脚本,LLM 只做解读。 上表各项指标(含营收/利润派生,有机模式另算互动率)、 有机模式切换、字段校验、Mode B 按 ROI 降序排序,全部由
scripts/calc.py完成(复用skills/shared/scripts/social_stats.py的safe_div,除零/缺字段一律返回null,不心算、不猜数)。
python3 skills/builtin/roi-calculator/scripts/calc.py single --name "活动名" \
--ad-spend 5000 --impressions 100000 --clicks 3000 \
--engagements 8000 --conversions 150 --avg-order-value 200 \
--production-cost 1000
python3 skills/builtin/roi-calculator/scripts/calc.py multi --file campaigns.json
null 并视为"数据不足")、
营收→ROAS/利润/ROI 派生、ad_spend 为 0/缺失时切有机模式(跳过成本类指标)、
字段校验(负值 / 曝光<点击 / 转化>点击 写入 warnings)、Mode B 按 roi_pct 降序排序并标 roi_rank。platforms.md 确定主平台,选对应平台基准warnings当 ad_spend 为 0 或缺失时,自动切换:
有 Profile 时:
platforms.md 获取主投放平台,选用平台专属基准区间audience.md 了解受众特征,为转化率判断提供上下文无 Profile 时:
基准数据来源(定期更新 references/benchmarks.md):
迭代方向:
基准数据维护规则:
>-
---name: roi-calculatordescription: >----# skills/builtin/roi-calculator/SKILL.mdFAQ
पब्लिशर से skills/builtin/roi-calculator/SKILL.md डाउनलोड करें, या पाथ कॉपी करके रिपॉज़िटरी खोलें। PlugMCP स्किल को सूचीबद्ध करता है, फ़ाइल होस्ट नहीं करता।
पब्लिशर इसे https://github.com/ZJU-REAL/Easel पर रखता है।
Claude, Cursor, Codex और Grok Build वह SKILL.md पढ़ सकते हैं जिसे आप पब्लिशर की रिपॉज़िटरी से जोड़ते हैं। जब आप चैट में स्किल के GitHub फ़ोल्डर का लिंक भेजते हैं, तो Grok Bot उसे इंस्टॉल कर देता है।