jw-agenda-weekly-plan

name	jw-agenda-weekly-plan
description	Weekly plan generator: create day-by-day breakdown from monthly goals and last week's carry-over. Triggers: '生成本周计划', '周规划', 'weekly plan', '运行 weekly-plan'.
metadata	{"author":"Jing Wu","version":"0.2.0","updated":"2026-02-23"}

Weekly Plan（周规划生成器）

基于月规划目标和上周延续任务，生成本周按天拆解的规划。

注意：本 Skill 生成的是规划草稿。用户可在生成后调整每日安排。daily-todo 会读取本文件作为当日计划的来源之一。

级联更新原则：生成或调整周规划时，必须从上往下逐层检查并同步更新，确保各层规划一致：

1. tasks/TODO.md（总待办）→ 已纳入本周规划的任务，在总待办中标记已规划或移除
2. 月规划（monthly/YYYY-MM-plan.md）→ 只读参考，不修改（月规划由用户维护）
3. 周规划（weekly/Week{W}-plan.md）→ 本 Skill 的主要产出
4. 日计划（daily/YYYY-MM-DD-todo.md）→ 若本周已有日计划文件，检查是否需要追加新纳入的任务（幂等，不重复）

每一层只在确实受影响时才修改，但必须逐层检查，不可跳过。

安装前提

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

约定

开始前读取本 Skill 的 assets/conventions.md 获取周数计算规则、文件命名和路径。

Workflow

Step 1: 确定当前周

使用本 Skill 的 assets/scripts/date_utils.py 计算：年内周数（1–52）、本周起止日期（周一至周日）、上周日期范围。

Step 2: 读取月规划

• 路径：{agendaRoot}/monthly/YYYY-MM-plan.md（当前月，如 2026-02-plan.md，可用 date_utils 推算）
• 提取：月规划中 Week {W} 对应小节的重点、核心任务、产出目标
• 若月规划不存在，见 Error Handling

Step 3: 读取上周延续任务

按优先级读取：

1. 上周总结（若有）：{agendaRoot}/weekly/Week{W-1}-review.md 中的「转入下周」部分
2. 上周日志：{agendaRoot}/daily/ 下上周日期范围内的日志，提取「未完成」部分
3. 上周 todo：{agendaRoot}/daily/{上周各日期}-todo.md 中未勾选项
4. tasks 目录下以 todo 开头的文件（可选）：如 {agendaRoot}/tasks/TODO.md、todo-readinglist.md、todo-*.md。其中未勾选项作为「待纳入本周」的候选，在按日分配时酌情纳入（可集中在某几天或按优先级分散）

汇总为延续任务清单。

Step 4: 生成周规划

使用 assets/week-template.md 模板结构。

分配原则（按优先级与依赖执行）：

• 优先级：🔴 高 → 周初（周一至周三）；🟡 中 → 中周（周二至周四）；🟢 低 → 周末或周后期。延续任务中高优/紧急的优先于新任务，安排在周一或周二。
• 依赖：识别依赖链（如 研究→准备→提交），前置任务在前、依赖任务在后，可间隔 1 天。
• 拆分与平衡：大任务拆成 2–3 天的子任务；每日任务在总览表「现在排在哪天」标为「Daily」；每天约 2–4 项，时间敏感项靠近截止日。

操作：从月规划与延续清单提取任务并识别优先级与依赖 → 按上述原则分配到各天 → 填「📋 本周计划内事项总览」表与每日小节（- [ ] ...），来源标记：*(来自规划)* / *(从上周转移)*。

若 Week{W}-plan.md 已存在：增量更新。保留已完成（- [x]）、用户添加与手动调整；仅追加归一化后不重复的新任务；不覆盖用户对日期、优先级、状态的修改。

Step 5: 写入文件

路径：{agendaRoot}/weekly/Week{W}-plan.md

若目录不存在则创建。

Step 6: 从上往下级联同步

6a: tasks/TODO.md（总待办）

• 已从 {agendaRoot}/tasks/TODO.md 或其他 todo-*.md 纳入本周规划的任务 → 在总待办中标记已规划或移除
• 避免同一任务反复被纳入后续周规划

6b: 月规划（只读参考）

• 月规划由用户维护，本 Skill 不修改，仅在 Step 2 中读取

6c: 已有日计划（daily/YYYY-MM-DD-todo.md）

• 检查本周已存在的日计划文件
• 若周规划中为某天新增了任务，而该天的日计划已存在 → 幂等追加（跳过已有条目），标记 *(来自规划)*
• 若日计划尚不存在则不创建（留给 daily-todo 处理）

Step 7: 汇报

说明：文件路径、本周重点、延续任务数量、已同步的所有文件路径。提示可用 daily-todo 生成每日计划。

Error Handling

情况	处理
月规划不存在	向用户说明，询问是否仅基于上周延续任务生成框架
月规划中无当前周小节	使用月规划的整体目标作为参考
上周日志/总结不存在	跳过延续任务，仅基于月规划生成
周规划已存在	增量更新，保留用户已有内容
跨月边界（如 1.29–2.4）	归属 Week 结束日所在月份，参见 conventions.md

与其他 Skill 的配合（可选）

• 月规划：由用户维护，本 Skill 只读不写。
• 若安装了 daily-todo：它会读取本 Skill 产出的周规划生成每日 todo。未安装时不影响本 Skill。
• 若安装了 weekly-review：其产出的「转入下周」可作为本 Skill 的延续任务来源。未安装时跳过该数据来源。

Resources

• assets/week-template.md：周规划输出模板
• assets/conventions.md：约定
• assets/scripts/date_utils.py：日期计算脚本