KPI/OKR 工作管理#

将零散的工作日志转化为结构化的 OKR 管理，实现从目标设置到成果总结的完整数据闭环。

何时使用此技能#

• 用户要记录每日工作日志
• 用户要创建/查看/更新周计划
• 用户要生成周报、月报、季报或年报
• 用户要设置或查看 OKR 目标和进度
• 用户要复盘季度或年度 OKR 完成情况

核心原则#

1. 自然语言输入：任意格式，Agent 智能解析工时、标签
2. 零依赖：Agent 直接读写 JSON 文件，无需安装任何工具
3. 自动追踪：工作日志关联 OKR，自动累计进度
4. 渐进分析：周报(轻度) -> 月报(对齐) -> 季报(提炼) -> 年报(复盘)

数据存储#

数据存放在 {workspace}/.okr-work-manager/ 目录下：

text

.okr-work-manager/
├── daily/           # 工作日志 (YYYY-MM-DD.json)
├── plans/           # 周计划 (YYYY-Www.json)
├── weekly/          # 周报 (YYYY-Www-report.json)
├── monthly/         # 月报 (YYYY-MM-report.json)
├── quarterly/       # 季报 (YYYY-QX-report.json)
├── yearly/          # 年报 (YYYY-report.json)
├── okr_config.json  # OKR 配置
└── okr_progress.json # OKR 进度

完整 JSON schema 参见 data-schema.md

定时调度（Gateway Cron）#

通过 Agent Gateway Cron 实现定期报告生成。

首次使用：初始化定时任务#

Agent 通过 cron.add 创建 3 个隔离式 cron 任务：

json

{
  "name": "okr:weekly-report",
  "schedule": { "kind": "cron", "expr": "0 18 * * 5", "tz": "Asia/Shanghai" },
  "sessionTarget": "isolated",
  "payload": {
    "kind": "agentTurn",
    "message": "执行本周工作周报。读取 {workspace}/.okr-work-manager/daily/ 本周日志和 plans/ 本周计划，汇总工时、标签、OKR 贡献，保存到 weekly/ 目录。参考 skills/okr-work-manager/references/data-schema.md",
    "model": "haiku"
  },
  "delivery": { "mode": "announce" }
}

json

{
  "name": "okr:monthly-report",
  "schedule": { "kind": "cron", "expr": "0 20 28 * *", "tz": "Asia/Shanghai" },
  "sessionTarget": "isolated",
  "payload": {
    "kind": "agentTurn",
    "message": "执行本月 OKR 对齐分析月报。读取 {workspace}/.okr-work-manager/ 本月全部日志，对比 okr_config.json 分析对齐度和进度预警，保存到 monthly/ 目录。参考 skills/okr-work-manager/references/data-schema.md",
    "model": "haiku"
  },
  "delivery": { "mode": "announce" }
}

CLI 方式（将 {cli} 替换为实际命令）：

bash

{cli} cron add \
  --name "okr:weekly-report" \
  --cron "0 18 * * 5" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "执行本周工作周报..." \
  --model haiku --announce

默认值#

任务默认时间cron 表达式说明周报每周五 18:000 18 * * 5工作日结束前月报每月 28 日 20:000 20 28 * *月底提前季报/年报不自动执行—由用户手动触发

频率调整#

text

周报改成每周五 17 点
月报改成每月最后一天
暂停自动周报
恢复周报

四级分析体系#

1. 周报（轻度展示）#

• 读取本周日志，对比周计划完成情况
• 汇总各 OKR 的本周贡献
• 保存至 weekly/YYYY-Www-report.json

2. 月报 + OKR 对齐分析（中度）#

• 读取本月全部日志和周报
• 工作与 OKR 对齐度分析，识别未对齐工作
• OKR 进度预警（落后/超前）
• 下月对齐建议
• 保存至 monthly/YYYY-MM-report.json

3. 季报 + OKR 智能提炼（深度）#

• 读取季度内所有月报
• OKR 完成情况总结，KR 级进度评估
• 基于工作分布智能提炼下一季度 OKR 建议
• 保存至 quarterly/YYYY-QX-report.json

4. 年报 + 年度 OKR 复盘（全面）#

• 读取全年季报
• 季度 OKR 与年度 OKR 对齐分析
• 全年工作模式识别和趋势分析
• 下一年度 OKR 建议
• 保存至 yearly/YYYY-report.json

分析类型对齐分析进度预警OKR 提炼趋势分析调整建议周报-----月报OKR 对齐超前/落后--下月季报OKR 对齐OKR 完成智能提炼-下季度年报季度-年度全年完成OKR 建议季度趋势下一年度

OKR 管理#

双重模式#

模式说明主动设置用户在季度/年度开始前设置目标，实时追踪进度智能提炼季报/年报基于工作数据自动生成 OKR 建议

OKR ID 命名#

类型格式示例季度 OKRq_{year}-Q{quarter}_{index}``q_2026-Q1_1年度 OKRy_{year}_{index}``y_2026_1

操作方式#

• 设置 OKR： "设置 Q1 OKR：1.完成架构升级（200h）- 核心模块重构（100h）..."
• 查看进度： "查看 Q1 OKR 进度"
• 更新 KR 进度：Agent 根据工作日志自动累计

时间计算规则#

• ISO 8601 标准：周从周一开始，第1周包含1月4日
• 季度：Q1(1-3月)、Q2(4-6月)、Q3(7-9月)、Q4(10-12月)

依赖技能#

无外部依赖。Agent 直接读写 JSON 文件。

参考文档#

• data-schema.md — 全部 JSON 数据结构定义（日志、计划、报告、OKR 配置、OKR 进度）
• troubleshooting.md — 常见问题、数据修复、从 Python 版本迁移

使用示例#

• basic-usage.md — 记录日志、创建计划、生成周报
• advanced-usage.md — OKR 设置、进度查看、月报对齐分析、季报提炼、年报复盘

版本历史#

版本日期变更2.0.02026-03-31重构为分层文档架构；补全月报/季报/年报/进度 JSON schema；统一路径为 {workspace}；增加 Gateway Cron 调度；增加标准 frontmatter 字段1.0.02026-03-27Agent 纯驱动重构：移除 Python 脚本，单 SKILL.md