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 编号