Biweekly Work Report Skill

Record daily work and generate structured weekly/biweekly reports. All logs are plain Markdown files — readable and writable by any AI tool (Claude Code, Cursor, Codex, WorkBuddy). No servers, no databases.

Trigger Words

Data Location

~/.workbuddy/work-logs/          ← canonical, never move this
├── YYYY-MM-DD.md                ← one file per day
├── YYYY-MM-DD.md
└── ...

Skill updates never touch data. Data is always local, always Markdown.

Recording Work

Step 1: Determine today's date

Use YYYY-MM-DD format in Asia/Shanghai timezone.

Step 2: Read or create daily file

Read ~/.workbuddy/work-logs/YYYY-MM-DD.md. If it doesn't exist, create it with this template:

# YYYY-MM-DD DayOfWeek

## 工作记录

Step 3: Append entries

Format: - [HH:MM] 【Category】Description

Categories:

Rules:

• Always append, never overwrite existing entries.
• Use the time the user provides, or current time if not stated.
• One entry per distinct activity. Split compound descriptions.
• Descriptions in Chinese, one sentence. Keep it concise.

Examples:

User: "记录：上午完成了登录模块重构"
→ Append: - [09:00] 【开发】完成登录模块重构

User: "下午开了技术评审会，然后修了一个支付回调的bug"
→ Append:
- [14:00] 【会议】参加技术方案评审会
- [16:00] 【修bug】修复支付回调签名校验失败问题

Generating Reports

Step 1: Determine date range

• "本周周报" → Monday through today (current week).
• "上周周报" → Monday through Friday (last week).
• "双周报" → 14 days ending today, or the most recent two calendar weeks.
• Custom range → use explicit user dates.

Step 2: Collect data

Read all ~/.workbuddy/work-logs/YYYY-MM-DD.md files within the date range. Skip days with no entries or no file.

Step 3: Generate report

Output format (see references/report-template.md for the full spec):

# 工作周报 — YYYY.MM.DD ~ YYYY.MM.DD

## 一、本周重点工作
- (merge related entries into 2-5 high-level items, quantify days)

## 二、详细工作记录
### YYYY-MM-DD (DayOfWeek)
- [HH:MM] 【Category】Description
...

## 三、下周计划
- [ ] (infer from trajectory, or leave placeholder)

## 四、问题与风险
- (extract from 【修bug】entries and blocking mentions)

---
*生成时间: YYYY-MM-DD HH:MM*

Step 4: Output location

Write to the current workspace directory (or user-specified path). Default filename: 工作周报_YYYY-MM-DD~YYYY-MM-DD.md.

Report writing guidelines

• 重点工作: Group by topic, not by category tag. Extract 2-5 themes that span multiple entries. Quantify (e.g. "耗时3天").
• 详细记录: Chronological. Keep original entries verbatim.
• 下周计划: Infer from work trajectory. If unclear, add 待补充 and remind the user.
• 问题与风险: Extract from 【修bug】entries and blocking issues. If none found, write "暂无显著风险".

Reference Files

Cross-Tool Design

Key design decisions for multi-tool compatibility:

1. Plain Markdown — no databases, no proprietary formats.
2. Fixed data path — ~/.workbuddy/work-logs/ is canonical.
3. Zero dependencies — all logic in AI prompt instructions.
4. Data-skill separation — updating SKILL.md never touches logs.