5.6 KiB
5.6 KiB
| name | description | argument-hint | allowed-tools |
|---|---|---|---|
| work-weekly-report | 工作周报管理工具。用于管理个人工作周报，包括制定本周工作计划、记录日常工作、更新工作进度、查询历史周报等。 当用户提到以下场景时使用此 Skill： (1) 制定本周工作计划、安排工作 (2) 更新今天或指定日期的工作记录 (3) 查看本周未完成的工作 (4) 查询指定工作周的周报 (5) 用户提到 "周报"、"工作计划"、"工作记录"、"工作周" | [操作] [参数] | Read, Bash, Glob, Grep |
工作周报管理 Skill
概述
此 Skill 用于管理个人工作周报，支持工作计划制定、日常工作记录、未完成工作统计和历史周报查询。
工作周定义
- 工作周: 周一至周五（法定工作日）
- 周编号: ISO 8601 标准，格式
YYYY-Www（如2026-W15表示 2026 年第 15 周） - 周起始: 周一为该周的第一天，周五为最后一天
数据存储
数据存储在 data/weekly-reports.json 文件中，采用 JSON 格式。
功能清单
功能1: 制定本周工作计划
为当前工作周制定或更新工作计划。
使用示例:
制定本周工作计划
安排本周工作
本周计划完成 A、B、C 任务
CLI 命令:
# 制定本周计划
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 命令:
# 更新今天的工作记录
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 命令:
node scripts/work-weekly-report.js pending
node scripts/work-weekly-report.js pending --week "2026-W15"
功能4: 查询指定工作周的周报
查看指定工作周的工作计划与实际记录。
使用示例:
查询 2026-W15 的周报
查看第 15 周的工作情况
查看上周的周报
本周工作总结
CLI 命令:
# 查询本周
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 命令:
node scripts/work-weekly-report.js update-status --week "2026-W15" --plan-item "uuid" --status completed
功能6: 延期计划项
将某个计划项的预计完成日期延长到指定日期，并可记录延期原因。
使用示例:
把任务A延期到下周三
任务B需要延期到4月20日
将计划项延长一周
CLI 命令:
# 延期计划项
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 命令:
node scripts/work-weekly-report.js summary --week "2026-W15" --content "本周主要完成了..."
周标识支持
查询和操作支持多种周标识格式：
YYYY-Www- ISO 格式（如2026-W15）本周、当前周- 当前工作周上周、上上周- 相对上周下周- 相对下周
数据文件结构
{
"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 的开发工作..."
}
}
}
注意事项
- 数据文件会自动创建，首次使用时会初始化
- 所有日期需为有效的法定工作日（周一至周五）
- 建议每次完成工作后及时记录，便于周末生成周报