obsidian-capture

obsidian-capture

一次捕获 = 调用一次 scripts/capture.py。脚本会处理所有确定性操作——解析今天的日记 / 本周的周记（如果不存在，则根据知识库模板创建），路由到正确的章节，在追加内容前填入空的占位槽，并格式化 Tasks 插件日期——因此不要手动编辑笔记。需要 $OBSIDIAN_VAULT 和 python3（仅使用标准库）。

命令

scripts/capture.py todo "回 offer 邮件"                    # daily ✅ 其他, due today
scripts/capture.py todo "准备 design review" --must        # daily 🎯 今天必须完成, due today
scripts/capture.py todo "写 freshrss theme" --weekly       # weekly ## Todos, due = today+3d, capped at Sunday
scripts/capture.py todo "读论文" --due friday -p high      # any todo: explicit due + ⏫ priority
scripts/capture.py log "和 recruiter 通话"                 # daily 🪵 Log, timestamped now (--time HH:MM to backfill)
scripts/capture.py learned "TIL 内容"                      # daily 📝 今日记 → 新知:
scripts/capture.py diary "发生的事"                        # daily 📝 今日记 → 新事:
scripts/capture.py fun "有趣的事"                          # weekly ## Something Fun This Week
scripts/capture.py reflect "杠杆" "答案全文"               # weekly Reflections, under the Q: matching the substring
scripts/capture.py done "package 邮件"                     # tick first matching open #agent-todo (today's notes first, then all), appends ✅ date
scripts/capture.py annotate "加 CI" "blocked: 缺权限"      # append a sub-bullet under first matching open #agent-todo

# agent-owned todos (#agent-todo): captured for a later, possibly weaker, agent to execute cold
scripts/capture.py todo "给 skills repo 加 CI" --agent \
  --ctx "context: repo ~/Local/wilbeibi-skills，GitHub Actions 跑 skill lint" \
  --ctx "done-when: push 后 Actions 全绿"
scripts/capture.py agenda                                  # list open #agent-todo due ≤ today + context, file:line (--days 90 default)

--due 接受 today、tomorrow、+Nd、mon..sunday、this-week、next-week、YYYY-MM-DD、none——直接传入用户的说法，不要自行计算日期。运行 --help 查看其余选项。

判断（模型唯一需要决定的部分）

• 普通待办属于用户；带 --agent 的待办属于你。 agenda/done/annotate 只会匹配 #agent-todo 行，因此不会触碰用户的待办——但在核对其自身的 done-when: 之前，绝不要将其标记为已完成。
• 保持捕获文本与用户使用的语言一致；不要翻译或改写。
• “必须 / must / today's deadline / blocking” → --must；否则使用普通待办。
• 日记还是周记：默认使用日记。只有用户提到 weekly / 本周，或任务属于整周范围且没有固定日期时，才使用 --weekly。即使待办的截止日期很远，也仍然记在今天的日记中——Tasks 插件会根据其 📅 日期查找，而不是根据文件位置。
• “让 agent 做 / 给 agent 记” → --agent。执行者可能是没有对话历史的弱模型，因此待办必须能够冷启动执行：使用 --ctx "context: ..." 提供绝对路径 / 仓库 / URL，并使用 --ctx "done-when: ..." 提供验收标准。从当前对话中提取具体信息；如果无法让待办独立执行，就询问用户，而不是捕获一个含糊的待办。（没有 --ctx 时，脚本会拒绝 --agent。）
• 脚本会输出所写入的文件、章节和确切行内容——将其作为确认反馈给用户，然后结束。如果报错（章节 / 问题 / 待办不匹配），请修正参数；不要改为手动编辑。