产品概述
Backlog.md 是一款 Markdown 原生的任务管理与看板可视化 CLI 工具，同时作为 MCP 服务器为 AI 编码助手提供协议接口。
核心定位
| 特性 | 说明 |
|---|---|
| Markdown-native | 每个任务都是独立的 .md 文件，frontmatter 存储元数据，正文记录描述与验收标准 |
| AI-Ready | 支持 Claude Code、Gemini CLI、Codex、Kiro、Cursor 等 MCP/CLI 兼容的 AI 助手 |
| 100% 离线私有 | 所有数据存放在仓库本地，无需联网，无需账号 |
| 跨平台 | macOS、Linux、Windows 全平台支持 |
主要功能
任务管理
- 任务 CRUD：创建、编辑、查看、归档、删除
- 子任务支持：使用小数编号（如
back-4.1） - 依赖管理：任务间依赖关系与自动序列计算
- 草稿系统：独立草稿 ID 空间，随时提升为正式任务
看板可视化
- 终端 TUI 看板：
backlog board启动交互式终端看板 - Web 浏览器界面：
backlog browser启动 React 现代化界面，支持富文本粘贴与 Word 文档上传 - 看板导出：导出为 Markdown 表格或嵌入 README
搜索
- 基于 Fuse.js 的跨任务/文档/决策模糊搜索
- CLI、TUI、Web 三端统一搜索体验
- 支持按状态、优先级、标签等多维过滤
AI 集成
- MCP 协议：AI 代理直接调用 Backlog.md 工具
- CLI 指令：生成代理指令文件指导 AI 使用命令
- Wiki Skill 安装：
backlog wiki install将内置知识库 skill 部署到 Claude/Codex - 规范驱动工作流（Spec-Driven）：描述想法 → AI 拆分任务 → 逐个实施
Wiki 知识库
- LLM 维护的增量式知识库：AI 代理读取 tasks/docs/decisions 等源文件，自动编译为结构化 wiki；人类可读可编辑
- 浏览器中直接浏览
backlog/wiki/文件树，侧边栏可折叠导航 - 在线编辑：标题、正文、labels 标签均可修改，保存自动更新 frontmatter
- 文件管理：创建文件/文件夹、重命名，空文件夹可见
- 实时同步：多标签页/WebSocket 即时同步文件变更
- AI Skill 支持：
backlog wiki install一键部署到 Claude/Codex
任务评论
- 在任务中追加讨论与审阅记录，支持 Markdown 正文与可选作者
- CLI：
backlog task edit <id> --comment "内容" --comment-author @name - MCP：
task_edit的commentsAppend与commentAuthor字段 - Web UI：任务详情弹窗预览区只读显示评论，编辑模式下可追加新评论
- 评论文本参与搜索，可通过
backlog search找到含相关评论的任务
日期与计划
- 任务日期字段：可选
dueDate（截止日期）、plannedStart（计划开始）、plannedEnd（计划结束） - 里程碑日期：为里程碑设置时间范围与截止点
- 看板日期指示器：TaskCard 直接显示计划日期范围与逾期高亮
- Web UI 自动填充：设置 dueDate 时自动推荐 plannedStart / plannedEnd
文档与决策
- 文档管理：支持子文件夹分组
- 决策记录（ADR）：标准架构决策记录格式，支持状态流转
- 里程碑：任务分配、完成检测、归档
技术栈
- 运行时：Bun + TypeScript 5
- CLI：Commander.js + Clack 交互式向导
- TUI：bblessed 终端界面
- Web UI：React + Tailwind CSS v4
- 搜索：Fuse.js 模糊匹配
- 构建输出：单文件可执行二进制（含嵌入式 Web 资源）
分发渠道
- npm：
@kuwork/backlog.md - Homebrew：
backlog-md（上游 formula） - Nix：
nix run github:MrLesk/Backlog.md（上游 flake） - GitHub Releases：
kuwork/Backlog.md平台二进制文件