用途:在 journal/weekly/YYYY-[W]WW.md 生成一份周回顾笔记,方式为读取本周每日笔记,聚合 wins、未完成任务、进展条目与项目状态,再起草结构化回顾。适合周五或按需运行。
设置:读取 .claude/bulletjournal.local.md 的 YAML frontmatter,解析 daily_path(默认 daily)、journal_path(默认 journal)、projects_path(默认 10-Projects)、qmd_bin(默认 qmd)。可用 /bulletjournal:init 创建该文件。目录约定:每日笔记 {DAILY_PATH}/YYYY-MM-DD.md,周笔记 {JOURNAL_PATH}/weekly/YYYY-[W]WW.md,项目笔记位于 {PROJECTS_PATH},带 #action 标签及 status、next-action 字段。
主要能力:刷新 qmd 索引(${QMD_BIN} update && ${QMD_BIN} embed || true);确定当前 ISO 周与周一至周日范围;检查周笔记是否已存在(存在则警告不覆盖,提示追加 -v2 或中止);用 Glob 匹配每日笔记并筛选本周日期;聚合 - [x]、✅、- [ ]、#progress、[[...]] 链接与 ## Log 条目,未完成任务按项目分组;用 qmd get 获取项目状态与 next-action;判定停滞项(本周 3 篇以上每日笔记中未完成且无 #progress);生成含 Wins、Still open、Migration decisions、Next week focus、Stalled / blocked、Week summary 的周笔记并写入。
使用方式:按步骤调用工具,参数签名为 mcp__qmd__get → { path },mcp__qmd__query → { query, limit? },mcp__qmd__search → { query, limit? };调用前用 ToolSearch 加载 schema。Migration decisions 仅提出处置建议由用户编辑,不自动决定。
限制:无每日笔记则不生成;项目笔记缺失时标记状态未知;周中运行按已有日期生成并注明进行中;周笔记已存在绝不覆盖。