# Kpi

> 基于 KPI 体系管理智能体关键绩效指标与执行任务。当用户提到 KPI、指标管理、达成率、绩效复盘、评分、经验沉淀时使用，并将信息维护到 memory/kpi.md。

- Skill: `dvcrn/kpi` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/kpi`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/kpi/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/kpi

---


# KPI 助手

本技能用于把用户目标落地为可量化 KPI 指标并持续追踪。每个 KPI 周期结束后，必须进行复盘与评分，并将经验沉淀到 `~/.openclaw/workspace/memory/kpi.md`。

## 核心能力

### 1) 建立 KPI 指标

- 将用户业务目标拆分为 3-8 个关键指标（KPI）。
- 每个 KPI 必须包含：指标定义、统计口径、目标值、周期、负责人。
- 指标尽量采用可度量表达（数值、比例、次数、时长等）。

### 2) 管理执行任务（Tasks）

- 为每个 KPI 拆分 2-6 个执行任务（Task），用于保障指标达成。
- 每个 Task 记录状态（待开始/进行中/已完成/阻塞）、截止时间、责任人。
- 用户提到“完成了某项工作”时，优先匹配并更新对应 Task，再回填 KPI 进展。

### 3) 追踪进度与达成率

- 每次更新都记录实际值、目标值、达成率、更新时间。
- 达成率建议使用统一公式：`达成率 = 实际值 / 目标值 * 100%`（可按指标特性调整）。
- 出现偏差时，补充原因与纠偏动作。

### 4) 周期收官后的强制复盘

- KPI 周期结束后，必须新增复盘记录。
- 复盘至少包含：结果概述、高杠杆动作、偏差原因、可复用经验、下周期优化项。
- 复盘完成后必须评分，评分仅可使用以下阶梯：
  - `5`：完美
  - `4`：卓越
  - `3.75`：超出期望
  - `3.5`：符合期望
  - `3.25`：不及期望

## 存储规范

始终维护 `~/.openclaw/workspace/memory/kpi.md`，并保持如下结构：

```markdown
# KPI 追踪与复盘

> 由 kpi 技能管理

---

## 当前周期

### KPI 1: [指标名称]

- 周期：YYYY-MM（或 YYYY-QN）
- 创建时间：YYYY-MM-DD HH:mm
- 状态：进行中 / 已完成 / 暂停
- 指标定义：[一句话]
- 统计口径：[如何计算]
- 目标值：[数字或里程碑]
- 实际值：[数字或里程碑]
- 达成率：[0-100+]%
- 负责人：[姓名]
- 最后更新：YYYY-MM-DD HH:mm

#### Tasks

- [ ] 任务 1（截止：YYYY-MM-DD，状态：进行中）
- [x] 任务 2（完成：YYYY-MM-DD）

---

## 复盘归档

### [周期] KPI 复盘（YYYY-MM-DD）

- 最终评分：3.75（超出期望）
- 结果概述：
- 高杠杆动作：
- 偏差原因：
- 可复用经验：
- 下周期优化项：
```

## 执行指南

1. **先读后写**：对 `memory/kpi.md` 的任何更新前都先读取现有内容，避免覆盖历史。
2. **口径优先**：创建 KPI 时先明确统计口径，再写目标值，避免后续争议。
3. **任务联动**：Task 状态变化要同步反映在 KPI 实际值或风险备注中。
4. **完成门槛**：仅当周期结束或用户明确收官时，将 KPI 标记为“已完成”。
5. **强制复盘评分**：已完成周期若无复盘或无评分，必须补齐后才算闭环。
6. **经验沉淀**：可复用经验需具体到方法、场景和适用条件，避免空泛总结。

## 常用触发语例

- “帮我搭一套这个月的 KPI”
- “把拉新指标拆成可执行任务”
- “更新一下本周 KPI 的实际值”
- “这个周期结束了，帮我复盘并打分”
- “把这次做增长的经验沉淀下来”

## 注意事项

- 不记录敏感信息（密码、密钥、隐私凭证）。
- 指标定义与口径必须前后一致，必要时保留变更说明。
- 若用户要求越级评分（不在 5/4/3.75/3.5/3.25 中），先解释规则并引导到合法分值。