# jw-agenda-daily-todo

> Daily todo manager: generate today's plan, reschedule items, add ad-hoc tasks. Triggers: '生成今天的计划', 'today plan', '把X移到周三', '加一项', '明天要', '运行 daily-todo'. (Marking completion is handled by 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-todo:20260209140826

---

---
name: jw-agenda-daily-todo
description: "Daily todo manager: generate today's plan, reschedule items, add ad-hoc tasks. Triggers: '生成今天的计划', 'today plan', '把X移到周三', '加一项', '明天要', '运行 daily-todo'. (Marking completion is handled by daily-log.)"
metadata:
  author: Jing Wu
  version: "0.1.0"
  updated: "2026-02-09"
---

# Daily Todo（处理当天）

管理今日 todo 的全生命周期：生成、调整。

**时间表**：今日时间表用来安排每天要做的事项。**优先**读取用户工作区 jw-agenda 根目录下的 `schedule-config.md`（即 `{agendaRoot}/schedule-config.md`）的「时段定义」表；若该文件不存在，则使用本 Skill 的 `assets/schedule-config.example.md`。固定活动（如出门、晚餐）不覆盖，仅「（填入当日任务）」的时段填入具体事项。

**汇报规则**：每次新增或更新 todo 后，**必须告诉用户修改了哪些文件的实际路径**。

## 安装前提

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

## 约定

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

## 模式选择

根据用户意图自动选择：

| 触发场景 | 模式 |
|---------|------|
| 「生成今天的计划」「today plan」 | 模式 A：生成（见下方） |
| 「今天完成得怎么样」「还剩哪些」 | 模式 B1：查询进度（见下方） |
| 「Y 不做了」「取消」「推迟」等 | 模式 B2：更新状态（见下方） |
| 「把 X 移到周三」「推迟到下周」 | 模式 C：调整日程 → 读取 `references/mode-c-reschedule.md` |
| 「加一项」「明天要」「本月要」「以后要」等 | 模式 D：临时追加 → 读取 `references/mode-d-adhoc.md` |

---

## 模式 A：生成今日 Todo

### Step 1: 确定日期

计算今天日期（YYYY-MM-DD）、当月、年内周数（推荐使用本 Skill 的 `assets/scripts/date_utils.py`）。

### Step 2: 读取来源

按顺序读取（缺失则跳过）：

1. **当月规划**：`{agendaRoot}/monthly/YYYY-MM-plan.md`（当前年月，如 2026-02-plan.md，可用 date_utils 推算），提取本月目标与本周重点
2. **当周规划**：`{agendaRoot}/weekly/Week{W}-plan.md`，提取「今天」对应的建议任务
3. **昨天未完成**：从 `{agendaRoot}/daily/{昨天日期}-log.md` 或 `{昨天日期}-todo.md` 中未勾选项
4. **tasks 目录下以 todo 开头的文件**（可选）：如 `{agendaRoot}/tasks/TODO.md`、`todo-readinglist.md`、`todo-*.md`。读取其中未勾选项，酌情纳入今日计划（如 1–2 项低优先级或按清单性质分配），并标记 `*(来自 tasks 清单)*` 或 `*(来自阅读清单)*`（若来自 todo-readinglist.md）

### Step 3: 合并、去重、排优先级

**幂等性检查**：若今日 todo 已存在，读取现有条目，归一化比较（忽略勾选状态、来源标记、前后空格），已存在的条目不再追加。

**去重规则**：三个来源中内容相同或高度相似的事项只保留一条。若某条既在昨天未完成又在规划中，以 `*(从昨天转移)*` 标记。

**来源标记与优先级**：按 `conventions.md` 中的来源标记和优先级标识规则执行。

### Step 4: 写入文件

**路径**：`{agendaRoot}/daily/{今天日期}-todo.md`

使用 `assets/todo-template.md` 模板，**必须包含**：

1. **今日时间表**：优先从 `{agendaRoot}/schedule-config.md` 读取时段配置；若不存在则从本 Skill 的 `assets/schedule-config.example.md` 读取。把当日任务填入各时段「安排」列。优先从周规划中「今天」的时段提取；若无，则按优先级合理分配。每个时段写具体事项。
2. **高/中/低优先级**：任务列表，与时间表一致，带来源标记，供逐项勾选。

若文件已存在，仅追加不重复的新条目；时间表若已存在则保留不覆盖。

### Step 5: 汇报

**必须首先说明**：已写入/已更新的文件路径。再说明各优先级项数、来源分布。

---

## 模式 B：追踪当日完成

### B1：查询进度

读取今日 todo，统计已完成（`[x]`）/ 未完成（`[ ]`），按优先级汇总，不修改文件。

### B2：更新状态

识别目标条目和新状态，在今日 todo 中更新：已完成 → `[x]`；进行中 → `[ ]` 加 `（进行中）`；取消 → `[x]` 加 `（取消）`；推迟无目标日 → 加 `（推迟）`；推迟有目标日 → 转入模式 C。确认并说明已更新的文件路径。

---

## Error Handling

| 情况 | 处理 |
|------|------|
| 月/周/昨天来源不存在 | 跳过，用已有数据生成 |
| 三个主来源都不存在 | 生成空框架 todo，标注"无数据来源，请手动补充" |
| 今日 todo 已存在（模式 A） | 幂等处理：仅追加不重复的新条目 |
| 目标日期歧义（模式 C/D） | 推算后向用户确认具体日期 |
| 临时追加目标文件不存在（模式 D） | 可创建最小框架再追加，或告知用户 |

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

- **若安装了 daily-log**：它可能已写入今日 todo 的「从昨天转移」项，本 Skill 合并时会识别并保留不重复。未安装时不影响本 Skill 正常工作。
- **若安装了 weekly-plan**：本 Skill 读取其产出的周规划作为当日计划来源之一。未安装时跳过该数据来源。
- **若安装了 planning-sync**：可在本 Skill 运行后检查日/周/月一致性。未安装时不影响本 Skill。

## Resources

- `assets/todo-template.md`：每日 todo 输出模板
- `assets/conventions.md`：约定
- `assets/schedule-config.example.md`：默认作息模板（用户可选 jw-agenda 根目录下的 `schedule-config.md` 覆盖）
- `assets/scripts/date_utils.py`：日期处理工具
- `assets/scripts/dedup_todos.py`：去重工具
- `references/mode-c-reschedule.md`：模式 C 调整日程详细流程
- `references/mode-d-adhoc.md`：模式 D 临时追加详细流程