# jw-agenda-daily-log

> Daily log generator: summarize yesterday or accept today's progress (casual or single-sentence), generate dated log file, update today's todo checkboxes, transfer incomplete to today. Triggers: '整理昨天的日志', '总结昨天', '汇报今天', '记录一下今天', '我完成了 X', '作业做完了', 'daily log', '运行 daily-log'.

- Author: janewu77
- Repository: janewu77/jw-skills
- Version: 20260209140826
- Stars: 1
- Forks: 0
- Last Updated: 2026-02-09
- Source: https://github.com/janewu77/jw-skills
- Web: https://mule.run/skillshub/@@janewu77/jw-skills~jw-agenda-daily-log:20260209140826

---

---
name: jw-agenda-daily-log
description: "Daily log generator: summarize yesterday or accept today's progress (casual or single-sentence), generate dated log file, update today's todo checkboxes, transfer incomplete to today. Triggers: '整理昨天的日志', '总结昨天', '汇报今天', '记录一下今天', '我完成了 X', '作业做完了', 'daily log', '运行 daily-log'."
metadata:
  author: Jing Wu
  version: "0.1.0"
  updated: "2026-02-09"
---

# Daily Log（日志与汇报）

总结昨天的工作并生成日志，或将当天口语化汇报整理成日志；未完成事项转移到今日 todo。
记录已经完成的或正在进行的事项的进度。

**与 daily-todo 的分工**：若是未完成、未开始事件的调整，由daily-todo来完成。

**口语化汇报**：用户汇报进度时可能很口语、带想法。从汇报中解析出：完成的事、未完成的、时间分配；想法、感受、随口说的内容单独放进日志的「今日想法/随口记」区块，原意保留、不丢弃。汇报后必须告诉用户日志写入路径。

## 安装前提

本 Skill 仅依赖用户 workspace 下存在 **jw-agenda 根目录**（默认 `jw-agenda-data`，可经 workspace 根目录的 `.jw-agenda.json` 或 `jw-agenda.json` 配置）及子目录 monthly、weekly、daily、tasks；可选 jw-agenda 根目录下的 `schedule-config.md` 用于自定义作息。
先按 conventions 解析 jw-agenda 根目录。

## 约定

开始前读取**本 Skill 的 `assets/conventions.md`** 获取文件命名、路径和日期规则。

## 两种用法

| 用户意图 | 处理方式 |
|----------|----------|
| 总结昨天 / 整理昨天的日志 | 读昨天 todo 与已有数据 → 生成昨天日志 → 未完成转移今天 |
| 汇报今天 / 记录一下今天（含口语、想法） | 解析用户当天的口语化汇报 → 生成今天日志 → 同步更新今天 todo 勾选 → 未完成保留或转移 |

---

## Workflow

### Step 1: 确定日期与数据来源

- **若用户要「总结昨天」**：计算昨天日期（推荐使用本 Skill 的 `assets/scripts/date_utils.py`）；读取 `{昨天日期}-todo.md`、`{昨天日期}-log.md`（若有）；从数据中识别已完成 / 未完成 / 时间分配 / 学习产出。
- **若用户「汇报今天」（口语化）**：计算今天日期；从用户输入中解析完成的事、未完成、时间或顺序、想法/感受/碎碎念。

### Step 2: 生成日志文件

使用 `assets/log-template.md` 模板，填充变量后写入：

**路径**：jw-agenda 根目录下的 `daily/{目标日期}-log.md`（即 `{agendaRoot}/daily/{目标日期}-log.md`）

**模板变量**：`{{DATE}}`、`{{COMPLETED_TASKS}}`、`{{TIME_ALLOCATION}}`、`{{LEARNING_OUTPUT}}`、`{{INCOMPLETE_TASKS}}`、`{{SUMMARY}}`、`{{NOTES_AND_THOUGHTS}}`（想法/随口记，无则写「无」）、`{{TIMESTAMP}}`。

若 jw-agenda 根目录下的 `daily/` 不存在则创建。

### Step 3: 同步今日 Todo 与转移未完成

- **若本次是「汇报今天」**：在 `{今天日期}-todo.md` 中根据完成项勾选 `[x]`；若今日 todo 不存在则只写日志。
- **若本次是「总结昨天」且有未完成**：在 `{今天日期}-todo.md` 追加未完成项，标记 `*(从昨天转移)*`，跳过已存在条目。

### Step 4: 汇报

向用户说明：已写入日志路径、完成概况、转移数量。

## Error Handling

| 情况 | 处理 |
|------|------|
| 昨天 todo 不存在 | 仅从已有文件推断活动，若也无内容则生成空模板日志 |
| 昨天日志已存在 | 向用户确认是否覆盖或追加，默认不覆盖 |
| 目录不存在 | 自动创建 |
| 今日 todo 已存在且含相同条目 | 跳过重复条目 |

## 与其他 Skill 的配合（可选）

- 若安装了 **daily-todo**：它会读取本 Skill 写入的「从昨天转移」项，合并时保留不重复。未安装时不影响本 Skill。
- 若安装了 **weekly-review**：它会汇总本 Skill 产出的每日日志。未安装时不影响本 Skill。

## Resources

- `assets/log-template.md`：日志输出模板
- `assets/conventions.md`：约定
- `assets/scripts/date_utils.py`：日期计算脚本