| name | kpi |
| description | 基于 KPI 体系管理智能体关键绩效指标与执行任务。当用户提到 KPI、指标管理、达成率、绩效复盘、评分、经验沉淀时使用，并将信息维护到 memory/kpi.md。 |
| version | 1.0.1 |
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，并保持如下结构：
# 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（超出期望）
- 结果概述：
- 高杠杆动作：
- 偏差原因：
- 可复用经验：
- 下周期优化项：
执行指南
- 先读后写：对
memory/kpi.md 的任何更新前都先读取现有内容，避免覆盖历史。
- 口径优先：创建 KPI 时先明确统计口径，再写目标值，避免后续争议。
- 任务联动：Task 状态变化要同步反映在 KPI 实际值或风险备注中。
- 完成门槛：仅当周期结束或用户明确收官时，将 KPI 标记为“已完成”。
- 强制复盘评分：已完成周期若无复盘或无评分，必须补齐后才算闭环。
- 经验沉淀：可复用经验需具体到方法、场景和适用条件，避免空泛总结。
常用触发语例
- “帮我搭一套这个月的 KPI”
- “把拉新指标拆成可执行任务”
- “更新一下本周 KPI 的实际值”
- “这个周期结束了，帮我复盘并打分”
- “把这次做增长的经验沉淀下来”
注意事项
- 不记录敏感信息（密码、密钥、隐私凭证）。
- 指标定义与口径必须前后一致，必要时保留变更说明。
- 若用户要求越级评分（不在 5/4/3.75/3.5/3.25 中），先解释规则并引导到合法分值。
