工作日/周/月/年报总结

SKILL.md

---
name: work-report
display_name: 工作汇报生成器
display_name_en: Work Report Generator
description: >
  工作汇报生成器（日报→周报→月报→年报，层层叠加）。
  用户只需提供几个关键词或口水话，自动生成自然的工作汇报。
  强制去AI味（白话表达、口语断句、禁止作文结构）。
  触发词：日报、周报、月报、年报、工作汇报、工作总结，"今天搞了"、"这周做了"等任意输入。
category: Productivity
tags: [report, weekly, daily, monthly, annual, 工作汇报, 周报, 去AI味, 关键词输入]
version: 1.0.0
metadata:
  clawdbot:
    emoji: "📊"
    always: false
  requires:
    bins: []
  reportStoragePath: ".workbuddy/reports/"
---

# 工作汇报生成器 📊

层层叠加的智能汇报系统：日报 → 周报 → 月报 → 年报。
每一层自动读取上一层的历史内容，生成连贯、自然、有人味的工作汇报。

---

## 核心设计原则

### 1. 层层叠加逻辑

```
日报（每日记录）
  ↓ 自动汇总本周所有日报
周报（本周总结）
  ↓ 自动汇总本月所有周报
月报（本月总结）
  ↓ 自动汇总本年所有月报
年报（年度总结）
```

**存储路径**：`{workspace}/.workbuddy/reports/`
- 日报：`reports/daily/2026-06-05.md`
- 周报：`reports/weekly/2026-W23.md`
- 月报：`reports/monthly/2026-06.md`
- 年报：`reports/annual/2026.md`

### 2. 去 AI 味强制规范（⚠️ 必须遵守）

生成内容必须满足以下标准，否则重生成：

**❌ 禁止的 AI 味表达**
- "首先…其次…最后…" 结构
- "总之…"、"综上所述…" 结尾
- "值得注意的是"、"需要强调的是"
- 过度使用"了"字句（"完成了…"、"优化了…"）
- 每句话都是完整句式，没有口语化断句
- Emoji 滥用（最多每500字用1个，且只在标题用）
- "通过…使…"、"在…下、" "随着…" 套话开头

**✅ 推荐的白话表达**
- 用"这周搞定了"、"上周留了个坑"代替正式书面语
- 问题与计划用短句，甚至不完整句
- 适当用"但"、"其实"、"倒是"等口语转折
- 数字直接写，不用"达到XX的高水平"这种修饰
- 问题部分写真实感受，不写"有待提升"

**去 AI 味检查清单（生成后自测）**
1. 读一遍，有没有哪里像"作文"？→ 改掉
2. 有没有连续3个"了"字句？→ 换句式
3. 有没有"首先/其次/最后"？→ 删掉，用自然分段
4. 整体读起来像不像真人写的周报？→ 不像就重写

### 3. 输入方式：关键词/口水话直接生成（核心能力 ⭐）

**用户不需要写正式描述，随便说几个词就行。**

接受以下任意输入形式：

```
# 形式1：纯关键词
"登录bug、数据导出、3个线上bug"

# 形式2：口水话/碎碎念
"今天登录那块终于搞完了，卡了两天的配置问题，改完就过了。
数据导出加了Excel，产品催好久。还修了3个bug。"

# 形式3：极简记录
"今天：登录搞定，导出功能上线，修3个bug"

# 形式4：混合
"周报。这周主要搞了登录和导出，登录有个安全漏洞修掉了，
导出产品那边一直催。下周搞性能优化。"
```

**处理逻辑**：
1. 识别输入中的：完成了什么、遇到什么问题、下周/明天计划
2. 口水话原样保留语感，不"翻译"成书面语
3. 关键词扩展成自然短句，不扩展成作文句式
4. 没有提到的部分留空或写"无"，不编造

**关键词 → 自然句 转换规则**（⚠️ 必须遵守）：

| 用户输入 | ✅ 正确展开 | ❌ 错误展开（AI味） |
|---------|-------------|-------------------|
| "登录bug" | "登录那块有个bug，修了一天" | "完成了登录模块bug修复，提升了系统稳定性" |
| "数据导出Excel" | "数据导出加了Excel，产品催好久" | "实现了数据导出功能，支持Excel格式" |
| "联调卡了" | "联调卡了，对方接口一直报错" | "在接口联调过程中遇到了技术难题" |
| "下周搞性能" | "下周搞性能优化，接口有点慢" | "下周计划重点推进系统性能优化工作" |

### 4. 字数控制

| 汇报类型 | 默认字数 | 可调整范围 |
|---------|----------|------------|
| 日报 | 150-300字 | 100-500字 |
| 周报 | 400-800字 | 300-1200字 |
| 月报 | 800-1500字 | 500-2000字 |
| 年报 | 1500-3000字 | 1000-4000字 |

用户提供字数要求时，严格遵守。没有要求时用默认值。

---

## 使用流程

**核心原则：用户随便说，AI 来整理。不要让用户填表。**

### Step 1：识别汇报类型

从用户输入中判断是日报/周报/月报/年报。
- 用户说"写个周报" → 周报
- 用户说"帮我汇总下这周" → 周报
- 用户说"6月总结" → 月报
- 用户只扔了一堆关键词 → 默认为日报（今日）

### Step 2：接受任意形式的输入（不做审讯式提问）

**✅ 正确做法）** 用户怎么给，就怎么用：

```
用户："登录bug 数据导出 Excel 修3个bug"
→ 直接生成，不提问

用户："今天登录搞完了，导出也上了，bug修仨"
→ 直接生成，保留口语感

用户："写周报，这周就搞了登录和导出"
→ 基于口水话生成，再去读每日日报做补充
```

**❌ 错误做法（禁止使用）**：
```
"请问您本周完成了哪些工作？遇到了什么问题？下周计划是什么？"
↑ 这种审讯式提问，禁止。
```

**最小询问策略**：
- 用户给了关键词/口水话 → **不追问**，直接生成
- 用户只说"写周报"啥也没给 → 读历史日报，有内容就基于历史生成；历史也没有 → 只问一句："这周搞了啥？随便说几个词就行"
- 用户说"没了"/"就这些" → 基于已有内容生成，不逼问

### Step 3：读取历史汇报（自动，静默进行）

生成周报前，静默读取本周日报（不询问用户）：
```bash
ls .workbuddy/reports/daily/ 2>/dev/null | grep "2026-06" && cat .workbuddy/reports/daily/2026-06-*.md
```

同理，月报读本月周报，年报读本月月报。

**历史内容作为补充素材，不覆盖用户刚提供的输入。**
用户刚说的话优先级最高。

### Step 4：生成汇报（严格遵守去 AI 味规范）

生成后，执行**去 AI 味自检**（不达标就重写）：

```
读一遍生成的内容：
1. 有没有"首先/其次/最后/总之"？→ 重写
2. 每句话都是完整书面句？→ 加入口语断句
3. 有没有过度使用"了"字句？→ 换句式
4. 读起来像人写的周报？→ 不像就重写
```

### Step 5：展示给用户并保存

先展示，问一句"要不要改点啥？"，用户满意后再保存。

保存路径：
```bash
mkdir -p .workbuddy/reports/daily
mkdir -p .workbuddy/reports/weekly
mkdir -p .workbuddy/reports/monthly
mkdir -p .workbuddy/reports/annual

# 日报示例
cat > .workbuddy/reports/daily/2026-06-05.md << 'EOF'
[生成的内容]
EOF
```

---

## 去 AI 味示例对比

### ❌ 典型 AI 味（禁止使用）

> 本周主要完成了以下功能模块的开发工作：首先，完成了用户登录模块的优化，提升了系统安全性；其次，完成了数据导出功能的开发，支持Excel和CSV两种格式；最后，修复了3个线上bug，提升了系统稳定性。下周计划重点推进性能优化工作。

### ✅ 自然白话（必须使用）

> 这周主要搞了三件事：登录那块终于优化了，之前被人扫到有个漏洞；数据导出加了Excel和CSV，产品催了好久；还修了3个线上bug。
> 
> 下周重点搞性能优化，接口响应时间有点拉胯。

---

## 输入示例：口水话 → 完整汇报

### 示例1：纯关键词输入（日报）

**用户输入**：
```
今天：登录bug、数据导出Excel、修3个线上bug
```

**✅ 正确输出**：
```
# 6月5日 工作记录

今天主要搞了三件事：

登录那个 bug 终于修掉了，是个安全漏洞，扫出来好几天了一直没空看，今天总算处理完。

数据导出加了 Excel 格式，之前只支持 CSV，产品提了好几次，这周抽空给加上了。

还修了3个线上 bug，都是小问题，修完直接发了。

明天打算把导出那块的文档补一下，这周一直没空写。
```

---

### 示例2：口水话输入（周报）

**用户输入**：
```
周报。这周登录搞完了，有个漏洞扫出来修掉了。
导出加了Excel，产品催好久。
接口联调卡了两天，对方一直没回，下周再催下。
```

**✅ 正确输出**：
```
# 本周工作汇报（6/2 - 6/5）

## 这周干了啥
- 登录模块的安全漏洞修掉了，扫出来好几天，总算搞完
- 数据导出加了 Excel 支持，之前只有 CSV，产品催了好几次
- 修了几个线上 bug，都是小问题，当天就发了

## 遇到的问题
接口联调卡了两天，对方一直没回消息，这周没搞定。

## 下周打算
- 继续催联调那边的接口
- 把导出功能的文档补了
- 看下性能优化的事能不能这周开个头
```

---

### 示例3：极简输入（月报）

**用户输入**：
```
月报。6月主要搞了登录和导出，登录有个漏洞。
联调一直卡着，对方不配合。
7月打算搞性能优化和埋点。
```

**✅ 正确输出（节选）**：
```
# 6月工作月报

## 这月干了啥
本月主要搞了两块：登录安全和数据导出。

登录那块扫出来一个漏洞，中危，搞了两天修掉了，已经发到线上。

数据导出原来只支持 CSV，产品和使用者都吐槽过，这个月把 Excel 加上了，顺带重构了一下导出逻辑，比原来快了不少。

## 卡住的地方
XX 系统的接口联调，这个月基本没推进，对方一直不回消息，试过几次都没对接上。打算下个月换个对接人试试。

## 下月打算
- 性能优化先搞接口响应时间，现在有些慢
- 埋点整理一下，现在比较乱
- 看下能不能把联调的事推一推
```

---

## 触发词与触发方式

| 用户说 | 动作 |
|--------|------|
| "写个日报" / "日报" | 生成今日日报 |
| "写周报" / "周报" | 读取本周日报 → 生成周报 |
| "写月报" / "月报" | 读取本月周报 → 生成月报 |
| "写年报" / "年终总结" | 读取本年所有月报 → 生成年报 |
| "今天搞了XXX" / 任意口水话 | 自动识别为日报，直接生成 |
| "这周主要XXX" / 任意口水话含周 | 自动识别为周报，直接生成 |
| 扔几个关键词过来（无明确指令） | 默认按日报处理，生成后询问确认 |

**关键原则**：不管用户怎么输入，都不追问"请详细描述"，直接从口水话/关键词生成。

---

## 注意事项

1. **禁止编造数据**：历史汇报里没有的内容，不能凭空加入
2. **禁止过度美化**：问题部分要真实，不写"有待提升"这种废话
3. **口语化优先**：宁可不够"专业"，也不要一股作文味
4. **历史读取失败要告知用户**：不要静默跳过，问用户要输入
5. **字数严格遵守**：超字数要删减，不足要丰富（但不能水字数）

---

## 后续扩展方向

- [ ] 接入 Git 自动提取 commit 作为日报素材
- [ ] 接入任务管理器（TAPD/飞书项目）自动汇总
- [ ] 支持导出 PDF/直接发送至企微/钉钉
- [ ] 多语言支持（英文汇报）