211 lines
5.0 KiB
Markdown
211 lines
5.0 KiB
Markdown
|
---
|
|||
|
|
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: 设置周报总结
|
|||
|
|
|
|||
|
|
为某周添加总结文字。
|
|||
|
|
|
|||
|
|
**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. 建议每次完成工作后及时记录，便于周末生成周报
|