# Skill Roi Calculator

> 计算 Skill 的投资回报率（ROI），用数据说明"值不值得做"。当用户说"值不值得做"、"要多久回本"、"怎么向老板汇报"、"如何证明价值"、"帮我算一下 ROI"、"多久能回本"、"怎么跟老板说值得做"、"justify the investment"、"prove the value"、"make the business case"、"is it worth building"、"how long to break even"时触发。适用场景：(1) 向管理层汇报 Skill 投入产出，(2) 申请预算开发新 Skill，(3) 评估现有 Skill 的使用效果，(4) 对比多个 Skill 的优先级。触发词：ROI 计算、投资回报、成本效益、skill 值不值、evaluate skill value、justify investment、prove ROI、business case、回本周期、向老板汇报。

- Skill: `yizhiyanhua-ai/skill-roi-calculator` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add yizhiyanhua-ai/skill-roi-calculator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yizhiyanhua-ai/skill-roi-calculator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yizhiyanhua-ai (https://skillmd.com/u/yizhiyanhua-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yizhiyanhua-ai/skill-roi-calculator

---


# Skill ROI 计算器

**你不需要懂公式，也不需要运行任何脚本。只需告诉 Claude 你的数据，Claude 会一步步引导你，实时给出计算结果和分析报告。**

## 对话式计算模式（推荐）

Claude 可以直接与你交互式地完成 ROI 计算，无需任何工具或脚本：

1. 告诉 Claude 你想评估哪个 Skill（或者直接把数据贴过来）
2. Claude 会逐步引导你填写缺失信息
3. Claude 直接在对话中完成所有数学计算
4. 输出完整报告，可直接用于汇报

**示例触发方式**：
- "帮我算一下这个 Skill 值不值"
- "我想向老板申请开发一个 Skill，帮我做个 ROI 分析"
- "我们的 Skill 用了 3 个月了，帮我算算 ROI"
- "Skill A 和 Skill B 哪个先做？"

> 脚本工具（`scripts/calculate_roi.py`）是可选的，适合批量计算或自动化场景。Claude 自己就可以做所有数学运算。

---

## 适用场景

| 场景 | 问题 | 输出 |
|------|------|------|
| 向上汇报 | "投入这么多精力做 Skill，值不值？" | ROI 报告 |
| 预算申请 | "开发这个 Skill 需要多少成本？" | 成本估算 + 预测 ROI |
| 效果评估 | "这个 Skill 用得怎么样？" | 使用统计 + 收益核算 |
| 方案对比 | "应该先做哪个 Skill？" | 优先级排序 + 对比报告 |

---

## 工作流程

### 第一步：收集基础信息

Claude 将引导你填写以下信息（不需要一次性全部提供，Claude 会逐项询问）：

**Skill 基本信息**
- Skill 名称
- 功能描述
- 目标用户群体

**开发成本**（如果是新 Skill 或正在评估已建 Skill）
- 开发人员：谁参与开发？（技术/业务专家）
- 开发时间：预计需要多少小时？
- 人力成本：按小时计算的人力成本

**使用数据**（如果是已有 Skill）
- 使用次数：过去 N 天/月使用了多少次？
- 使用人数：有多少人在用？
- 节省时间：每次使用平均节省多少时间？

### 第二步：计算成本

Claude 直接计算（或使用脚本）：

**成本构成**：
1. **开发成本** = 开发时间 × 时薪
2. **专家成本** = 专家时间 × 专家时薪
3. **维护成本** = 开发成本 × 20%（年度）
4. **总成本** = 开发成本 + 专家成本 + 维护成本

可选脚本方式：
```bash
python scripts/calculate_roi.py --mode cost \
  --dev-hours <开发小时数> \
  --hourly-rate <时薪> \
  --experts <专家参与小时数>
```

### 第三步：计算收益

**收益构成**：
1. **时间节省** = 使用次数 × 每次节省时间
2. **人力成本节省** = 时间节省 × 平均时薪
3. **质量提升**（可选）= 错误减少带来的成本节省
4. **总收益** = 人力成本节省 + 质量提升

可选脚本方式：
```bash
python scripts/calculate_roi.py --mode benefit \
  --usage-count <使用次数> \
  --time-saved <每次节省分钟> \
  --user-count <使用人数> \
  --hourly-rate <用户时薪>
```

### 第四步：计算 ROI

**ROI 公式**（Claude 直接计算）：
```
ROI = (总收益 - 总成本) / 总成本 × 100%
回本周期 = 总成本 / 月均收益
年化收益 = 月均收益 × 12
```

可选脚本方式：
```bash
python scripts/calculate_roi.py --mode roi \
  --cost <总成本> \
  --benefit <总收益> \
  --period <周期月数>
```

### 第五步：生成报告

生成完整的 ROI 分析报告，包含：
- 成本明细
- 收益明细
- ROI 计算结果
- 可视化对比建议（适合汇报用）
- 结论与建议

---

## 输出格式

### ROI 分析报告

```
📊 Skill ROI 分析报告
━━━━━━━━━━━━━━━━━━━━━━
Skill：[Skill 名称]
分析周期：[开始日期] ~ [结束日期]

💰 投入成本：
┌────────────────────────────────────┐
│ 项目           │ 金额      │ 占比  │
├────────────────────────────────────┤
│ 开发成本       │ ¥X,XXX    │ XX%   │
│ 专家成本       │ ¥X,XXX    │ XX%   │
│ 维护成本       │ ¥X,XXX    │ XX%   │
├────────────────────────────────────┤
│ 总计           │ ¥X,XXX    │ 100%  │
└────────────────────────────────────┘

📈 使用数据：
- 使用次数：XXX 次
- 使用人数：XX 人
- 平均每次节省：XX 分钟
- 总节省时间：XX 小时

💵 产出价值：
┌────────────────────────────────────┐
│ 项目           │ 金额      │ 说明  │
├────────────────────────────────────┤
│ 人力成本节省   │ ¥X,XXX    │       │
│ 质量提升收益   │ ¥X,XXX    │ 可选  │
├────────────────────────────────────┤
│ 总计           │ ¥X,XXX    │       │
└────────────────────────────────────┘

📊 ROI 分析：
- 投资回报率：XXX%
- 回本周期：X.X 个月
- 年化收益：¥XX,XXX

📉 可视化建议（适合 PPT / 汇报）：
- 柱状图：开发成本 vs 累计收益（按月）
- 折线图：ROI 随时间的增长趋势
- 饼图：成本构成分解
- 对比表：多个 Skill 的 ROI 横向对比

💡 结论与建议：
[根据 ROI 数据给出建议]
```

---

## ROI 评估标准

| ROI | 评级 | 建议 |
|-----|------|------|
| > 200% | ⭐⭐⭐⭐⭐ 优秀 | 强烈推荐，可推广到其他部门 |
| 100-200% | ⭐⭐⭐⭐ 良好 | 值得投入，建议持续优化 |
| 50-100% | ⭐⭐⭐ 一般 | 可以接受，需要提升使用率 |
| 0-50% | ⭐⭐ 较低 | 需要重新评估，考虑优化或放弃 |
| < 0% | ⭐ 亏损 | 建议停止投入，分析失败原因 |

## 回本周期评估

| 回本周期 | 评级 | 说明 |
|----------|------|------|
| < 1 个月 | 快速回本 | 立即见效，优先投入 |
| 1-3 个月 | 正常 | 合理的投资周期 |
| 3-6 个月 | 较长 | 需要管理层支持 |
| > 6 个月 | 长期投资 | 需要战略层面决策 |

---

## 成本估算参考

### 开发成本参考

| Skill 复杂度 | 开发时间 | 专家时间 | 参考成本 |
|--------------|----------|----------|----------|
| 简单（纯文本指导） | 2-4 小时 | 1-2 小时 | ¥500-1,500 |
| 中等（含脚本） | 8-16 小时 | 4-8 小时 | ¥3,000-8,000 |
| 复杂（多脚本+集成） | 24-40 小时 | 8-16 小时 | ¥10,000-25,000 |

### 时薪参考

| 角色 | 参考时薪 |
|------|----------|
| 初级员工 | ¥50-100 |
| 中级员工 | ¥100-200 |
| 高级员工 | ¥200-400 |
| 专家/管理层 | ¥400-800 |

---

## 示例

### 示例 1：合同审查 Skill（已有 Skill 评估）

**输入**：
- 开发时间：法务专家 8 小时 + 技术 4 小时
- 使用数据：3 个月内使用 156 次，12 人使用
- 每次节省：15 分钟

**Claude 直接计算并输出**：
```
📊 Skill ROI 分析报告
━━━━━━━━━━━━━━━━━━━━━━
Skill：contract-reviewer
分析周期：2026-01 ~ 2026-03（3个月）

💰 投入成本：
- 法务专家：8h × ¥300 = ¥2,400
- 技术支持：4h × ¥150 = ¥600
- 总计：¥3,000

📈 使用数据：
- 使用次数：156 次
- 使用人数：12 人
- 每次节省：15 分钟
- 总节省：39 小时

💵 产出价值：
- 人力成本节省：39h × ¥200 = ¥7,800

📊 ROI 分析：
- 投资回报率：160%
- 回本周期：1.2 个月
- 年化收益：¥31,200

📉 可视化建议：
- 月度累计收益 vs 开发成本柱状图（第2月即超回本线）
- 12个月 ROI 增长折线图（年底达 940%）

💡 结论：
⭐⭐⭐⭐ 良好
该 Skill 效果显著，建议：
1. 推广到其他部门
2. 增加「合同模板生成」功能
```

### 示例 2：销售话术 Skill（新 Skill 预估）

**输入**：
- 计划开发：销售话术 Skill
- 预计开发：销售专家 16 小时 + 技术 8 小时
- 预计使用：50 人，每人每天 3 次，每次节省 5 分钟

**Claude 直接计算并输出**：
```
📊 Skill ROI 预估报告
━━━━━━━━━━━━━━━━━━━━━━
Skill：sales-script（规划中）

💰 预计投入：
- 销售专家：16h × ¥250 = ¥4,000
- 技术支持：8h × ¥150 = ¥1,200
- 总计：¥5,200

📈 预计使用（月）：
- 使用次数：50人 × 3次 × 22天 = 3,300 次
- 每次节省：5 分钟
- 月节省：275 小时

💵 预计月收益：
- 人力成本节省：275h × ¥100 = ¥27,500

📊 预计 ROI：
- 月 ROI：429%
- 回本周期：0.2 个月（约 4 天）
- 年化收益：¥330,000

📉 可视化建议：
- 成本 vs 收益对比饼图（收益是成本的 63 倍）
- 回本时间线（第4天即回本）

💡 结论：
⭐⭐⭐⭐⭐ 优秀
强烈建议立即开发，预计 4 天即可回本。
```

---

## 注意事项

1. **数据准确性**：ROI 计算依赖准确的使用数据，建议定期统计
2. **隐性收益**：有些收益难以量化（如员工满意度），可作为补充说明
3. **长期价值**：某些 Skill 的价值需要长期观察才能体现
4. **对比基准**：计算节省时间时，要明确对比的是什么（手工操作 vs 使用 Skill）
5. **汇报建议**：向管理层汇报时，建议附上可视化图表，重点突出回本周期和年化收益