Daily Log(日志与汇报)
总结昨天的工作并生成日志,或将当天口语化汇报整理成日志;未完成事项转移到今日 todo。 记录已经完成的或正在进行的事项的进度。
与 daily-todo 的分工:若是未完成、未开始事件的调整,由daily-todo来完成。
口语化汇报:用户汇报进度时可能很口语、带想法。从汇报中解析出:完成的事、未完成的、时间分配;想法、感受、随口说的内容单独放进日志的「今日想法/随口记」区块,原意保留、不丢弃。汇报后必须告诉用户日志写入路径。
安装前提
本 Skill 仅依赖用户 workspace 下存在 personal/agenda/ 及子目录(monthly、weekly、daily、tasks);可选 personal/agenda/schedule-config.md 用于自定义作息。约定与脚本已随本 Skill 安装,无需用户另行复制。
约定
开始前读取本 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 模板,填充变量后写入:
路径:personal/agenda/daily/{目标日期}-log.md
模板变量:{{DATE}}、{{COMPLETED_TASKS}}、{{TIME_ALLOCATION}}、{{LEARNING_OUTPUT}}、{{INCOMPLETE_TASKS}}、{{SUMMARY}}、{{NOTES_AND_THOUGHTS}}(想法/随口记,无则写「无」)、{{TIMESTAMP}}。
若 personal/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:日期计算脚本