# Work Journal — AI 工作秘书

> 不是又一个 todo 软件。是一个**主动找你**的秘书：
> 你随口说一句"明天下午3点评审会，还要跟进扩容审批"，它自动拆成日程 + 待办 + 工作记录；
> 早上 8 点推今日日程和待办，晚上 8 点问你今天的进展；周五一句"写周报"，它替你写。

这是一个 [OpenClaw](https://openclaw.ai) skill。核心思路：**记录靠随手，提醒靠主动，汇报靠自动**。todo 软件失败的原因是"记了不看"——这个秘书会自己来找你。

> 本包是纯 Markdown 规则 + 文件约定，**无脚本、无第三方依赖**：OpenClaw 跑得起来的平台（macOS / Linux / Windows）都能用。

## 这个包里有什么

```
work-journal/
├── README.md                ← 本文件
├── SKILL.md                 ← skill 定义（语义解析引擎 + 行为规则）
├── examples/
│   └── journal-sample.md    ← 一天的日记文件长什么样
└── vendor/
    └── dws-skills.zip       ← 钉钉官方技能包（可选联动用，见下文"钉钉"节）
```

## 安装（约 5 分钟）

### 1. 放置 skill 与数据目录

```bash
mkdir -p ~/.openclaw/workspace/skills
cp -r work-journal ~/.openclaw/workspace/skills/
mkdir -p ~/Documents/work-journal/journal
```

想换日记存放位置：改 SKILL.md 顶部"配置"表中的 `JOURNAL_DIR`。

### 2. 配置路由

在 `~/.openclaw/workspace/AGENTS.md` 中加入：

```markdown
## work-journal 路由

以下消息加载 work-journal skill 处理：
- 前缀 `记:`（工作记录）、`待办:`（待办）
- 描述工作内容、安排、待办的自然语言（语义识别）
- "今天做了什么"、"这周完成了什么"、"我有什么待办"、"写周报"、"提醒我..."
```

### 3. 创建每日主动推送的 cron（推荐）

让 OpenClaw 创建两条 cron（直接把下面这段话发给你的 OpenClaw 也行）：

> 创建两条 cron：
> ① 工作日每天 8:00，加载 work-journal skill，推送今日日程 + 未完成待办的晨间简报；
> ② 工作日每天 20:00，加载 work-journal skill，汇总今天的工作记录和待办完成情况，并问我"今天还有什么要记录的吗？"
> 两条都用 announce 模式推送到微信，timeoutSeconds 300。

### 4. 测试

给 OpenClaw 发：

```
今天把报表系统的验收标准跟张工对齐了，明天下午3点产品评审会，另外别忘了周五前交预算表
```

应收到类似回复：

```
✅ 已记录：跟张工对齐报表系统验收标准
📌 待办：交预算表（截止：周五）
📅 日程：明天 15:00 产品评审会 — 已创建提醒
```

## 可选联动

### 钉钉

钉钉官方开源了 **dws**（DingTalk Workspace CLI）及配套 OpenClaw 技能包：
https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli

本包已附带官方技能包 `vendor/dws-skills.zip`（含 dingtalk-calendar 日程、dingtalk-chat 消息等 skill 与完整参考文档，LICENSE/NOTICE 原样保留）。开启后：
- 日程类命题 → 自动创建**钉钉日程**（手机日历弹提醒）
- 提醒类命题 → 自动创建**钉钉待办**（待办 Tab 推送）
- 日报/周报 → 自动拉取你的**钉钉聊天记录、日程、待办**做数据源，比手工回忆全得多

开启步骤：

1. 按官方 repo 说明安装 dws CLI，并完成钉钉开放平台应用凭据配置
2. 解压 `vendor/dws-skills.zip` 到 `~/.openclaw/workspace/skills/`
3. 在本包 SKILL.md 配置表中把"钉钉联动"改为开启，并将文中 `<YOUR_DINGTALK_USERID>` 替换为你的钉钉 userId

> **更新策略**：`vendor/` 里的包只是装机起点。以后不必等本包更新——直接把官方 repo 地址发给你的 OpenClaw，让它自己拉最新版替换。

### 个人知识库

如果你维护个人 wiki，可开启知识库联动：工作记录涉及流程/制度/架构变更时，秘书会提示"要不要归档到知识库？"

## 它和 todo 软件的区别

| | todo 软件 | AI 工作秘书 |
|---|---|---|
| 录入 | 打开 app → 点新建 → 填表单 | 微信随口一句话，自动拆解分类 |
| 提醒 | 你得自己打开看 | 早晚主动推送 + 到点提醒 |
| 周报 | 自己翻记录回忆 | 一句"写周报"自动聚合生成 |
| 数据 | 锁在 app 里 | 纯 Markdown 文件，永远是你的 |

## License

MIT。欢迎改造成你自己的版本。
