chinaweal-claude-code/skills/work-weekly-report/SKILL.md

---
name: work-weekly-report
description: |
  工作周报管理工具。用于管理个人工作周报，包括制定本周工作计划、记录日常工作、更新工作进度、查询历史周报等。

  当用户提到以下场景时使用此 Skill：
  (1) 制定本周工作计划、安排工作
  (2) 更新今天或指定日期的工作记录
  (3) 查看本周未完成的工作
  (4) 查询指定工作周的周报
  (5) 用户提到 "周报"、"工作计划"、"工作记录"、"工作周"
argument-hint: "[操作] [参数]"
allowed-tools: Read, Bash, Glob, Grep
---

# 工作周报管理 Skill

## 概述

此 Skill 用于管理个人工作周报，支持工作计划制定、日常工作记录、未完成工作统计和历史周报查询。

## 工作周定义

- **工作周**: 周一至周五（法定工作日）
- **周编号**: ISO 8601 标准，格式 `YYYY-Www`（如 `2026-W15` 表示 2026 年第 15 周）
- **周起始**: 周一为该周的第一天，周五为最后一天

## 数据存储

数据存储在 `data/weekly-reports.json` 文件中，采用 JSON 格式。

## 功能清单

### 功能1: 制定本周工作计划

为当前工作周制定或更新工作计划。

**使用示例**:
```
制定本周工作计划
安排本周工作
本周计划完成 A、B、C 任务
```

**CLI 命令**:
```bash
# 制定本周计划
node scripts/work-weekly-report.js plan --tasks "任务1" "任务2" "任务3"

# 制定指定周计划（带优先级）
node scripts/work-weekly-report.js plan --week "2026-W15" --tasks "任务1" "任务2" --priority high
```

---

### 功能2: 更新工作记录

记录指定日期的实际工作情况。

**使用示例**:
```
更新今天的工作记录
记录今天完成的工作
更新 2026-04-10 的工作
```

**CLI 命令**:
```bash
# 更新今天的工作记录
node scripts/work-weekly-report.js record --content "完成了XX任务" --status completed

# 更新指定日期的工作记录
node scripts/work-weekly-report.js record --date "2026-04-09" --content "继续开发XX功能" --status in-progress

# 带工时记录
node scripts/work-weekly-report.js record --date "2026-04-10" --content "完成代码审查" --status completed --hours 2
```

---

### 功能3: 输出本周未完成的工作

汇总当前工作周中未完成的任务。

**使用示例**:
```
本周有哪些未完成的工作
查看未完成任务
本周还有什么没做完的
```

**CLI 命令**:
```bash
node scripts/work-weekly-report.js pending
node scripts/work-weekly-report.js pending --week "2026-W15"
```

---

### 功能4: 查询指定工作周的周报

查看指定工作周的工作计划与实际记录。

**使用示例**:
```
查询 2026-W15 的周报
查看第 15 周的工作情况
查看上周的周报
本周工作总结
```

**CLI 命令**:
```bash
# 查询本周
node scripts/work-weekly-report.js query

# 查询指定周
node scripts/work-weekly-report.js query --week "2026-W15"

# 简洁摘要格式
node scripts/work-weekly-report.js query --week "2026-W15" --format summary
```

---

### 功能5: 更新计划项状态

将某个计划项标记为完成或其他状态。

**使用示例**:
```
把任务A标记为完成
更新计划项状态
```

**CLI 命令**:
```bash
node scripts/work-weekly-report.js update-status --week "2026-W15" --plan-item "uuid" --status completed
```

---

### 功能6: 延期计划项

将某个计划项的预计完成日期延长到指定日期，并可记录延期原因。

**使用示例**:
```
把任务A延期到下周三
任务B需要延期到4月20日
将计划项延长一周
```

**CLI 命令**:
```bash
# 延期计划项
node scripts/work-weekly-report.js extend-plan --plan-item "uuid" --new-date "2026-04-20"

# 带延期原因
node scripts/work-weekly-report.js extend-plan --plan-item "uuid" --new-date "2026-04-22" --reason "等待外部依赖"
```

**延期记录**: 每次延期都会记录延期次数和原因，可在周报中查看。

---

### 功能7: 设置周报总结

为某周添加总结文字。

**CLI 命令**:
```bash
node scripts/work-weekly-report.js summary --week "2026-W15" --content "本周主要完成了..."
```

---

## 周标识支持

查询和操作支持多种周标识格式：

- `YYYY-Www` - ISO 格式（如 `2026-W15`）
- `本周`、`当前周` - 当前工作周
- `上周`、`上上周` - 相对上周
- `下周` - 相对下周

## 数据文件结构

```json
{
  "meta": {
    "version": "1.0.0",
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-04-13T09:30:00.000Z"
  },
  "weeklyReports": {
    "2026-W15": {
      "weekNumber": "2026-W15",
      "weekStartDate": "2026-04-07",
      "weekEndDate": "2026-04-11",
      "plan": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440001",
          "description": "完成项目 A 的开发工作",
          "expectedDate": "2026-04-10",
          "priority": "high",
          "status": "completed",
          "createdAt": "2026-04-07T09:00:00.000Z",
          "updatedAt": "2026-04-10T18:00:00.000Z"
        }
      ],
      "records": {
        "2026-04-07": [
          {
            "id": "660e8400-e29b-41d4-a716-446655440001",
            "content": "开始项目 A 的架构设计",
            "date": "2026-04-07",
            "status": "completed",
            "hours": 6,
            "planItemId": "550e8400-e29b-41d4-a716-446655440001"
          }
        ]
      },
      "summary": "本周主要完成了项目 A 的开发工作..."
    }
  }
}
```

## 注意事项

1. 数据文件会自动创建，首次使用时会初始化
2. 所有日期需为有效的法定工作日（周一至周五）
3. 建议每次完成工作后及时记录，便于周末生成周报