Skill: zerosloney/okr-work-manager (version 2.0.0)

--- name: okr-work-manager description: > KPI/OKR 工作管理系统。支持季度/年度 OKR 目标设置，通过自然语言记录工作日志 自动追踪目标进度，生成周报、月报、季报、年报，实现目标管理+工作记录+进度追踪+复盘总结的完整闭环。 version: 2.0.0 tags: [okr, kpi, work-management, productivity, time-tracking, weekly-report, goal-tracking] author: QClab license: MIT-0 --- # KPI/OKR 工作管理 将零散的工作日志转化为结构化的 OKR 管理，实现从目标设置到成果总结的完整数据闭环。 ## 何时使用此技能 - 用户要记录每日工作日志 - 用户要创建/查看/更新周计划 - 用户要生成周报、月报、季报或年报 - 用户要设置或查看 OKR 目标和进度 - 用户要复盘季度或年度 OKR 完成情况 ## 核心原则 1. **自然语言输入**：任意格式，Agent 智能解析工时、标签 2. **零依赖**：Agent 直接读写 JSON 文件，无需安装任何工具 3. **自动追踪**：工作日志关联 OKR，自动累计进度 4. **渐进分析**：周报(轻度) -> 月报(对齐) -> 季报(提炼) -> 年报(复盘) ## 数据存储 数据存放在 `{workspace}/.okr-work-manager/` 目录下： ``` .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](references/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:00 | `0 18 * * 5` | 工作日结束前 | | 月报 | 每月 28 日 20:00 | `0 20 28 * *` | 月底提前 | | 季报/年报 | 不自动执行 | — | 由用户手动触发 | ### 频率调整 ``` 周报改成每周五 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 命名 | 类型 | 格式 | 示例 | |------|------|------| | 季度 OKR | `q_{year}-Q{quarter}_{index}` | `q_2026-Q1_1` | | 年度 OKR | `y_{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](references/data-schema.md)** — 全部 JSON 数据结构定义（日志、计划、报告、OKR 配置、OKR 进度） - **[troubleshooting.md](references/troubleshooting.md)** — 常见问题、数据修复、从 Python 版本迁移 ## 使用示例 - **[basic-usage.md](examples/basic-usage.md)** — 记录日志、创建计划、生成周报 - **[advanced-usage.md](examples/advanced-usage.md)** — OKR 设置、进度查看、月报对齐分析、季报提炼、年报复盘 ## 版本历史 | 版本 | 日期 | 变更 | |------|------|------| | 2.0.0 | 2026-03-31 | 重构为分层文档架构；补全月报/季报/年报/进度 JSON schema；统一路径为 {workspace}；增加 Gateway Cron 调度；增加标准 frontmatter 字段 | | 1.0.0 | 2026-03-27 | Agent 纯驱动重构：移除 Python 脚本，单 SKILL.md |

path: references/data-schema.md
content: # 数据结构参考

本文档定义 OKR 工作管理系统的所有 JSON 数据结构。

## 目录

- [工作日志](#工作日志)
- [周计划](#周计划)
- [周报](#周报)
- [月报](#月报)
- [季报](#季报)
- [年报](#年报)
- [OKR 配置](#okr-配置)
- [OKR 进度](#okr-进度)

---

## 工作日志

**路径**：`{data_dir}/daily/YYYY-MM-DD.json`

```json
{
  "date": "2026-03-06",
  "weekday": 4,
  "week": 10,
  "year": 2026,
  "week_id": "2026-W10",
  "logs": [
    {
      "content": "排查深圳友联流程数据重复",
      "hours": 1.0,
      "tags": ["#深圳友联", "#流程"],
      "okr_id": "q_2026-Q1_1",
      "timestamp": "2026-03-06T10:30:00",
      "original_input": "排查深圳友联流程数据重复(1h)"
    }
  ],
  "metadata": {
    "total_hours": 7.2,
    "total_items": 5,
    "tags_summary": {"#深圳友联": 3.0, "#后端": 4.2},
    "created_at": "2026-03-06T23:59:00"
  }
}
```

### 字段说明

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `date` | string | 是 | 日期，YYYY-MM-DD 格式 |
| `weekday` | number | 是 | 周几（1=周一，7=周日） |
| `week` | number | 是 | ISO 8601 周数 |
| `year` | number | 是 | 年份 |
| `week_id` | string | 是 | ISO 8601 周标识，YYYY-Www 格式 |
| `logs` | array | 是 | 工作记录数组 |
| `logs[].content` | string | 是 | 工作内容描述 |
| `logs[].hours` | number | 是 | 工时（小时） |
| `logs[].tags` | array | 否 | 标签数组，以 # 开头 |
| `logs[].okr_id` | string | 否 | 关联的 OKR ID |
| `logs[].timestamp` | string | 是 | 记录时间，ISO 8601 格式 |
| `logs[].original_input` | string | 否 | 用户原始输入（用于溯源） |
| `metadata` | object | 是 | 元数据 |
| `metadata.total_hours` | number | 是 | 当日总工时 |
| `metadata.total_items` | number | 是 | 当日工作条数 |
| `metadata.tags_summary` | object | 否 | 标签工时汇总 |
| `metadata.created_at` | string | 是 | 文件创建时间 |

---

## 周计划

**路径**：`{data_dir}/plans/YYYY-Www.json`

```json
{
  "year": 2026,
  "week": 10,
  "week_str": "10",
  "week_id": "2026-W10",
  "period": {
    "start": "2026-03-02",
    "end": "2026-03-08"
  },
  "created_at": "2026-03-02T10:00:00",
  "updated_at": "2026-03-02T10:00:00",
  "status": "active",
  "goals": ["完成系统架构升级", "解决生产环境问题"],
  "tasks": [
    {
      "id": "task-abc123",
      "description": "任务描述",
      "priority": "high",
      "tags": ["#标签"],
      "estimated_hours": 4.0,
      "okr_id": "q_2026-Q1_1",
      "completed": false,
      "actual_hours": 0,
      "created_at": "2026-03-02T10:00:00"
    }
  ],
  "focus_areas": ["重点领域1", "重点领域2"],
  "notes": "备注信息"
}
```

### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `status` | string | 计划状态：`active` / `completed` / `archived` |
| `tasks[].priority` | string | 优先级：`high` / `medium` / `low` |
| `tasks[].completed` | boolean | 是否已完成 |
| `tasks[].actual_hours` | number | 实际耗时（完成后填写） |

---

## 周报

**路径**：`{data_dir}/weekly/YYYY-Www-report.json`

```json
{
  "report_type": "weekly",
  "period": "2026-W10",
  "year": 2026,
  "week": 10,
  "date_range": {
    "start": "2026-03-02",
    "end": "2026-03-08"
  },
  "generated_at": "2026-03-08T18:00:00",
  "summary": {
    "total_hours": 42.5,
    "total_tasks": 25,
    "work_days": 5
  },
  "category_distribution": {
    "#深圳友联": 15.0,
    "#系统优化": 12.0,
    "#会议": 8.5
  },
  "top_tags": [
    {"tag": "#深圳友联", "hours": 15.0, "count": 8}
  ],
  "plan_comparison": {
    "planned_tasks": 8,
    "completed_tasks": 6,
    "completion_rate": 0.75
  },
  "okr_contributions": {
    "q_2026-Q1_1": {
      "objective": "完成系统架构升级",
      "hours": 25.0,
      "tasks_count": 12
    }
  },
  "daily_breakdown": [
    {"date": "2026-03-02", "hours": 8.5, "tasks": 5},
    {"date": "2026-03-03", "hours": 7.0, "tasks": 4}
  ]
}
```

---

## 月报

**路径**：`{data_dir}/monthly/YYYY-MM-report.json`

```json
{
  "report_type": "monthly",
  "period": "2026-03",
  "year": 2026,
  "month": 3,
  "date_range": {
    "start": "2026-03-01",
    "end": "2026-03-31"
  },
  "generated_at": "2026-03-31T20:00:00",
  "summary": {
    "total_hours": 168.0,
    "total_tasks": 95,
    "work_days": 22,
    "avg_daily_hours": 7.6
  },
  "okr_alignment": {
    "aligned_hours": 142.0,
    "alignment_rate": 0.85,
    "aligned_okrs": ["q_2026-Q1_1", "q_2026-Q1_2"],
    "unaligned_work": [
      {
        "description": "临时运维支持",
        "hours": 12.0,
        "reason": "无对应 OKR 覆盖"
      }
    ]
  },
  "okr_progress": {
    "q_2026-Q1_1": {
      "objective": "完成系统架构升级",
      "month_hours": 68.0,
      "progress_estimate": 0.72,
      "status": "on_track",
      "alert": null
    },
    "q_2026-Q1_2": {
      "objective": "提升系统性能",
      "month_hours": 35.0,
      "progress_estimate": 0.45,
      "status": "at_risk",
      "alert": "进度落后，建议增加投入"
    }
  },
  "category_trend": {
    "#系统优化": {"hours": 65.0, "change": 0.15},
    "#会议": {"hours": 18.0, "change": -0.10}
  },
  "next_month_suggestions": [
    {
      "okr_id": "q_2026-Q1_2",
      "suggestion": "增加性能优化专项投入",
      "estimated_hours": 40.0
    }
  ]
}
```

### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `okr_alignment.alignment_rate` | number | OKR 对齐率（已对齐工时/总工时） |
| `okr_progress[].status` | string | `on_track` / `at_risk` / `behind` / `completed` |
| `okr_progress[].alert` | string\|null | 进度预警消息，null 表示正常 |
| `category_trend[].change` | number | 工时占比环比变化（正=增加，负=减少） |

---

## 季报

**路径**：`{data_dir}/quarterly/YYYY-QX-report.json`

```json
{
  "report_type": "quarterly",
  "period": "2026-Q1",
  "year": 2026,
  "quarter": 1,
  "date_range": {
    "start": "2026-01-01",
    "end": "2026-03-31"
  },
  "generated_at": "2026-03-31T20:00:00",
  "summary": {
    "total_hours": 520.0,
    "total_tasks": 280,
    "work_days": 63,
    "active_okrs": 3,
    "completed_okrs": 1
  },
  "okr_results": [
    {
      "id": "q_2026-Q1_1",
      "objective": "完成系统架构升级",
      "target_hours": 200,
      "actual_hours": 185.0,
      "completion_rate": 0.92,
      "status": "mostly_complete",
      "key_result_progress": [
        {"description": "完成核心模块重构", "progress": 1.0},
        {"description": "完成性能优化", "progress": 0.8}
      ]
    }
  ],
  "work_pattern": {
    "top_categories": [
      {"category": "#系统优化", "hours": 180.0, "percentage": 0.35}
    ],
    "monthly_trend": [
      {"month": "2026-01", "hours": 160.0},
      {"month": "2026-02", "hours": 172.0},
      {"month": "2026-03", "hours": 188.0}
    ]
  },
  "next_quarter_okr_suggestions": [
    {
      "suggested_objective": "深化系统性能优化",
      "evidence": "Q1 性能优化投入 120h，已完成 80%",
      "suggested_key_results": [
        "将核心接口响应时间降至 50ms 以下",
        "完成负载均衡方案落地"
      ]
    }
  ]
}
```

### 季报 OKR 状态

| status | 说明 |
|--------|------|
| `completed` | 100% 完成 |
| `mostly_complete` | 75%-99% 完成 |
| `partially_complete` | 30%-74% 完成 |
| `at_risk` | 低于 30% 或进度严重落后 |
| `not_started` | 未投入工时 |

---

## 年报

**路径**：`{data_dir}/yearly/YYYY-report.json`

```json
{
  "report_type": "yearly",
  "period": "2026",
  "year": 2026,
  "date_range": {
    "start": "2026-01-01",
    "end": "2026-12-31"
  },
  "generated_at": "2026-12-31T20:00:00",
  "summary": {
    "total_hours": 2080.0,
    "total_tasks": 1100,
    "work_days": 260,
    "quarterly_okrs": 4,
    "yearly_okrs": 2,
    "yearly_okr_completion_rate": 0.75
  },
  "quarterly_okr_summary": [
    {
      "quarter": "Q1",
      "okrs_total": 3,
      "okrs_completed": 2,
      "total_hours": 520.0
    }
  ],
  "yearly_okr_alignment": {
    "y_2026_1": {
      "objective": "技术架构现代化",
      "quarters_contributed": ["Q1", "Q2", "Q3"],
      "total_hours": 680.0,
      "completion_rate": 0.85
    }
  },
  "work_pattern": {
    "top_categories": [
      {"category": "#系统优化", "hours": 580.0, "percentage": 0.28}
    ],
    "quarterly_trend": [
      {"quarter": "Q1", "hours": 520.0},
      {"quarter": "Q2", "hours": 540.0},
      {"quarter": "Q3", "hours": 510.0},
      {"quarter": "Q4", "hours": 510.0}
    ]
  },
  "next_year_okr_suggestions": [
    {
      "suggested_objective": "构建自动化运维体系",
      "evidence": "全年运维投入 360h，占 17%，具备自动化基础",
      "suggested_key_results": [
        "实现核心服务 90% 自动化部署",
        "建立完善的监控告警体系"
      ]
    }
  ]
}
```

---

## OKR 配置

**路径**：`{data_dir}/okr_config.json`

```json
{
  "quarterly": {
    "2026-Q1": [
      {
        "id": "q_2026-Q1_1",
        "objective": "完成系统架构升级",
        "key_results": [
          {
            "id": "kr_1_1",
            "description": "完成核心模块重构",
            "target": 100,
            "unit": "小时",
            "current": 68
          }
        ],
        "target_hours": 200,
        "created_at": "2026-01-01T09:00:00",
        "status": "active"
      }
    ]
  },
  "yearly": {
    "2026": [
      {
        "id": "y_2026_1",
        "objective": "技术架构现代化",
        "key_results": [
          {
            "id": "ykr_1_1",
            "description": "完成微服务架构迁移",
            "target": 4,
            "unit": "个服务",
            "current": 2
          }
        ],
        "target_hours": 800,
        "created_at": "2026-01-01T09:00:00",
        "status": "active"
      }
    ]
  }
}
```

### OKR ID 命名规则

| 类型 | 格式 | 示例 |
|------|------|------|
| 季度 OKR | `q_{year}-Q{quarter}_{index}` | `q_2026-Q1_1` |
| 季度 KR | `kr_{okr_index}_{kr_index}` | `kr_1_1` |
| 年度 OKR | `y_{year}_{index}` | `y_2026_1` |
| 年度 KR | `ykr_{okr_index}_{kr_index}` | `ykr_1_1` |

### OKR 状态

| status | 说明 |
|--------|------|
| `active` | 当前活跃 |
| `completed` | 已完成 |
| `archived` | 已归档 |

---

## OKR 进度

**路径**：`{data_dir}/okr_progress.json`

```json
{
  "last_updated": "2026-03-31T20:00:00",
  "quarterly": {
    "2026-Q1": [
      {
        "id": "q_2026-Q1_1",
        "objective": "完成系统架构升级",
        "total_target_hours": 200,
        "accumulated_hours": 185.0,
        "progress_rate": 0.92,
        "key_results": [
          {
            "id": "kr_1_1",
            "description": "完成核心模块重构",
            "target": 100,
            "unit": "小时",
            "current": 95,
            "progress_rate": 0.95
          }
        ],
        "weekly_trend": [
          {"week": "2026-W09", "hours": 42.0},
          {"week": "2026-W10", "hours": 38.0},
          {"week": "2026-W11", "hours": 45.0}
        ],
        "status": "mostly_complete",
        "estimated_completion_week": "2026-W13"
      }
    ]
  },
  "yearly": {
    "2026": [
      {
        "id": "y_2026_1",
        "objective": "技术架构现代化",
        "total_target_hours": 800,
        "accumulated_hours": 580.0,
        "progress_rate": 0.73,
        "status": "on_track",
        "quarterly_breakdown": [
          {"quarter": "Q1", "hours": 180.0},
          {"quarter": "Q2", "hours": 200.0},
          {"quarter": "Q3", "hours": 200.0}
        ]
      }
    ]
  }
}
```

### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `progress_rate` | number | 完成进度（0.0-1.0） |
| `weekly_trend` | array | 每周工时投入趋势（季度 OKR） |
| `quarterly_breakdown` | array | 每季度工时投入（年度 OKR） |
| `estimated_completion_week` | string | 预计完成周（仅季度 OKR） |


path: references/troubleshooting.md
content: # 故障排除指南

## 常见问题

### 如何查看生成的报告？

报告保存在 `{data_dir}/` 对应子目录下：
- 周报：`weekly/`
- 月报：`monthly/`
- 季报：`quarterly/`
- 年报：`yearly/`

也可以直接告诉 Agent "显示本周周报"，Agent 会读取文件后直接展示内容。

### 可以修改已记录的工作日志吗？

可以，直接告诉 Agent：`"修改3月3日的工作日志，把开发时间改为4小时"` —— Agent 会找到对应日期的 JSON 文件并修改。

### 为什么第1周包含前一年的日期？

ISO 8601 标准规定第1周为包含1月4日的那一周，可能从前一年12月底开始。

### 智能解析会出错吗？

Agent 基于语义理解，准确率很高。如果遇到歧义，Agent 会通过交互式确认让用户验证，避免错误。

### 需要安装任何工具或脚本吗？

不需要。本技能完全由 Agent 直接读写 JSON 文件实现，无需安装任何 Python 环境或依赖，跨平台开箱即用。

---

## 数据问题

### 工作日志文件不存在

Agent 在记录日志时会自动创建 `{data_dir}/daily/` 目录和对应的 JSON 文件。如果目录不存在，Agent 应自动创建。

### 月报/季报/年报生成时缺少下级数据

| 场景 | 处理方式 |
|------|---------|
| 月报缺少某天日志 | 跳过缺失天数，按已有数据统计 |
| 月报缺少周报 | 直接从日志汇总，不依赖周报 |
| 季报缺少月报 | 从月内日志直接汇总 |
| 年报缺少季报 | 从全年日志直接汇总 |

### 跨季度/跨年度的数据归属

- 工作日志按 `date` 字段归属到对应周/月/季
- 如果某天的工作横跨多个 OKR，通过 `okr_id` 分别记录
- 季度 OKR 在季度结束后自动标记为 `completed` 或 `archived`

### JSON 文件损坏

1. 检查文件是否为合法 JSON（每行一个 JSON 对象，或整体一个 JSON 对象）
2. 如果文件损坏，从最近的备份恢复（如有）
3. Agent 应在写入前验证 JSON 格式，避免损坏

---

## 升级相关

### 从 Python 版本迁移数据

旧版（Python 脚本版）的数据文件格式与新版兼容，可直接使用。主要差异：

| 项目 | 旧版 | 新版 |
|------|------|------|
| 数据目录 | `~/.okr-work-manager/` | `{workspace}/.okr-work-manager/` |
| 日志格式 | 同 | 同 |
| 计划格式 | 同 | 同 |
| 报告生成 | Python 脚本 | Agent 直接生成 |

迁移步骤：
1. 将旧版 `.okr-work-manager/` 目录复制到 `{workspace}/` 下
2. 删除 Python 脚本和配置模板（`scripts/`、`config/`、`assets/`）
3. 保留 `daily/`、`plans/`、`weekly/`、`monthly/`、`quarterly/`、`yearly/` 目录及 JSON 文件
4. 保留 `okr_config.json` 和 `okr_progress.json`（如有）

---

## 快速检查清单

- [ ] 数据目录存在且可写？
- [ ] `okr_config.json` 格式正确？
- [ ] 当日日志文件存在？
- [ ] Agent 能正常读取 JSON 文件？


path: examples/advanced-usage.md
content: # 高级使用示例

## 设置季度 OKR

```
用户：设置 Q1 OKR：
1.完成系统架构升级（目标 200h）
  - 完成核心模块重构（100h）
  - 完成性能优化（80h）
  - 编写技术文档（20h）
2.提升系统稳定性（目标 150h）
  - 解决生产环境 P0 问题（50h）
  - 建立监控告警体系（100h）

Agent：
已创建 2 个 Q1 OKR，写入 okr_config.json：

OKR 1: q_2026-Q1_1 — 完成系统架构升级（200h）
  KR1: 完成核心模块重构（100h）
  KR2: 完成性能优化（80h）
  KR3: 编写技术文档（20h）

OKR 2: q_2026-Q1_2 — 提升系统稳定性（150h）
  KR1: 解决生产环境 P0 问题（50h）
  KR2: 建立监控告警体系（100h）
```

## 查看 OKR 进度

```
用户：查看 Q1 OKR 进度

Agent：
=== 2026-Q1 OKR 进度 ===

q_2026-Q1_1: 完成系统架构升级 — 92%（185/200h）🟢
  完成核心模块重构：95/100h
  完成性能优化：62/80h
  编写技术文档：28/20h ✅

q_2026-Q1_2: 提升系统稳定性 — 45%（67/150h）🟡
  解决生产环境 P0 问题：32/50h
  建立监控告警体系：35/100h ⚠️ 落后

本周投入趋势：
  W09: 42h | W10: 38h | W11: 45h

建议：OKR2 进度落后，建议下周增加监控告警投入。
```

## 生成月报 + OKR 对齐分析

```
用户：生成3月月报，分析工作与 OKR 的对齐情况

Agent：
=== 2026-03 月报 ===

总计：168.0h | 95条任务 | 22个工作日
日均：7.6h

OKR 对齐分析：
- 对齐工时：142.0h（85%）
- 已对齐 OKR：q_2026-Q1_1, q_2026-Q1_2
- 未对齐工作：
  临时运维支持：12.0h（无对应 OKR 覆盖）
  部门会议协调：8.0h（无对应 OKR 覆盖）

OKR 进度预警：
- q_2026-Q1_1：72% 🟢 on_track
- q_2026-Q1_2：45% 🟡 at_risk
  → 进度落后，建议增加投入

下月建议：
- 增加性能优化专项投入（q_2026-Q1_2）
- 预估 40h 可追回进度

已保存到 monthly/2026-03-report.json
```

## 生成季报 + OKR 智能提炼

```
用户：生成Q1季报，并基于数据提炼下季度 OKR 建议

Agent：
=== 2026-Q1 季报 ===

总计：520h | 280条任务 | 63个工作日

OKR 完成情况：
- q_2026-Q1_1 完成系统架构升级：92% 🟢 mostly_complete
  - 完成核心模块重构：100% ✅
  - 完成性能优化：80%
  - 编写技术文档：140% ✅
- q_2026-Q1_2 提升系统稳定性：78% 🟡 partially_complete
  - 解决 P0 问题：100% ✅
  - 监控告警体系：62% ⚠️

TOP3 工作领域：
1. #系统优化 180h (35%)
2. #深圳友联 95h (18%)
3. #性能优化 80h (15%)

月度趋势：160h → 172h → 188h（递增）

下季度 OKR 建议：
1. 深化系统性能优化
   依据：Q1 性能优化投入 120h，已完成 80%
   KR: 将核心接口响应时间降至 50ms 以下
   KR: 完成负载均衡方案落地

2. 建立运维自动化体系
   依据：Q1 运维投入 95h，具备自动化基础
   KR: 实现核心服务 90% 自动化部署
   KR: 建立完善的监控告警体系

已保存到 quarterly/2026-Q1-report.json
```

## 生成年报 + 年度 OKR 复盘

```
用户：生成2026年度报告，复盘全年 OKR 完成情况

Agent：
=== 2026 年度报告 ===

总计：2,080h | 1,100条任务 | 260个工作日

季度 OKR 汇总：
- Q1: 2/3 完成（520h）
- Q2: 3/3 完成（540h）
- Q3: 2/2 完成（510h）
- Q4: 1/2 完成（510h）
完成率：75%（8/10）

年度 OKR 对齐：
- y_2026_1 技术架构现代化：85%（680h）
  贡献季度：Q1, Q2, Q3
- y_2026_2 团队效能提升：65%（420h）
  贡献季度：Q1, Q2, Q4

下一年度 OKR 建议：
1. 构建自动化运维体系
   依据：全年运维投入 360h（17%），具备自动化基础
   KR: 实现核心服务 90% 自动化部署
   KR: 建立完善的监控告警体系

2. 推进技术人才培养
   依据：全年代码评审和文档投入 280h（13.5%）
   KR: 建立内部技术分享机制（每月 2 次）
   KR: 输出 10 篇技术文档

已保存到 yearly/2026-report.json
```


path: examples/basic-usage.md
content: # 基本使用示例

## 记录工作日志

```
用户：记录今天的工作：
1.排查深圳友联流程数据重复(1h)
2.排查深圳友联EDC流程待办(1h)
3.db服务添加执行日志测试压缩序列化性能(1.5h)
4.优化crs协同服务序列化压缩(1.5h)
5.crsweb后端方案实施(2.2h)

Agent：
已记录 5 条工作日志到 daily/2026-03-06.json：
- #深圳友联 2.0h（2条）
- #后端 3.2h（2条）
- #性能优化 1.5h（1条）
总计 8.2h
```

## 修改日志

```
用户：修改3月3日的工作日志，把开发时间改为4小时

Agent：
已更新 daily/2026-03-03.json：
- 原：crsweb后端方案实施 2.2h -> 4.0h
- 当日总计：6.5h -> 8.3h
```

## 创建周计划

```
用户：创建下周工作计划：
1.完成 crsweb 后端方案（高优先级）
2.协助测试团队回归测试（中优先级）
3.代码评审和文档更新（低优先级）

Agent：
已创建 plans/2026-W11.json：
- 高优先级 1 项：完成 crsweb 后端方案
- 中优先级 1 项：协助测试团队回归测试
- 低优先级 1 项：代码评审和文档更新
```

## 更新计划进度

```
用户：把"完成 crsweb 后端方案"标记为已完成，实际花了 12 小时

Agent：
已更新 plans/2026-W11.json：
- [x] 完成 crsweb 后端方案（预估 8h -> 实际 12h）
- [ ] 协助测试团队回归测试
- [ ] 代码评审和文档更新
完成率：33%（1/3）
```

## 生成周报

```
用户：生成本周周报，对比计划执行情况

Agent：
=== 2026-W10 周报 ===

总计：42.5h | 25条任务 | 5个工作日
日均：8.5h

TOP3 标签：
1. #深圳友联 15.0h (35%)
2. #系统优化 12.0h (28%)
3. #会议 8.5h (20%)

计划执行：
- 计划 8 项，完成 6 项（75%）

OKR 贡献：
- q_2026-Q1_1 完成系统架构升级：25.0h / 12条

已保存到 weekly/2026-W10-report.json
```

## 查看报告

```
用户：显示本周周报

Agent：（读取 weekly/2026-W10-report.json 并展示）
```


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)