| 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.2.0","updated":"2026-02-23"} |
Daily Todo（处理当天）
管理今日 todo 的全生命周期：生成、调整。
时间表：今日时间表用来安排每天要做的事项。优先读取用户工作区 jw-agenda 根目录下的 schedule-config.md（即 {agendaRoot}/schedule-config.md）的「时段定义」表；若该文件不存在，则使用本 Skill 的 assets/schedule-config.example.md。固定活动（如出门、晚餐）不覆盖，仅「（填入当日任务）」的时段填入具体事项。
汇报规则：每次新增或更新 todo 后，必须告诉用户修改了哪些文件的实际路径。
级联更新原则：当调整任务（添加、移动、推迟、取消等）时，必须从上往下逐层检查并同步更新，确保各层规划一致：
- tasks/TODO.md（总待办）→ 若任务需从总待办中移除或标记已规划，更新此文件
- 月规划（monthly/YYYY-MM-plan.md）→ 若任务涉及本月目标或跨周变动，更新月规划
- 周规划（weekly/Week{W}-plan.md）→ 若任务涉及当周，更新周规划对应日
- 日计划（daily/YYYY-MM-DD-todo.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 移到周三」「推迟到下周」「加一项」「明天要」「本月要」等 | 模式：添加/移动任务 → 读取 references/mode-add-or-move.md |
模式 A：生成今日 Todo
Step 1: 确定日期
计算今天日期（YYYY-MM-DD）、当月、年内周数（推荐使用本 Skill 的 assets/scripts/date_utils.py）。
Step 2: 读取来源
按顺序读取（缺失则跳过）：
- 当月规划：
{agendaRoot}/monthly/YYYY-MM-plan.md（当前年月，如 2026-02-plan.md，可用 date_utils 推算），提取本月目标与本周重点
- 当周规划：
{agendaRoot}/weekly/Week{W}-plan.md，提取「今天」对应的建议任务
- 昨天未完成：从
{agendaRoot}/daily/{昨天日期}-log.md 或 {昨天日期}-todo.md 中未勾选项
- tasks 目录下以 todo 开头的文件（可选）：如
{agendaRoot}/tasks/TODO.md、todo-readinglist.md、todo-*.md。读取其中未勾选项，酌情纳入今日计划（如 1–2 项低优先级或按清单性质分配），并标记 *(来自 tasks 清单)* 或 *(来自阅读清单)*（若来自 todo-readinglist.md）
Step 3: 合并、去重、排优先级
幂等性检查：若今日 todo 已存在，读取现有条目，归一化比较（忽略勾选状态、来源标记、前后空格），已存在的条目不再追加。
去重规则：从上述来源（月规划、周规划、昨天未完成、tasks 清单）中内容相同或高度相似的事项只保留一条。若某条既在昨天未完成又在规划中，以 *(从昨天转移)* 标记。
来源标记与优先级：按 conventions.md 中的来源标记和优先级标识规则执行。
Step 4: 写入文件
路径：{agendaRoot}/daily/{今天日期}-todo.md
使用 assets/todo-template.md 模板，必须包含：
- 今日时间表：优先从
{agendaRoot}/schedule-config.md 读取时段配置；若不存在则从本 Skill 的 assets/schedule-config.example.md 读取。把当日任务填入各时段「安排」列。优先从周规划中「今天」的时段提取；若无，则按优先级合理分配。每个时段写具体事项。
- 高/中/低优先级：任务列表，与时间表一致，带来源标记，供逐项勾选。
若文件已存在，仅追加不重复的新条目；时间表若已存在则保留不覆盖。
Step 5: 汇报
必须首先说明：已写入/已更新的文件路径。再说明各优先级项数、来源分布。
模式 B：追踪当日完成
B1：查询进度
读取今日 todo，统计已完成（[x]）/ 未完成（[ ]），按优先级汇总，不修改文件。
B2：更新状态
识别目标条目和新状态，在今日 todo 中更新：已完成 → [x]；进行中 → [ ] 加 （进行中）；取消 → [x] 加 （取消）；推迟无目标日 → 加 （推迟）；推迟有目标日 → 转入「添加/移动任务」模式（见 references/mode-add-or-move.md）。确认并说明已更新的文件路径。
Error Handling
| 情况 | 处理 |
|---|
| 月/周/昨天来源不存在 | 跳过，用已有数据生成 |
| 三个主来源都不存在 | 生成空框架 todo，标注"无数据来源，请手动补充" |
| 今日 todo 已存在（模式 A） | 幂等处理：仅追加不重复的新条目 |
| 目标日期歧义（添加/移动任务） | 推算后向用户确认具体日期 |
| 临时追加目标文件不存在（添加/移动任务） | 可创建最小框架再追加，或告知用户 |
与其他 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-add-or-move.md：添加/移动任务详细流程
