Memos 简介

Memos(快速笔记)是 Backlog.md 的第五种文件实体,用于承载一次性随手记:会议上一句结论、调试中一段关键日志、一闪而过的想法。此前任何值得记住的东西都必须变成任务或文档——单行会议记录也要套用 ID 方案、标题和段落结构。Memos 让"先记下来、以后再说"成为可能。

与其他实体的区别

任务 / 草稿 文档 / 决策 Memo
定位 可执行、可追踪的工作项 正式知识资产 轻量捕获收件箱
ID back-123 / draft-3 doc-5 / decision-3 20261003-1(日期 + 当日序号)
标题 必填 必填 无标题,由正文首行派生
结构要求 状态、验收标准等元数据 类型、目录组织 仅正文 + 可选标签

Memo 刻意保持轻量:没有状态流转、没有里程碑、没有验收标准,也不进入依赖图谱(图谱视图)。它的价值在于出站连接——正文中裸写的实体 ID 和 path 会自动变成链接,让随手记成为知识网的可生长节点(见 搜索与知识互联)。

存储格式

所有 memo 保存在 backlog/memos/ 目录下,每份笔记一个 Markdown 文件:

---
id: 20261003-1
created_date: 2026-10-03 01:14
updated_date: 2026-10-03 01:14
tags: [meeting]
---

周会结论:v2 发布推迟一周,先把性能回归修完,相关任务 back-123。
  • ID 规则:YYYYMMDD-N 格式,N 取当日已有 memo 的最大序号 + 1,跨天自动重置为 1
  • frontmatter:仅 id、created_date、updated_date 与可选的 tags(空标签列表时省略),没有 title 字段
  • 卡片标题:由正文第一个非空行派生;正文以空行开头时回退到前 40 个字符
  • 临时数据:backlog/memos/ 被视作临时捕获区,刻意默认不入版本库(如需保留请在 .gitignore 中自行调整)

四个使用入口

同一份存储被四个表面共享,ID 方案与文件格式完全一致:

  • CLI:backlog memo create/list/view/update/delete,最快的终端捕获路径,见 CLI 备忘命令
  • Web:/memos 页面的信息流快速捕获 + 日历模式,见 Web 备忘页面
  • MCP:memo_create / memo_list / memo_view / memo_update / memo_delete 工具组,AI 代理可直接读写
  • HTTP API:/api/memos* 路由(列表、日历计数、按 ID 读写),供脚本与第三方工具调用

此外 memo 已接入全局搜索,CLI 侧提供 backlog instructions memos 使用指南,MCP 侧提供 backlog://workflow/memos 工作流资源。

使用建议

  • 捕获要轻:一条 memo 只说一件事,写完即忘,靠搜索和链接找回
  • 善用标签:--tags 或 Web 端行内 #标签 为收件箱建立粗粒度分区
  • 写实体 ID:正文里随手带上 back-123、doc-5 等 ID,渲染时自动成链
  • 定期消化:memo 是收件箱而非归宿,重要结论应提升为任务或文档;本期不提供自动提升通道,衔接方式是在任务正文中引用 memo 编号

results matching ""

    No results matching ""